Zacznij korzystać z Google Analytics

Z tego krótkiego wprowadzenia 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. SDK rejestruje dwa podstawowe typy informacji:

  • Wydarzenia: co dzieje się w Twojej aplikacji, takich jak działania użytkowników, zdarzeń systemowych, lub błędów.
  • Właściwości użytkowników: atrybuty, które określają w celu opisania segmentów bazy użytkowników, takie jak preferowany język czy położenia geograficznego.

Analytics automatycznie rejestruje pewne zdarzenia i właściwości użytkownika ; nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Jeśli jeszcze nie masz, dodać Firebase do projektu Android i upewnić się, że Google Analytics jest włączona w twojej Firebase projektu:

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

  • Jeśli używasz istniejącego projektu Firebase że nie ma włączonego Google Analytics, przejdź do Integrations karcie swoimi > Ustawienia projektu, aby ją włączyć.

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

Dodaj pakiet Analytics SDK do swojej aplikacji

  1. Korzystanie z Firebase Android Bom , deklarują zależność dla biblioteki Analytics Android w module (app szczebla) Gradle plik (zazwyczaj app/build.gradle ).

    Jawa

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
        // Declare 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 Bom Android , aplikacja będzie zawsze używać kompatybilne wersje bibliotek Firebase Android.

    (Alternatywna) Stwierdzenie Firebase zależności biblioteki bez użycia BOM

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

    Należy pamiętać, że w przypadku korzystania z wielu bibliotek Firebase w swojej aplikacji, zalecamy korzystania z BOM do zarządzania wersjami biblioteki, co gwarantuje, że wszystkie wersje są kompatybilne.

    dependencies {
        // Declare 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:19.0.1'
    }
    

    Kotlin+KTX

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

    Korzystając z Firebase Bom Android , aplikacja będzie zawsze używać kompatybilne wersje bibliotek Firebase Android.

    (Alternatywna) Stwierdzenie Firebase zależności biblioteki bez użycia BOM

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

    Należy pamiętać, że w przypadku korzystania z wielu bibliotek Firebase w swojej aplikacji, zalecamy korzystania z BOM do zarządzania wersjami biblioteki, co gwarantuje, że wszystkie wersje są kompatybilne.

    dependencies {
        // Declare 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-ktx:19.0.1'
    }
    

  2. Zadeklarować com.google.firebase.analytics.FirebaseAnalytics obiekt na szczycie swojej aktywności:

    Jawa

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Zainicjować w onCreate() metodę:

    Jawa

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

    Kotlin+KTX

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

Rozpocznij rejestrowanie zdarzeń

Po utworzeniu FirebaseAnalytics instancji, można przystąpić do rejestrowania zdarzeń z logEvent() metody.

Niektóre wydarzenia są zalecane dla wszystkich aplikacji ; inne są zalecane dla określonych rodzajów działalności lub branż. Należy wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono zalogowaniu predefiniowanego zdarzenia, aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz dziennik zdarzeń .

Poniższy kod rejestruje SELECT_CONTENT zdarzenie, gdy użytkownik kliknie element określonego w swojej aplikacji.

Jawa

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

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")
}

Możesz włączyć pełne rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK, aby sprawdzić, czy zdarzenia są rejestrowane prawidłowo. Obejmuje to zarówno zdarzenia rejestrowane automatycznie, jak i ręcznie.

Można włączyć pełne rejestrowanie z serii adb poleceń:

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 Android Studio, pomagając natychmiast sprawdzić, czy zdarzenia są wysyłane.

Następne kroki