Rozpoczęcie korzystania z Google Analytics

Z tego przewodnika Szybki start dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane dotyczące użytkowania i zachowania Twojej aplikacji. Zestaw SDK rejestruje dwa podstawowe typy informacji:

  • Zdarzenia: co dzieje się w Twojej aplikacji, np. działania użytkownika, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: Atrybuty, które definiujesz w celu opisania segmentów bazy użytkowników, takie jak preferencje językowe lub lokalizacja geograficzna.

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 tworzenia projektu.

  • Jeśli korzystasz z istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w swoim > Ustawienia projektu , aby je włączyć.

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

Dodaj pakiet SDK Analytics do swojej aplikacji

  1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle ) dodaj zależność dla biblioteki Analytics dla Android. Zalecamy używanie Firebase Android BoM do kontrolowania wersji bibliotek.

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:32.7.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 Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać z kompatybilnych wersji bibliotek Firebase Android.

    (Alternatywa) Dodaj zależności biblioteki Firebase bez użycia BoM

    Jeśli zdecydujesz się nie używać BoM Firebase, musisz określić każdą wersję biblioteki Firebase w jej wierszu zależności.

    Pamiętaj, że jeśli używasz w swojej aplikacji wielu bibliotek Firebase, zdecydowanie zalecamy używanie BoM do zarządzania wersjami bibliotek, co gwarantuje, że wszystkie wersje będą kompatybilne.

    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:21.5.1")
    }
    
    Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. Zainicjuj go w metodzie onCreate() :

    Kotlin+KTX

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

    Java

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

Rozpocznij rejestrowanie zdarzeń

Po utworzeniu instancji FirebaseAnalytics możesz 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ż. Powinieneś wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i móc korzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanych zdarzeń. 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.

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żna włączyć pełne rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK i sprawdzać, czy zdarzenia są rejestrowane prawidłowo. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć szczegółowe rejestrowanie za pomocą szeregu 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 Twoje zdarzenia w logcat Android Studio, pomagając Ci natychmiast sprawdzić, czy zdarzenia są wysyłane.

Następne kroki