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 zarejestrować 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ń wielkość liter ma znaczenie, więc rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 różnych zdarzeń.

Zanim zaczniesz

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

Jeśli chcesz zbierać dane o atrybucji kampanii w przypadku aplikacji na platformy Apple, dodaj do projektu platformę AdSupport.

Zdarzenia z dzienników

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

Zdefiniowane zdarzenia

Aby ułatwić Ci rozpoczęcie, pakiet SDK Analytics definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, podróży i gier mobilnych. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule [GA4] Zalecane zdarzenia.

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

Poniższy 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ą 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ż wymagane. Do dowolnego zdarzenia możesz dodać te parametry:

  • Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku nieliczbowych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawić w postaci liczbowej. 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.

    Parametrów niestandardowych można używać 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 Google Analytics 4 BigQuery Export.

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

  • Nazwy parametrów mogą mieć maksymalnie 40 znaków, muszą zaczynać się od litery i mogą zawierać tylko znaki alfanumeryczne oraz podkreślenia. Obsługiwane są typy ciągów znaków i liczb. Wartości parametrów typu ciąg 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 określone 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

Parametry możesz rejestrować w różnych zdarzeniach za pomocą metody setDefaultEventParameters(). 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 metodzie logEvent() lub log, używana jest ta wartość zamiast domyślnej.

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