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 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 verschiedene Analytics- Ereignistypen in Ihrer App protokollieren. Es gibt keine Begrenzung für die Gesamtmenge der von Ihrer App protokollierten Ereignisse. Beachten Sie, dass bei Ereignisnamen die Groß-/Kleinschreibung beachtet wird und dass die Protokollierung 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 auf Analytics zugreifen können, wie unter Erste Schritte mit Analytics beschrieben.

Protokollereignisse

Nachdem Sie die firebase.analytics() Instanz konfiguriert haben, können Sie mit der Protokollierung von Ereignissen mit der logEvent() Methode beginnen. Wenn Sie bereits mit Google Analytics vertraut sind, entspricht diese Methode der Verwendung des event Befehls in gtag.js.

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe empfohlener Ereignisse, die bei verschiedenen Arten von Apps vorkommen, darunter Einzelhandels- und E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und deren Verwendung finden Sie unter Empfohlene Ereignisse .

Hinweis: Um möglichst detaillierte Berichte zu erhalten, protokollieren Sie die empfohlenen Ereignisse, die für Ihre App sinnvoll sind, und deren vorgeschriebene Parameter. Dadurch wird auch sichergestellt, dass Sie von den neuesten Google Analytics-Funktionen profitieren, sobald diese verfügbar sind.

Implementierungsdetails für mehrere Ereignisse und deren Parameter finden Sie in der gtag.js-Ereignisreferenz .

Das folgende Beispiel zeigt, wie ein select_content Ereignis protokolliert wird:

Web modular API

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web namespaced API

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 als Dimensionen oder Metriken 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 Metrik, 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 den nach BigQuery exportierten Daten enthalten, wenn Ihre App mit einem BigQuery-Projekt verknüpft ist. Beispielabfragen und vieles mehr finden Sie unter Google Analytics 4 BigQuery Export .

  • value : value ist ein Allzweckparameter, der zum Sammeln einer Schlüsselmetrik für ein Ereignis nützlich ist. Beispiele hierfür sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp 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:

Web modular API

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

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

Web namespaced API

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

Sehen Sie sich 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. Für sofortige Tests verwenden Sie 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 einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.