Ereignisse protokollieren


In diesem Leitfaden erfahren Sie, wie Sie Ereignisse in Ihrer App protokollieren.

Ereignisse liefern Informationen darüber, was in Ihrer App geschieht, z. B. Nutzeraktionen, Systemereignisse oder Fehler.

Analytics protokolliert einige Ereignisse automatisch. Sie müssen also keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten erfassen muss, können Sie bis zu 500 verschiedene AnalyticsEreignistypen in Ihrer App protokollieren. Es gibt keine Einschränkungen hinsichtlich des Gesamtvolumens der von Ihrer App protokollierten Ereignisse. Achten Sie bei Ereignisnamen auf Groß- und Kleinschreibung: Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

Hinweis

Achten Sie darauf, dass Sie Ihr Projekt eingerichtet haben und wie in Erste Schritte mit Analytics beschrieben auf Analytics zugreifen können.

Protokollereignisse

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

Das Analytics SDK definiert eine Reihe empfohlener Ereignisse, die für verschiedene Arten von Apps üblich sind, darunter Einzelhandel und E-Commerce, Reisen und Spiele. Weitere Informationen zu diesen Ereignissen und wann sie verwendet werden sollten, finden Sie unter Empfohlene Ereignisse.

Implementierungsdetails für empfohlene Ereignistypen finden Sie an den folgenden Stellen:

Das folgende Beispiel zeigt, wie ein SELECT_CONTENT-Ereignis protokolliert wird:

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

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

  • Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können als Dimensionen oder Messwerte in Analytics-Berichten verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für alle Parameterdaten verwenden, die sich besser numerisch darstellen lassen. Nachdem Sie einen benutzerdefinierten Parameter mit dem SDK protokolliert haben, müssen Sie die Dimension oder den Messwert registrieren, damit die benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Verwenden Sie dazu Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen.

    Benutzerdefinierte Parameter können 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. Hier finden Sie Beispielabfragen und vieles mehr.

  • Parameter VALUE: VALUE ist ein Allzweckparameter, der sich eignet, um einen wichtigen Messwert für ein Ereignis zu erfassen. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Ereignisse wie in diesem Beispiel gezeigt erfassen:

Kotlin 

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

Java 

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

Standard-Ereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter für verschiedene Ereignisse protokollieren. Standardparameter sind mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

Wie bei benutzerdefinierten Parametern müssen Sie auch die Standardereignisparameter registrieren, damit sie in Analytics-Berichten berücksichtigt werden.

Kotlin 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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

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

Wenn Sie einen Standardparameter löschen möchten, rufen Sie die Methode setDefaultEventParameters auf und setzen Sie den Parameter auf null.

Ereignisse im Android Studio-Debug-Log ansehen

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

Ereignisse im Dashboard ansehen

Sie können sich zusammengefasste Statistiken zu Ihren Ereignissen in den Firebase-Konsolendashboards ansehen. Diese Dashboards werden mehrmals täglich aktualisiert. Für sofortige Tests verwenden Sie die logcat-Ausgabe, wie im vorherigen Abschnitt beschrieben.

Sie können über das Dashboard Ereignisse in der Firebase Console auf diese Daten zugreifen. In diesem Dashboard sehen Sie die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.