Pierwsze kroki z Google Analytics na Androida

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Z tego samouczka dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.

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, które definiujesz, aby opisywać 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

Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi, i upewnij się, że Google Analytics jest włączona w projekcie w Firebase:

  • Jeśli tworzysz nowy projekt w Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.

  • Jeśli używasz dotychczasowego projektu w Firebase bez włączonej usługi Google Analytics możesz ją włączyć na karcie Ustawienia > Integracje.

Gdy włączysz Google Analytics w projekcie, aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.

Dodawanie pakietu SDK Analytics do aplikacji

  1. W pliku Gradle na poziomie modułu (aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależność od biblioteki 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:34.13.0"))

    // 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 korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

    (Alternatywnie)  Dodaj zależności biblioteki Firebase bez używania BoM

    Jeśli nie chcesz używać Firebase BoM, musisz określić wersję każdej biblioteki Firebase w wierszu zależności.

    Pamiętaj, że jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co zapewnia zgodność wszystkich wersji. 

    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:23.2.0")
}

  2. Zadeklaruj obiekt com.google.firebase.analytics.FirebaseAnalytics u góry aktywności:

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. Zainicjuj go w metodzie onCreate():

    Kotlin 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

Rozpoczęcie rejestrowania zdarzeń

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 typów firm 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, zalecane zdarzenia należy wysyłać z określonymi parametrami. W tej sekcji pokazujemy, jak rejestrować wstępnie zdefiniowane zdarzenie. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.

Poniższy kod rejestruje zdarzenie SELECT_CONTENT, gdy użytkownik kliknie określony element w aplikacji.

Kotlin 

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ć rejestrowanie zdarzeń przez pakiet SDK i sprawdzić, czy zdarzenia są rejestrowane prawidłowo. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć logowanie szczegółowe 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 Android Studio, co pozwala od razu sprawdzić, czy zdarzenia są wysyłane.

Dalsze kroki