Ereignisse protokollieren


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

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

In Analytics werden einige Ereignisse automatisch protokolliert. 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 unterschiedliche Analytics Ereignistypen in Ihrer App erfassen. Die Gesamtmenge der Ereignisse, die in Ihrer App protokolliert werden, ist nicht begrenzt. Bei Ereignisnamen wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur durch die Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

Hinweis

Sie müssen Ihr Projekt eingerichtet haben und wie unter 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.

Zum Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die für verschiedene Arten von Apps üblich sind, z. B. für Einzelhandels- und E-Commerce-Apps, 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 ein SELECT_CONTENT-Ereignis protokolliert wird:

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

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 Dimensionen oder Messwerte verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für 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 diese benutzerdefinierten Parameter in Analytics-Berichten berücksichtigt werden. Gehen Sie dazu so vor: 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. Beispielabfragen und weitere Informationen finden Sie unter BigQuery Export für Google Analytics 4.

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

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

Kotlin+KTX 

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 mehrere Ereignisse protokollieren. Standardparameter werden mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

Registrieren Sie die Standardereignisparameter, damit sie in Analytics-Berichten berücksichtigt werden.

Kotlin+KTX 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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

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

Wenn Sie einen Standardparameter löschen möchten, rufen Sie die Methode setDefaultEventParameters auf, wobei der Parameter auf null gesetzt ist.

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

Ereignisse im Dashboard ansehen

In den Firebase-Console-Dashboards können Sie zusammengefasste Statistiken zu Ihren Ereignissen aufrufen. Diese Dashboards werden mehrmals täglich aktualisiert. Verwenden Sie für sofortige Tests die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.

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