Rozpoczęcie korzystania z Google Analytics

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 > Ustawienia projektu, aby ją włączyć.

Po włączeniu Google Analytics w projekcie Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.

Dodawanie pakietu SDK Analytics do aplikacji

  1. 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.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")
}

    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.1")
}
    Szukasz modułu biblioteki korzystającego z usługi Kotlin? Od października 2023 r. (Firebase BoM 32.5.0) zarówno deweloperzy aplikacji Kotlin, jak i języki Java mogą korzystać z modułu biblioteki głównej (więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania o tę inicjatywę).

  2. Zadeklaruj obiekt com.google.firebase.analytics.FirebaseAnalytics na górze aktywności:

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Zainicjuj go w metodzie onCreate():

    Kotlin+KTX 

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

    Java 

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

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")
}
MainActivity.kt

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);
MainActivity.java

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