Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o korzystaniu i zachowaniu Twojej aplikacji. Pakiet SDK rejestruje dwa główne typy informacji:
- Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeń lub błędów.
- Właściwości użytkownika: atrybuty, które określasz, by opisać segmenty swojej witryny bazy użytkowników, np. ich ustawień języka lub położenia geograficznego.
Analytics automatycznie rejestruje niektóre zdarzenia oraz właściwości użytkownika, nie musisz dodawać żadnego kodu, aby je włączyć.
Zanim zaczniesz
Dodaj Firebase do swojego urządzenia z Androidem, chyba że masz to już za sobą projektu i sprawdź, czy Google Analytics włączone w projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie zawiera włączona jest usługa Google Analytics, przejdź do Integracje karta na Twoim urządzeniu
. > Aby ją włączyć, Ustawienia projektu
Gdy włączysz Google Analytics w swoim projekcie, aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
Dodawanie pakietu SDK Analytics do aplikacji
w pliku Gradle (na poziomie aplikacji) modułu, (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
), dodaj zależność z biblioteką Analytics dla Androida. Zalecamy użycie metody Funkcja BoM Firebase na Androida aby kontrolować obsługę wersji biblioteki.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") }
Korzystając z BM Firebase Android BoM, Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.
(Wersja alternatywna) Dodawanie zależności biblioteki 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 używasz wielu bibliotek Firebase w swojej aplikacji, zalecamy korzystanie z BoM do zarządzania wersjami biblioteki, dzięki czemu wszystkie wersje
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
w najważniejsza część Twojej 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ąć logować
za pomocą metody logEvent()
.
Niektóre wydarzenia zalecana w przypadku wszystkich aplikacji; inne są zalecane w przypadku określonych typów działalności lub branż. Należy wysłać zdarzeń z zalecanymi parametrami, aby zapewnić maksymalną dostępne szczegóły w raportach oraz możliwość korzystania z przyszłych funkcji i integracje, gdy tylko będą dostępne. W tej sekcji omawiamy logowanie wstępnie zdefiniowanego zdarzenia. Więcej informacji o logowaniu zdarzeń znajdziesz w materiałach na temat Rejestruj zdarzenia.
Ten kod rejestruje zdarzenie SELECT_CONTENT
, gdy:
użytkownik klika 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. sprawdzać, czy zdarzenia są prawidłowo rejestrowane. Uwzględniane są zarówno automatycznie, zdarzeń rejestrowanych 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
To polecenie wyświetla zdarzenia w dzienniku Androida Studio, 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 wydarzeniach i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.