Zdarzenia w dzienniku

Zdarzenia pozwalają uzyskać wgląd w to, co dzieje się w aplikacji. Dostarczają informacji m.in. o działaniach użytkowników, zdarzeniach systemowych i błędach.

Analytics automatycznie rejestruje niektóre zdarzenia, 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ń wielkość liter ma znaczenie. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 osobnych zdarzeń.

Zanim zaczniesz

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

Zdarzenia z dzienników

Po utworzeniu instancji FirebaseAnalytics możesz jej używać do rejestrowania zdarzeń za pomocą metody logEvent().

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 handlowych i e-commerce, podróżniczych oraz gier mobilnych. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule [GA4] Zalecane zdarzenia.

Szczegółowe informacje o wdrażaniu zalecanych typów zdarzeń znajdziesz w tych miejscach:

• Zalecane zdarzenia: zapoznaj się z dokumentacją klasy com.google.firebase.analytics.FirebaseAnalytics.Event.
• Zalecane parametry: zapoznaj się z dokumentacją com.google.firebase.analytics.FirebaseAnalytics.Param.

Poniższy przykład pokazuje, jak zarejestrować zdarzenie SELECT_CONTENT:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Oprócz zalecanych parametrów możesz dodać do dowolnego zdarzenia 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ć, w konsoli Firebase kliknij Analytics > Definicje 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: VALUE to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Przykłady: przychody, odległość, czas i punkty.

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:

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

Ustawianie domyślnych parametrów zdarzenia

Parametry możesz rejestrować 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.

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

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

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

Wyświetlanie zdarzeń w dzienniku debugowania Android Studio

Możesz włączyć szczegółowe rejestrowanie, aby monitorować rejestrowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są prawidłowo rejestrowane. Obejmuje to zdarzenia rejestrowane automatycznie i ręcznie.

Możesz włączyć logowanie szczegółowe za pomocą serii poleceń adb:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

To polecenie wyświetla zdarzenia w logcat w Android Studio, co pozwala natychmiast sprawdzić, czy zdarzenia są wysyłane.

Wyświetlanie zdarzeń w panelu

W konsoli Firebase możesz wyświetlać zbiorcze statystyki dotyczące zdarzeń w panelu Analytics > Zdarzenia.

Pamiętaj o tych kwestiach dotyczących tego panelu:

• Panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego typu zdarzenia zarejestrowanego przez aplikację.

• Panel jest aktualizowany okresowo w ciągu dnia. Aby natychmiast przeprowadzić test, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji tego przewodnika.