Rozpoczęcie korzystania z Google Analytics


Z tego krótkiego wprowadzenia dowiesz się, jak dodać usługę Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o korzystaniu z aplikacji i jej działaniu. 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 część wydarzeń i 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 to włączone w projekcie Firebase:

  • Jeśli tworzysz nowy projekt Firebase, włącz funkcję Google Analytics podczas tworzenia projektu.

  • Jeśli używasz istniejącego projektu Firebase, który nie zawiera Włączono Google Analytics, otwórz Integracje na karcie > Ustawienia projektu, aby je włączyć.

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

Dodaj do aplikacji pakiet SDK Analytics

  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 na Androida. Zalecamy użycie metody Firebase Android BoM aby kontrolować obsługę wersji biblioteki. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.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")
}

    Korzystając z narzędzia Firebase Android BoM, Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

    (Wersja alternatywna) Dodaj zależności biblioteki Firebase bez użycia komponentu BoM

    Jeśli nie chcesz używać biblioteki 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 aplikacji, zalecamy korzystanie z BoM do zarządzania wersjami biblioteki. Dzięki temu 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.1.0")
}
    Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i 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