Ereignisse protokollieren

Plattform auswählen: iOS+ Android Web Flutter Unity C++


Ereignisse geben Aufschluss darüber, was in Ihrer App passiert, z. B. Nutzeraktionen, 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 erheben muss, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App protokollieren (2.000, wenn Sie Google Analytics 360 verwenden). Es gibt keine Einschränkungen im Hinblick auf die Gesamtmenge der Ereignisse, die von Ihrer App protokolliert werden. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

Hinweis

Prüfen Sie, ob Sie Ihr Projekt eingerichtet haben und auf Analytics zugreifen können, wie unter Erste Schritte mit Analytics beschrieben.

Log-Ereignisse

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

Das Analytics SDK definiert eine Reihe empfohlener Ereignisse, die in verschiedenen Arten von Apps üblich sind, z. B. in Einzelhandels- und E-Commerce-Apps, Reise-Apps und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und dazu, wann sie verwendet werden sollten, finden Sie unter Empfohlene Ereignisse.

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

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

Web

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

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

Web

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 Messwerte in Analytics-Berichten verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Daten von Ereignisparametern und benutzerdefinierte Messwerte für alle Parameterdaten verwenden, die sich besser numerisch darstellen lassen. Nachdem Sie einen benutzerdefinierten Parameter mit dem SDK protokolliert haben, müssen Sie die Dimension oder den Messwert registrieren, damit die benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Rufen Sie dazu in der Firebase-Konsole Analysen > Benutzerdefinierte Definitionen auf.

    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. Hier finden Sie Beispielabfragen und vieles mehr unter Google Analytics 4 BigQuery Export.

  • Parameter value: value ist ein Allzweckparameter, mit dem sich ein wichtiger Messwert für ein Ereignis erfassen lässt. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse protokollieren. Wenn Sie beispielsweise ein Spiel entwickeln und erfassen möchten, wann ein Spieler ein bestimmtes Ziel erreicht, können Sie ein Ereignis protokollieren, das dem folgenden Beispiel ähnelt:

Web

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

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

Web

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

Ereignisse im Dashboard ansehen

In der Firebase-Konsole können Sie auf dem Analytics-Dashboard > Ereignisse aggregierte Statistiken zu Ihren Ereignissen aufrufen.

Beachten Sie bei diesem Dashboard Folgendes:

  • Im Dashboard sehen Sie die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.

  • Das Dashboard wird mehrmals täglich aktualisiert. Für sofortige Tests können Sie DebugView verwenden.