Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji i rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o działaniu i użytkowaniu aplikacji. Pakiet SDK rejestruje 2 główne rodzaje informacji:
- Zdarzenia: informacje o tym, 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. Aby je włączyć, nie musisz dodawać żadnego kodu.
Zanim zaczniesz
Dodaj Firebase do swojego projektu na Androida (jeśli jeszcze nie masz tego za sobą), upewnij się, że usługa Google Analytics jest włączona w Twoim projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.
Jeśli korzystasz z istniejącego projektu Firebase, w którym nie masz włączonej usługi Google Analytics, otwórz kartę Integracje w sekcji
, aby ją włączyć. > Ustawienia projektu
Po włączeniu Google Analytics w projekcie Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
Dodawanie pakietu SDK Analytics do aplikacji
W pliku Gradle (na poziomie aplikacji) 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. Do kontrolowania obsługi wersji biblioteki zalecamy używanie funkcji Firebase Android BoM.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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") }
Dzięki użyciu BoM Firebase Android BoM Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Alternatywnie) Dodawanie zależności bibliotek Firebase bez korzystania z BM
Jeśli nie chcesz używać Firebase BoM, musisz określić każdą wersję biblioteki Firebase w wierszu zależności.
Pamiętaj, że jeśli w swojej aplikacji używasz wielu bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek. Dzięki temu będziesz mieć pewność, że wszystkie wersje są 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.0.2") }
Zadeklaruj obiekt
com.google.firebase.analytics.FirebaseAnalytics
na górze 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);
Zacznij rejestrować zdarzenia
Po utworzeniu instancji FirebaseAnalytics
możesz zacząć rejestrować zdarzenia za pomocą metody logEvent()
.
Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji, a inne w przypadku określonych rodzajów działalności lub branż. Sugerowane zdarzenia należy przesyłać wraz z określonymi parametrami, aby zapewnić maksymalną ilość szczegółów dostępnych w raportach oraz korzystać z przyszłych funkcji i integracji, gdy tylko będą dostępne. Ta sekcja pokazuje, jak logować wstępnie zdefiniowane zdarzenie. Więcej informacji o logowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.
Ten kod rejestruje zdarzenie SELECT_CONTENT
, gdy użytkownik kliknie określony element w aplikacji.
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);
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.
Dalsze kroki
- Zapoznaj się z każdym raportem Analytics.
- Do weryfikowania zdarzeń służy DebugView.
- Przeglądaj dane w konsoli Firebase.
- Przejrzyj przewodniki po zdarzeniach i właściwościach użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.