Erste Schritte mit Google Analytics


In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics zu Ihrer App hinzufügen und damit beginnen, Ereignisse zu erfassen.

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

  • Ereignisse:Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
  • Nutzereigenschaften:Attribute, mit denen Sie Nutzersegmente wie Spracheinstellungen oder geografische Standorte beschreiben.

In Analytics werden einige Ereignisse und Nutzereigenschaften automatisch protokolliert. Sie müssen dazu keinen Code hinzufügen.

Hinweis

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 Projekterstellungsworkflows.

  • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, rufen Sie den Tab Integrationen unter  > Projekteinstellungen auf, um Google Analytics zu aktivieren.

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

Analytics SDK in Ihre App einbinden

  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 Versionierung der Bibliothek zu steuern. 

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

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

    Alternative: Firebase-Bibliotheksabhängigkeiten ohne BoM hinzufügen

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

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir Ihnen dringend, die Bibliotheksversionen mithilfe der BoM zu verwalten. So wird sichergestellt, 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:22.1.2")
}
    Sie suchen nach einem Kotlin-spezifischen Bibliotheksmodul? Ab Oktober 2023 (Firebase BoM 32.5.0) können sowohl Kotlin- als auch Java-Entwickler das Hauptbibliotheksmodul verwenden. Weitere Informationen finden Sie in den häufig gestellten Fragen zu dieser Initiative.

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

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Initialisieren Sie sie in der onCreate()-Methode:

    Kotlin+KTX 

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

    Java 

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

Ereignisse protokollieren

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

Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. 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 das Protokollieren eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.

Im folgenden Code wird das Ereignis SELECT_CONTENT protokolliert, wenn ein Nutzer auf ein bestimmtes Element in Ihrer App klickt.

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

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 aufgezeichnete Ereignisse.

Sie können das ausführliche Logging 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 Android Studio-Logcat angezeigt. So können Sie sofort prüfen, ob Ereignisse gesendet werden.

Nächste Schritte