Erste Schritte mit Google Analytics für Android

Plattform auswählen : iOS+ Android Web Flutter Unity C++


In dieser Kurzanleitung erfahren Sie, wie Sie Ihrer App Google Analytics hinzufügen und mit der Protokollierung von Ereignissen beginnen.

Google Analytics erfasst Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei Haupttypen von Informationen:

  • Ereignisse:Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
  • Nutzereigenschaften:Attribute, die Sie definieren, um Segmente Ihrer Nutzerbasis zu beschreiben, z. B. Spracheinstellungen oder geografische Standorte.

Analytics protokolliert einige Ereignisse und Nutzereigenschaften automatisch. Sie müssen dafür also keinen Code hinzufügen.

Hinweis

Falls noch nicht geschehen, fügen Sie Ihrem Android Projekt Firebase hinzu und prüfen Sie, ob Google Analytics in Ihrem Firebase-Projekt aktiviert ist:

  • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Workflows zur Projekterstellung.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, können Sie es in den Einstellungen > Integrationen aktivieren.

Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Apps mit Google Analytics Datenstreams verknüpft.

Fügen Sie das Analytics SDK Ihrer App hinzu

  1. Fügen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die Abhängigkeit für die Analytics Bibliothek für Android hinzu. Wir empfehlen, die Firebase Android BoM zu verwenden, um die Bibliotheksversionierung zu steuern. 

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

    Mit der Firebase Android BoM, haben Sie immer eine kompatible Version der Firebase Android-Bibliotheken in Ihrer App.

    (Alternative)   Firebase-Bibliotheksabhängigkeiten ohne Verwendung der BoM

    Wenn Sie die Firebase BoM nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in der entsprechenden Abhängigkeitszeile angeben.

    Beachten Sie, dass, wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, wir dringend empfehlen, die BoM zur Verwaltung der Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind. 

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

  2. Deklarieren Sie oben in Ihrer Aktivität das Objekt com.google.firebase.analytics.FirebaseAnalytics:

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. Initialisieren Sie es in der Methode onCreate():

    Kotlin 

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

    Java 

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

Ereignisse protokollieren

Nachdem Sie eine FirebaseAnalytics-Instanz erstellt haben, können Sie Ereignisse mit der logEvent()-Methode protokollieren.

Bestimmte Ereignisse werden für alle Apps empfohlen; andere werden für bestimmte Unternehmenstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den zugehörigen Parametern senden, um detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. In diesem Abschnitt wird die Protokollierung eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zur Protokollierung von Ereignissen finden Sie unter Ereignisse protokollieren.

Mit dem folgenden Code wird ein SELECT_CONTENT-Ereignis protokolliert, wenn ein Nutzer auf ein bestimmtes Element in Ihrer App klickt.

Kotlin 

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

Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell protokollierte Ereignisse.

Sie können die ausführliche Protokollierung mit einer Reihe von adb-Befehlen aktivieren:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Mit diesem Befehl werden Ihre Ereignisse im Logcat von Android Studio angezeigt. So können Sie sofort prüfen, ob Ereignisse gesendet werden.

Nächste Schritte