Z tego samouczka dowiesz się, jak dodać do aplikacji Google Analytics i rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o użytkowaniu i zachowaniu w Twojej aplikacji. Pakiet SDK rejestruje 2 główne typy informacji:
- Zdarzenia:co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: atrybuty definiowane przez Ciebie, aby opisać segmenty użytkowników, np. ustawienia języka lub położenie geograficzne.
Analytics automatycznie rejestruje niektóre zdarzenia i właściwości użytkownika – nie musisz dodawać żadnego kodu, aby je włączyć.
Zanim zaczniesz
Jeśli nie masz jeszcze Firebase, dodaj je do projektu na Androida i upewnij się, że w projekcie Firebase jest włączona opcja Google Analytics:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.
Jeśli używasz dotychczasowego projektu Firebase, w którym nie włączono funkcji Google Analytics, przejdź do karty Integracje
, aby ją włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w projekcie, aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
Dodaj do aplikacji pakiet SDK Analytics
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
) dodaj zależność z biblioteką Analytics na Androida. Zalecamy używanie Firebase Android BoM do kontrolowania wersji biblioteki.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
Gdy używasz interfejsu Firebase Android BoM, Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Alternatywnie) Dodaj zależności bibliotek Firebase bez korzystania z BoM
Jeśli zdecydujesz się nie używać Firebase BoM, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek. Dzięki temu wszystkie wersje będą ze sobą zgodne.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:22.1.2") }
Zadeklaruj obiekt
com.google.firebase.analytics.FirebaseAnalytics
u góry aktywności:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Zainicjuj go w metodzie
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Rozpocznij rejestrowanie zdarzeń
Po utworzeniu instancji FirebaseAnalytics
możesz zacząć rejestrować zdarzenia za pomocą metody logEvent()
.
Niektóre zdarzenia są zalecane we wszystkich aplikacjach, a inne w przypadku określonych rodzajów działalności lub branż. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje oraz aby móc korzystać z przyszłych funkcji i integracji, gdy tylko zostaną udostępnione, sugerowane zdarzenia należy wysyłać z określonymi parametrami. Ta sekcja pokazuje, jak rejestrować zdefiniowane wstępnie zdarzenia. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w sekcji Zdarzenia z dziennika.
Gdy użytkownik kliknie określony element w aplikacji, kod ten zarejestruje 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);
Aby sprawdzać, czy zdarzenia są prawidłowo rejestrowane przez pakiet SDK, możesz włączyć szczegółowe rejestrowanie. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.
Możesz włączyć szczegółowe logowanie 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 ułatwia natychmiastowe sprawdzenie, czy są one wysyłane.
Dalsze kroki
- Poznaj każdy raport Analytics.
- Do weryfikowania zdarzeń służy DebugView.
- Poznaj swoje dane w konsoli Firebase.
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkowników.
- Dowiedz się, jak eksportować dane do BigQuery.