Ereignisse protokollieren

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


Ereignisse liefern Informationen darüber, was in Ihrer App geschieht, z. B. Nutzeraktionen, 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 erfassen muss, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App protokollieren. Es gibt keine Beschränkung für die Gesamtzahl der Ereignisse, die Ihre App protokolliert. Beachten Sie bei der Benennung von Ereignissen die Groß-/Kleinschreibung. Zwei Ereignisnamen, die sich nur bei der Groß-/Kleinschreibung unterscheiden, führen zu zwei unterschiedlichen Ereignissen.

Hinweis

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

Log-Ereignisse

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

Für den Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die in verschiedenen Arten von Apps häufig vorkommen, z. B. in Einzelhandels- und E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie unter Empfohlene Ereignisse.

Details zur Implementierung empfohlener Ereignistypen finden Sie hier:

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

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);

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. Benutzerdefinierte Dimensionen können für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für alle Parameterdaten verwendet werden, 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 Analysen > Benutzerdefinierte Definitionen auf.

    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 Google Analytics 4 BigQuery Export.

  • VALUE-Parameter: VALUE ist ein allgemeiner Parameter, der nützlich ist, um einen wichtigen Messwert zu einem Ereignis zu erfassen. Beispiele hierfür sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte 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)
}

Java 

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

Standardereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter ereignisübergreifend protokollieren. Standardparameter werden mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

Wie bei benutzerdefinierten Parametern müssen Sie 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 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, wobei der Parameter auf null gesetzt ist.

Ereignisse im Debugging-Log von Android Studio ansehen

Sie können das ausführliche Logging aktivieren, um das Logging von Ereignissen durch das SDK zu überwachen und zu prüfen, ob Ereignisse ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell protokollierte 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

In der Firebase-Konsole können Sie sich im Dashboard Analytics > Ereignisse zusammengefasste Statistiken zu Ihren Ereignissen ansehen.

Beachten Sie bei diesem Dashboard Folgendes:

  • Im Dashboard werden die Ereignisberichte angezeigt, 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 können Sie die Logcat-Ausgabe verwenden, wie im vorherigen Abschnitt dieses Leitfadens beschrieben.