Ereignisse bieten Einblicke in die Vorgänge in Ihrer App, 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 sammeln muss, können Sie bis zu 500 verschiedenen Analytics Ereignistypen in der App einloggen oben. Das Gesamtvolumen der Ereignisse, die Ihre App protokolliert, ist unbegrenzt. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird und dass die Protokollierung von zwei Ereignissen, deren Namen sich nur für den Fall unterscheiden, zu zwei unterschiedlichen Ereignissen führt.
Bevor Sie beginnen
Stellen Sie sicher, 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 damit Ereignisse mit der Methode logEvent()
.
Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die für verschiedene Arten von Apps gelten, darunter Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und deren Verwendung finden Sie in den Artikeln zu Ereignissen und Eigenschaften in der Firebase-Hilfe.
Implementierungsdetails für vorgeschlagene Ereignistypen finden Sie an folgenden Stellen:
- Vorgeschlagene Ereignisse:
com.google.firebase.analytics.FirebaseAnalytics.Event
Klassenreferenzcom.google.firebase.analytics.FirebaseAnalytics.Event
. - Vorgeschriebene Parameter: Siehe die Referenz
com.google.firebase.analytics.FirebaseAnalytics.Param
.
Das folgende Beispiel zeigt, wie ein SELECT_CONTENT
Ereignis SELECT_CONTENT
:
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);
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") }
Zusätzlich zu den vorgeschriebenen Parametern können Sie jedem Ereignis die folgenden Parameter hinzufügen:
Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können für die Berichterstellung in Ihren Analytics-Berichten registriert werden . Sie können auch als Filter 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.
VALUE
Parameter:VALUE
ist ein Allzweckparameter, der zum Akkumulieren einer Schlüsselmetrik für ein Ereignis nützlich ist. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.
Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen vorgeschlagenen Ereignistyp abgedeckt sind, können Sie Ihre eigenen benutzerdefinierten Ereignisse protokollieren, wie in diesem Beispiel gezeigt:
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
Kotlin + KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Legen Sie die Standardereignisparameter fest
Sie können Parameter ereignisübergreifend mit setDefaultEventParameters
. Standardparameter sind allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
Kotlin + KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Wenn in der logEvent()
-Methode ein Parameter angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.
Rufen Sie zum setDefaultEventParameters
eines Standardparameters die Methode setDefaultEventParameters
mit dem Parameter null
.
Zeigen Sie Ereignisse im Android Studio-Debugprotokoll an
Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen und 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
Mit diesem Befehl werden Ihre Ereignisse im Android Studio-Protokoll angezeigt, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.
Ereignisse im Dashboard anzeigen
Sie können aggregierte Statistiken zu Ihren Ereignissen in den Firebase-Konsolen-Dashboards 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 über das Ereignis- Dashboard in der Firebase-Konsole auf diese Daten zugreifen. Dieses Dashboard zeigt die Ereignisberichte an, die automatisch für jeden von Ihrer App protokollierten Ereignistyp erstellt werden.