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 zarejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 osobnych 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.

Wstępnie 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.

    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 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

Możesz rejestrować parametry w różnych zdarzeniach za pomocą metody setDefaultEventParameters(). 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 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ąć parametr domyślny, wywołaj metodę setDefaultEventParameters() z parametrem ustawionym na null.