Z tego przewodnika dowiesz się, jak rejestrować zdarzenia w aplikacji.
Zdarzenia dostarczają informacji o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeniach systemowych lub błędach.
Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie. Nie musisz dodawać żadnego kodu, aby je odbierać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej maksymalnie 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, a zarejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje powstawanie 2 różnych zdarzeń.
Zanim zaczniesz
Upewnij się, że masz skonfigurowany projekt i masz dostęp do Analytics w sposób opisany w artykule Pierwsze kroki z Analytics.
Zdarzenia w dzienniku
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 kilka zalecanych zdarzeń, które są typowe w różnych rodzajach aplikacji, m.in. w aplikacjach zajmujących się handlem detalicznym i e-commerce, a także w aplikacjach podróżniczych i grach. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Zalecane zdarzenia.
Szczegóły implementacji zalecanych typów zdarzeń znajdziesz w tych miejscach:
- Zalecane zdarzenia: zobacz dokumentację klasy
com.google.firebase.analytics.FirebaseAnalytics.Event
. - Zalecane parametry: zobacz informacje o
com.google.firebase.analytics.FirebaseAnalytics.Param
.
Ten przykład pokazuje, jak zarejestrować zdarzenie 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 każdego zdarzenia możesz dodać te parametry:
Parametry niestandardowe: mogą być używane jako wymiary lub dane w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych nieliczbowych parametrów zdarzenia i danych niestandardowych w przypadku dowolnych danych parametrów, które lepiej są przedstawiane w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby mieć pewność, że parametry niestandardowe pojawią się w raportach Analytics. Możesz to zrobić, korzystając z sekcji Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz wymiary niestandardowe.
Parametry niestandardowe można stosować w definicjach odbiorców, które mają być stosowane do wszystkich raportów. Jeśli aplikacja jest połączona z projektem BigQuery, parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery. Przykładowe zapytania i wiele innych informacji znajdziesz w narzędziu Google Analytics 4 BigQuery Export.
Parametr
VALUE
:VALUE
to parametr ogólnego przeznaczenia, który przydaje się do gromadzenia kluczowych danych związanych ze zdarzeniem. Mogą to być na przykład przychody, dystans, czas i punkty.
Jeśli Twoja aplikacja ma konkretne potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak 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);
Ustawianie domyślnych parametrów zdarzenia
Parametry w różnych zdarzeniach możesz rejestrować za pomocą narzędzia setDefaultEventParameters
.
Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.
Podobnie jak w przypadku parametrów niestandardowych rejestruj domyślne parametry zdarzeń, aby mieć pewność, że będą się pojawiać 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 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ć logowanie szczegółowe, aby monitorować logowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są prawidłowo logowane. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.
Logowanie szczegółowe możesz włączyć 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
Wyświetla zdarzenia w dzienniku Androida Studio, co pomaga od razu sprawdzić, czy zdarzenia są wysyłane.
Wyświetlanie zdarzeń w panelu
Zbiorcze statystyki zdarzeń możesz wyświetlać w panelach konsoli Firebase. Panele są aktualizowane okresowo w ciągu dnia. Aby przeprowadzić natychmiastowe testy, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.
Te dane są dostępne w panelu Zdarzenia w konsoli Firebase. Ten panel pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego rodzaju zdarzenia rejestrowanego przez Twoją aplikację.