Ereignisse protokollieren

Diese Anleitung zeigt Ihnen, wie Sie Ereignisse in Ihrer App protokollieren.

Ereignisse bieten Einblicke in die Vorgänge in Ihrer App, z. B. Benutzeraktionen, Systemereignisse oder Fehler.

Analytics protokolliert automatisch einige Ereignisse für Sie. Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten sammeln muss, können Sie bis zu 500 verschiedenen Analytics Ereignistypen in der App einloggen oben. Das Gesamtvolumen der Ereignisse, die Ihre App protokolliert, ist unbegrenzt. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird und dass die Protokollierung von zwei Ereignissen, deren Namen sich nur für den Fall unterscheiden, zu zwei unterschiedlichen Ereignissen führt.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie Ihr Projekt eingerichtet haben und auf Analytics zugreifen können, wie unter Erste Schritte mit Analytics beschrieben .

Ereignisse protokollieren

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

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die für verschiedene Arten von Apps gelten, darunter Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und deren Verwendung finden Sie in den Artikeln zu Ereignissen und Eigenschaften in der Firebase-Hilfe.

Implementierungsdetails für vorgeschlagene Ereignistypen finden Sie an folgenden Stellen:

Vorgeschlagene Ereignisse: com.google.firebase.analytics.FirebaseAnalytics.Event Klassenreferenz com.google.firebase.analytics.FirebaseAnalytics.Event .
Vorgeschriebene Parameter: Siehe die Referenz com.google.firebase.analytics.FirebaseAnalytics.Param .

Das folgende Beispiel zeigt, wie ein SELECT_CONTENT Ereignis SELECT_CONTENT :

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

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

Zusätzlich zu den vorgeschriebenen Parametern können Sie jedem Ereignis die folgenden Parameter hinzufügen:

Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können für die Berichterstellung in Ihren Analytics-Berichten registriert werden . Sie können auch als Filter in Zielgruppendefinitionen verwendet werden, die auf jeden Bericht angewendet werden können. Benutzerdefinierte Parameter sind auch in Daten enthalten, die nach BigQuery exportiert werden, wenn Ihre App mit einem BigQuery-Projekt verknüpft ist.
VALUE Parameter: VALUE ist ein Allzweckparameter, der zum Akkumulieren einer Schlüsselmetrik für ein Ereignis nützlich ist. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen vorgeschlagenen Ereignistyp abgedeckt sind, können Sie Ihre eigenen benutzerdefinierten Ereignisse protokollieren, wie in diesem Beispiel gezeigt:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);MainActivity.java

Kotlin + KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}MainActivity.kt

Legen Sie die Standardereignisparameter fest

Sie können Parameter ereignisübergreifend mit setDefaultEventParameters . Standardparameter sind allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin + KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Wenn in der logEvent() -Methode ein Parameter angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.

Rufen Sie zum setDefaultEventParameters eines Standardparameters die Methode setDefaultEventParameters mit dem Parameter null .

Zeigen Sie Ereignisse im Android Studio-Debugprotokoll an

Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und zu überprüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dies umfasst 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 Android Studio-Protokoll angezeigt, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.

Ereignisse im Dashboard anzeigen

Sie können aggregierte Statistiken zu Ihren Ereignissen in den Firebase-Konsolen-Dashboards anzeigen. Diese Dashboards werden im Laufe des Tages regelmäßig aktualisiert. Verwenden Sie zum sofortigen Testen die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.

Sie können über das Ereignis- Dashboard in der Firebase-Konsole auf diese Daten zugreifen. Dieses Dashboard zeigt die Ereignisberichte an, die automatisch für jeden von Ihrer App protokollierten Ereignistyp erstellt werden.