Rozpoczęcie korzystania z Google Analytics

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

  1. 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")
}
    Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0), programiści, zarówno w języku Kotlin, jak i w języku Java, zależą od modułu biblioteki głównej (więcej informacji znajdziesz w Najczęstsze pytania na temat tej inicjatywy).

  2. Zadeklaruj obiekt com.google.firebase.analytics.FirebaseAnalytics w najważniejsza część Twojej 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ąć 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")
}
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. 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