Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Ereignisse protokollieren

In dieser Anleitung erfahren Sie, wie Sie Ereignisse in Ihrer App protokollieren.

Ereignisse bieten Einblicke in das, was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.

Analytics automatisch protokolliert 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. Die Gesamtmenge der von Ihrer App protokollierten Ereignisse ist unbegrenzt. Beachten Sie, dass bei Ereignisnamen die Groß-/Kleinschreibung beachtet wird und dass das Protokollieren von zwei Ereignissen, deren Namen sich nur in der Groß-/Kleinschreibung unterscheiden, zu zwei unterschiedlichen Ereignissen führt.

Bevor Sie beginnen

Stellen Sie sicher , dass Sie Ihr Projekt eingerichtet haben und Analytics , wie beschrieben zugreifen können in mit Analytics Erste Schritte .

Ereignisse protokollieren

Nachdem Sie die konfigurierten firebase.analytics() Instanz, können Sie beginnen , Ereignisse zu protokollieren mit dem logEvent() Methode. Wenn Sie bereits mit Google Analytics sind, dann ist diese Methode entspricht den zur Verwendung von event - Befehl in gtag.js .

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die für verschiedene Arten von Apps üblich sind, einschließlich Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Um mehr zu erfahren über diese Ereignisse und wann sie verwendet werden , durchsuchen Sie die Ereignisse und Eigenschaften Artikel in der Firebase - Hilfe.

Hinweis: Um das maximale Detail in Berichten zu erhalten, melden Sie sich die vorgeschlagenen Ereignisse des Sinn für Ihre Anwendung und ihre vorgeschriebenen Parameter. Dadurch wird auch sichergestellt, dass Sie von den neuesten Google Analytics-Funktionen profitieren, sobald sie verfügbar sind.

Sie können Implementierungsdetails für verschiedene Ereignisse und deren Parameter in der finden gtag.js Ereignis Referenz .

Das folgende Beispiel zeigt , wie ein loggt select_content Ereignis:

Webversion 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Webversion 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Zusätzlich zu den vorgeschriebenen Parametern können Sie jedem Ereignis die folgenden Parameter hinzufügen:

  • Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können registriert für die Berichterstattung in Ihren Analytics - Berichten. Sie können auch als Filter verwendet werden in Publikum Definitionen, die für jeden Bericht angewendet werden kann. Benutzerdefinierte Parameter werden auch in Daten enthalten exportiert BigQuery wenn Ihre Anwendung auf ein BigQuery - Projekt verknüpft ist.
  • value value ist ein Allzweck - Parameter, der zum Akkumulieren eine Schlüssel Metrik , die betrifft ein Ereignis nützlich ist. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die von einem vorgeschlagenen Ereignistyp nicht abgedeckt werden, 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, können Sie ein Ereignis ähnlich dem folgenden Beispiel protokollieren:

Webversion 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Webversion 8

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 werden im Laufe des Tages regelmäßig aktualisiert. Verwenden Sie zum sofortigen Testen die Ausgabe von logcat, wie im vorherigen Abschnitt beschrieben.

Sie können diese Daten zugreifen aus dem Event Armaturenbrett in der Konsole Firebase. Dieses Dashboard zeigt die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.