Rozpoczęcie korzystania z Google Analytics


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

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 służące do opisywania segmentów Twoich użytkowników, np. ich ustawień języka lub położenia geograficznego.

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 nie masz jeszcze Firebase na Androida, dodaj Firebase do swojego projektu i upewnij się, że w projekcie Firebase jest włączona opcja Google Analytics:

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

  • Jeśli używasz dotychczasowego projektu Firebase, w którym nie włączono funkcji Google Analytics, przejdź do karty Integracje > Ustawienia projektu, aby ją włączyć.

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

Dodawanie do aplikacji pakietu SDK Analytics

  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ść z biblioteką 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:33.6.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 Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.

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

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

    Jeśli w aplikacji używasz kilku bibliotek Firebase, zdecydowanie zalecamy korzystanie z BoM do zarządzania wersjami bibliotek. Dzięki temu wszystkie wersje będą ze sobą 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.2")
}
    Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).

  2. Zadeklaruj obiekt com.google.firebase.analytics.FirebaseAnalytics u góry 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

Rozpocznij rejestrowanie zdarzeń

Po utworzeniu instancji FirebaseAnalytics możesz zacząć rejestrować zdarzenia za pomocą metody logEvent().

Niektóre zdarzenia są zalecane we wszystkich aplikacjach, a inne w przypadku określonych rodzajów działalności 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, sugerowane zdarzenia należy wysyłać z określonymi parametrami. W tej sekcji pokazano rejestrowanie zdefiniowanego wstępnie zdarzenia. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w sekcji Zdarzenia z dziennika.

Gdy użytkownik kliknie określony element w aplikacji, kod ten zarejestruje zdarzenie SELECT_CONTENT.

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

Aby sprawdzać, czy zdarzenia są prawidłowo rejestrowane przez pakiet SDK, możesz włączyć szczegółowe rejestrowanie. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Możesz włączyć szczegółowe logowanie 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 w Android Studio, co ułatwia natychmiastowe sprawdzenie, czy są one wysyłane.

Dalsze kroki