Ereignisse protokollieren

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


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

Analytics protokolliert einige Ereignisse automatisch. Sie müssen also keinen Code hinzufügen, um sie zu erhalten. Wenn Sie zusätzliche Daten benötigen, können Sie bis zu 500 verschiedene Analytics Ereignis typen in Ihrer App erfassen. Es gibt keine Begrenzung für das Gesamtvolumen der Ereignisse, die Ihre App protokolliert. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur durch die Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse erfasst.

Hinweis

Achten Sie darauf, 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 sie nutzen, um Ereignisse mit der logEvent() Methode zu protokollieren.

Das Analytics SDK definiert eine Reihe empfohlener Ereignisse, die bei verschiedenen Arten von Apps üblich sind, z. B. bei Einzelhandels-, E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie unter Empfohlene Ereignisse.

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

Das folgende Beispiel zeigt, wie Sie ein SELECT_CONTENT Ereignis protokollieren:

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 in Analytics-Berichten als Analytics Dimensionen oder Messwerte 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, registrieren Sie die Dimension oder den Messwert, damit diese benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Rufen Sie dazu in der Firebase Konsole Analytics > Benutzerdefinierte Definitionen auf.

    Benutzerdefinierte Parameter können in Zielgruppen definitionen 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. Beispielabfragen und vieles mehr finden Sie unter BigQuery Export für Google Analytics 4.

  • Parameter VALUE: VALUE ist ein Allzweckparameter, mit dem sich ein wichtiger Messwert für ein Ereignis erfassen lässt. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die von einem empfohlenen Ereignistyp nicht abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse protokollieren, wie in diesem Beispiel:

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

Standardereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter für alle Ereignisse protokollieren. Standardparameter werden allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.

Wie bei benutzerdefinierten Parametern müssen Sie auch die Standardereignisparameter registrieren, damit sie in Analytics-Berichten angezeigt 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 in der logEvent() Methode ein Parameter angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.

Wenn Sie einen Standardparameter löschen möchten, rufen Sie die setDefaultEventParameters Methode 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 beobachten und so zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Das gilt sowohl für automatisch als auch für 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-Logcat angezeigt. So können Sie sofort prüfen, ob Ereignisse gesendet werden.

Ereignisse im Dashboard ansehen

In der Firebase Konsole können Sie aggregierte Statistiken zu Ihren Ereignissen unter Analytics > Ereignisse aufrufen.

Beachten Sie Folgendes zu diesem Dashboard:

  • Das Dashboard zeigt die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.

  • Das Dashboard wird mehrmals täglich aktualisiert. Für sofortige Tests verwenden Sie die Logcat-Ausgabe, wie im vorherigen Abschnitt dieser Anleitung beschrieben.