Google Analytics zbiera dane dotyczące użytkowania i zachowania Twojej aplikacji. SDK rejestruje dwa podstawowe typy informacji:
- Zdarzenia: co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: atrybuty, które definiujesz, aby opisać segmenty bazy użytkowników, takie jak preferencje językowe 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 jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida i upewnij się, że Google Analytics jest włączone w Twoim projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas procesu tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, w którym nie włączono Google Analytics, przejdź do karty Integracje w > Ustawienia projektu, aby ją włączyć.
Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
Dodaj pakiet Analytics SDK do swojej aplikacji
Korzystając z Firebase Android BoM , zadeklaruj zależność dla biblioteki Analytics Android w pliku Gradle modułu (na poziomie aplikacji) (zwykle
app/build.gradle
).Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.0.1') // Declare 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' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
(Alternatywnie) Zadeklaruj zależności biblioteki Firebase bez użycia BoM
Jeśli zdecydujesz się nie korzystać z BoM Firebase, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Pamiętaj, że jeśli korzystasz z wielu bibliotek Firebase w swojej aplikacji, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji.
dependencies { // Declare 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:21.0.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.0.1') // Declare 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-ktx' }
Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase Android.
(Alternatywnie) Zadeklaruj zależności biblioteki Firebase bez użycia BoM
Jeśli zdecydujesz się nie korzystać z BoM Firebase, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.
Pamiętaj, że jeśli korzystasz z wielu bibliotek Firebase w swojej aplikacji, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji.
dependencies { // Declare 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-ktx:21.0.0' }
Zadeklaruj obiekt
com.google.firebase.analytics.FirebaseAnalytics
u góry swojej aktywności:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Zainicjuj go w
onCreate()
:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Rozpocznij rejestrowanie zdarzeń
Po utworzeniu instancji FirebaseAnalytics
można rozpocząć rejestrowanie zdarzeń za pomocą metody logEvent()
.
Niektóre zdarzenia są zalecane dla wszystkich aplikacji ; inne są zalecane dla określonych rodzajów działalności lub branż. Należy wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanego zdarzenia. Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Rejestrowanie zdarzeń .
Poniższy kod rejestruje zdarzenie SELECT_CONTENT
, gdy użytkownik kliknie określony element w Twojej aplikacji.
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);
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") }
Możesz włączyć pełne rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK, aby sprawdzić, czy zdarzenia są rejestrowane prawidłowo. Obejmuje to zarówno zdarzenia rejestrowane automatycznie, jak i ręcznie.
Pełne rejestrowanie można 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
To polecenie wyświetla zdarzenia w dzienniku Android Studio, pomagając natychmiast sprawdzić, czy zdarzenia są wysyłane.
Następne kroki
- Użyj DebugView , aby zweryfikować swoje zdarzenia.
- Przeglądaj swoje dane w konsoli Firebase.
- Zapoznaj się z przewodnikami po wydarzeniach i właściwościach użytkowników.
- Dowiedz się, jak wyeksportować swoje dane do BigQuery.