Dieses Handbuch zeigt Ihnen, wie Sie Ereignisse in Ihrer App protokollieren.
Ereignisse geben einen Einblick in die Vorgänge in Ihrer App, z. B. Benutzeraktionen, Systemereignisse oder Fehler.
Analytics protokolliert automatisch someevents für Sie;Sie müssen keinen Code hinzufügen, um sie zu empfangen. Wenn Ihre App zusätzliche Daten sammeln muss, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App protokollieren. Das Gesamtvolumen der Ereignisse, die Ihre App protokolliert, ist nicht begrenzt.,Beachten Sie, dass Ereignisnamen Groß-und Kleinschreibung berücksichtigen und dass das Protokollieren 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 Analysen zugreifen können, wie unter „Mit Analysen beginnen“ beschrieben.
Ereignisse protokollieren
Nachdem Sie die Instanzfirebase.analytics()
konfiguriert haben, können Sie Ereignisse mit der MethodelogEvent()
protokollieren. Wenn Sie bereits mit Google Analytics vertraut sind, ist diese Methodeäquivalent zur Verwendung des Befehlsevent
ingtag.js.,
Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe vorgeschlagener Ereignisse, die bei verschiedenen Arten von Apps üblich sind,einschließlich Einzelhandels-und E-Commerce -, Reise-und Gaming-Apps. Um mehr über diese Ereignisse zu erfahren und sie zu verwenden,durchsuchen Sie die Ereignisseund propertiesarticles im Firebase Help Center.
Hinweis: Um die maximalen Details in Berichten zu erhalten, protokollieren Sie die vorgeschlagenen Ereignisse, die für Ihre App sinnvoll sind, und ihre vorgeschriebenen Parameter. Dies stellt auch sicher, dassSie von den neuesten Google Analytics-Funktionen profitieren, sobald sie verfügbar sind.,
Sie können Implementierungsdetails für mehrere Ereignisse und deren Parameter inthegtag finden.js Ereignis Referenz.
Das folgende Beispiel zeigt, wie ein select_content
Ereignis protokolliert wird:
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: });
Zusätzlich zu den vorgeschriebenen Parametern können Sie die folgenden Parameter hinzufügenzu jedem Ereignis:
- Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können für die Berichterstellung in Ihren Analyseberichten verwendet werden. Sie können auch als Filter in Zieldefinitionen verwendet werden, die auf jeden Bericht angewendet werden können., Benutzerdefinierte Parameter sind auchin dataexported to BigQuery enthalten, wenn Ihre App mit einem BigQuery-Projekt verknüpft ist.
-
value
Parameter:value
ist ein Allzweckparameter, der zum Akkumulieren 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 durch einen vorgeschlagenen Ereignistyp abgedeckt sind, können Sie Ihre eigenen benutzerdefinierten Ereignisse protokollieren., Wenn Sie beispielsweise ein Spiel entwickeln und verfolgen möchten, wann ein Spieler ein bestimmtes Ziel erreicht hat, können Sie ein Ereignisim folgenden Beispiel protokollieren:
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Ereignisse im Dashboard anzeigen
Sie können aggregierte Statistiken zu Ihren Ereignissen in den Dashboards der Firebase-Konsole anzeigen. Diese Dashboards aktualisieren periodicallythroughout den Tag. Verwenden Sie zum sofortigen Testen die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.
Sie können auf diese Daten über das Eventsdashboard in der Firebase-Konsole zugreifen., Dieses Dashboard zeigt die Ereignisberichte an, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.