Zdarzenia z dzienników

Wybierz platformę: iOS+ Android Web Flutter Unity C++

Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować do 500 różnych rodzajów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i możesz uzyskać dostęp do Analytics zgodnie z opisem w artykule Rozpoczynanie korzystania z Analytics.

Jeśli chcesz zbierać dane o atrybucji kampanii dotyczące aplikacji na platformę Apple, dodaj do projektu bibliotekę AdSupport.

Zdarzenia z dziennika

Po utworzeniu instancji FirebaseAnalytics możesz jej używać do rejestrowania zdarzeń za pomocą metod log biblioteki.

Wstępnie zdefiniowane zdarzenia

Aby ułatwić Ci rozpoczęcie pracy, pakiet SDK Analytics definiuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajów aplikacji, w tym aplikacji handlowych i e-commerce, podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Polecane zdarzenia.

Metody rejestrowania zalecanych typów zdarzeń znajdziesz w przewodniku po interfejsie API.

Poniższy przykład pokazuje, jak rejestrować zdarzenie select_content:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Możesz też zarejestrować to samo zdarzenie za pomocą funkcji logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Może to być przydatne, jeśli chcesz określić dodatkowe parametry inne niż parametry wymagane. Do dowolnego zdarzenia możesz dodać te parametry:

  • Parametry niestandardowe: mogą być używane jako wymiary lub dane w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku nienumerycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawiają wartości liczbowe. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby te parametry niestandardowe pojawiały się w raportach Analytics. Możesz to zrobić, klikając Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

    Parametry niestandardowe można stosować w definicjach odbiorców, które można stosować w każdym raporcie. Parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje znajdziesz w artykule BigQuery Export w Google Analytics 4.

  • Parametr value: parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Przykłady to przychody, odległość, czas i punkty.

  • Nazwy parametrów mogą mieć maksymalnie 40 znaków. Muszą zaczynać się od litery i zawierać tylko znaki alfanumeryczne oraz podkreślenia. Obsługiwane są typy ciąg znaków i liczbowy. Wartości parametrów ciągu znaków mogą mieć maksymalnie 100 znaków. Prefiksy „firebase”, „google” i „ga_” są zarezerwowane i nie należy ich używać w nazwach parametrów.

Zdarzenia niestandardowe

Jeśli Twoja aplikacja ma specyficzne potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano w tym przykładzie:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Ustawianie domyślnych parametrów zdarzenia

Za pomocą znaku setDefaultEventParameters() możesz rejestrować parametry w różnych zdarzeniach. Domyślne parametry są powiązane ze wszystkimi przyszłymi zdarzeniami, które zostaną zarejestrowane.

Podobnie jak w przypadku parametrów niestandardowych zarejestruj domyślne parametry zdarzenia, aby wyświetlały się w raportach Analytics.

Prawidłowe wartości parametru to ciąg tekstowy i liczba. Ustawienie wartości klucza na null czyści ten parametr. Przekazanie wartości null powoduje wyczyszczenie wszystkich parametrów.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Jeśli parametr jest określony w metodzie logEvent() lub log, używana jest ta wartość zamiast wartości domyślnej.

Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters(), ustawiając parametr na null.