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 definiowane przez Ciebie, aby opisać segmenty użytkowników, np. ustawienia języka lub położenie geograficzne.

Analytics automatycznie rejestruje niektóre zdarzeniawłaściwości użytkownika – nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Jeśli nie masz jeszcze Firebase, dodaj je do projektu na Androida 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, aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.

Dodaj do aplikacji pakiet SDK Analytics

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

    Gdy używasz interfejsu Firebase Android BoM, Twoja aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

    (Alternatywnie) Dodaj zależności bibliotek Firebase bez korzystania z 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

    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 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. Ta sekcja pokazuje, jak rejestrować zdefiniowane 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")
}

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);

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