Zdarzenia z dzienników

Wybierz platformę:

iOS+ Android Web Flutter Unity C++

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

Zanim zaczniesz

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

Jeśli chcesz zbierać dane o atrybucji kampanii w przypadku aplikacji na platformę Apple, upewnij się, że dodasz do projektu framework AdSupport.

Zdarzenia w dzienniku

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 kilka zalecanych zdarzeń, które są wspólne dla różnych typó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 Zalecane zdarzenia.

Metody rejestrowania zalecanych typów zdarzeń znajdziesz w dokumentacji API.

Ten przykład pokazuje, jak zarejestrować zdarzenie select_content:

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

Możesz też zarejestrować to samo zdarzenie za pomocą metody 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ż określone (wymagane). Do dowolnego zdarzenia możesz dodać te parametry:

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

  Parametry niestandardowe mogą być używane w definicjach odbiorców , które można stosować do każdego raportu. 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 związanych ze zdarzeniem. Przykłady: przychody, odległość, czas i punkty.

• Nazwy parametrów mogą mieć maksymalnie 40 znaków oraz muszą zaczynać się literą i zawierać tylko znaki alfanumeryczne i znaki podkreślenia. Obsługiwane są typy string i num. Wartości parametrów typu string 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 szczególne potrzeby, których nie spełnia żaden z zalecanych typów zdarzeń, 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 zdarzeń

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

Podobnie jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzeń, aby pojawiały się w raportach Analytics.

Prawidłowe wartości parametrów to String i num. Ustawienie wartości klucza na null powoduje wyczyszczenie tego parametru. 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 logEvent() lub log- metodzie, zamiast wartości domyślnej używana jest ta wartość.

Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters() z parametrem ustawionym na null.