Diese Anleitung zeigt Ihnen, wie Sie Ereignisse in Ihrer App protokollieren.
Ereignisse geben Aufschluss darüber, was in Ihrer App passiert, 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 erfassen muss, können Sie bis zu 500 verschiedene Analytics- Ereignistypen in Ihrer App protokollieren. 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 und dass das Protokollieren von zwei Ereignissen, deren Namen sich nur in Groß- und Kleinschreibung unterscheiden, zu zwei unterschiedlichen Ereignissen führt.
Bevor Sie beginnen
Stellen Sie sicher, dass Sie Ihr Projekt eingerichtet haben und wie unter Erste Schritte mit Analytics beschrieben auf Analytics zugreifen können.
Ereignisse protokollieren
Nachdem Sie eine FirebaseAnalytics
Instanz erstellt haben, können Sie sie zum Protokollieren von Ereignissen mit der Methode logEvent()
verwenden.
Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von empfohlenen Ereignissen, die bei verschiedenen App-Typen üblich sind, darunter Einzelhandels- und 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:
- Empfohlene Ereignisse: Siehe die Klassenreferenz
com.google.firebase.analytics.FirebaseAnalytics.Event
. - Vorgeschriebene Parameter: siehe Referenz
com.google.firebase.analytics.FirebaseAnalytics.Param
.
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") }
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 als Dimensionen oder Messwerte in Analytics-Berichten verwendet werden . Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Metriken für alle Parameterdaten verwenden, die besser numerisch dargestellt werden. Nachdem Sie einen benutzerdefinierten Parameter mit dem SDK protokolliert haben, registrieren Sie die Dimension oder den Messwert, um sicherzustellen, dass diese benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Tun Sie dies über: 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 vieles mehr finden Sie unter Google Analytics 4 BigQuery Export .
VALUE
Parameter:VALUE
ist ein Allzweckparameter, der zum Sammeln einer Schlüsselmetrik nützlich ist, die sich auf ein Ereignis bezieht. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.
Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht von einem empfohlenen Ereignistyp abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Ereignisse protokollieren, wie in diesem Beispiel gezeigt:
Kotlin+KTX
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);
Legen Sie Standardereignisparameter fest
Mit setDefaultEventParameters
können Sie Parameter ereignisübergreifend protokollieren. Standardparameter sind allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.
Registrieren Sie wie bei benutzerdefinierten Parametern die Standardereignisparameter, um sicherzustellen, dass sie in Analytics-Berichten angezeigt 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 ein Parameter in der Methode logEvent()
angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.
Um einen Standardparameter zu löschen, rufen Sie die Methode setDefaultEventParameters
auf, wobei der Parameter auf null
festgelegt ist.
Zeigen Sie Ereignisse im Debug-Protokoll von Android Studio an
Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und so 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
Dieser Befehl zeigt Ihre Ereignisse im Logcat von Android Studio an, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.
Zeigen Sie Ereignisse im Dashboard an
Sie können aggregierte Statistiken zu Ihren Ereignissen in den Dashboards der Firebase-Konsole 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 auf diese Daten über das Ereignis- Dashboard in der Firebase-Konsole zugreifen. Dieses Dashboard zeigt die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.