W tym przewodniku dowiesz się, jak rejestrować zdarzenia w aplikacji.
Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, na przykład działania użytkownika, zdarzenia systemowe lub błędy.
Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej do 500 różnych typów zdarzeń Analytics. Nie ma ograniczeń co do całkowitej liczby zdarzeń rejestrowanych przez aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter i że rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, skutkuje dwoma różnymi zdarzeniami.
Zanim zaczniesz
Upewnij się, że masz skonfigurowany projekt i masz dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics .
Rejestruj zdarzenia
Po utworzeniu instancji FirebaseAnalytics
możesz jej używać do rejestrowania zdarzeń za pomocą metody logEvent()
.
Aby ułatwić Ci rozpoczęcie pracy, 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, aplikacji podróżniczych i gier. Aby dowiedzieć się więcej o tych zdarzeniach i kiedy z nich korzystać, zobacz Polecane zdarzenia .
Szczegóły implementacji zalecanych typów zdarzeń znajdziesz w następujących lokalizacjach:
- Zalecane zdarzenia: zobacz informacje o klasie
com.google.firebase.analytics.FirebaseAnalytics.Event
. - Zalecane parametry: zobacz dokumentację
com.google.firebase.analytics.FirebaseAnalytics.Param
.
Poniższy przykład ilustruje sposób rejestrowania zdarzenia SELECT_CONTENT
:
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
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);
Oprócz określonych parametrów do dowolnego zdarzenia możesz dodać następujące parametry:
Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics . Możesz używać niestandardowych wymiarów dla nieliczbowych danych parametrów zdarzeń i niestandardowych metryk dla dowolnych danych parametrów lepiej reprezentowanych liczbowo. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby mieć pewność, że te parametry niestandardowe pojawią się w raportach Analytics. Zrób to, korzystając z opcji Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary
Parametry niestandardowe można wykorzystać w definicjach odbiorców , które można zastosować do każdego raportu. Parametry niestandardowe są także uwzględniane w danych eksportowanych do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Znajdź przykładowe zapytania i wiele więcej w Google Analytics 4 BigQuery Export .
Parametr
VALUE
:VALUE
to parametr ogólnego przeznaczenia, przydatny do gromadzenia kluczowych wskaźników odnoszących się do zdarzenia. Przykładami mogą być przychody, dystans, czas i punkty.
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:
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
Ustaw domyślne parametry zdarzenia
Możesz rejestrować parametry między zdarzeniami za pomocą setDefaultEventParameters
. Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.
Podobnie jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzeń, aby mieć pewność, że pojawią się w raportach Analytics.
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
Jeśli w metodzie logEvent()
określono parametr, używana jest ta wartość zamiast wartości domyślnej.
Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters
z parametrem ustawionym na null
.
Wyświetl zdarzenia w dzienniku debugowania Android Studio
Można włączyć pełne rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK i sprawdzać, czy zdarzenia są rejestrowane prawidłowo. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.
Możesz włączyć szczegółowe rejestrowanie za pomocą szeregu 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 Twoje zdarzenia w logcat Android Studio, pomagając Ci natychmiast sprawdzić, czy zdarzenia są wysyłane.
Przeglądaj wydarzenia w panelu kontrolnym
Możesz przeglądać zbiorcze statystyki dotyczące swoich zdarzeń w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne są aktualizowane okresowo w ciągu dnia. W celu natychmiastowego przetestowania użyj wyjścia logcat zgodnie z opisem w poprzedniej sekcji.
Dostęp do tych danych możesz uzyskać z panelu Wydarzenia w konsoli Firebase. Ten pulpit nawigacyjny przedstawia raporty zdarzeń, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.