Ereignisse protokollieren

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


Ereignisse liefern Informationen darüber, was in Ihrer App geschieht, z. B. Nutzeraktionen, System ereignisse oder Fehler.

Analytics protokolliert einige Ereignisse automatisch. Sie müssen also keinen Code hinzufügen, um diese Ereignisse zu erhalten. Wenn Sie zusätzliche Daten benötigen, können Sie bis zu 500 verschiedene Analytics Ereignis typen in Ihrer App protokollieren (2.000 bei Verwendung von Google Analytics 360). Es gibt keine Begrenzung für das Gesamtvolumen der Ereignisse, die Ihre App protokolliert. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur durch die Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

Hinweis

Achten Sie darauf, dass Sie Ihr Projekt eingerichtet haben und auf Analytics zugreifen können, wie unter in Erste Schritte mit Analytics beschrieben.

Ereignisse protokollieren

Nachdem Sie die firebase.analytics()-Instanz konfiguriert haben, können Sie Ereignisse mit der Methode logEvent() 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 für verschiedene Arten von Apps üblich sind, z. B. für Einzelhandels- und E-Commerce-Apps, Reise-Apps und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie unter Empfohlene Ereignisse.

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

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

    Benutzerdefinierte Parameter können in Zielgruppen definitionen verwendet werden, die auf jeden Bericht angewendet werden können. Benutzerdefinierte Parameter sind auch in Daten enthalten, die in BigQuery exportiert werden , wenn Ihre App mit einem BigQuery-Projekt verknüpft ist. Beispielabfragen und vieles mehr finden Sie unter BigQuery Export für Google Analytics 4.

  • Parameter value: value ist ein allgemeiner Parameter, mit dem Sie einen wichtigen Messwert für ein Ereignis erfassen können. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle 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 aggregierte Statistiken zu Ihren Ereignissen im Dashboard Analytics > Ereignisse ansehen.

Beachten Sie bei diesem Dashboard Folgendes:

  • Das Dashboard enthält 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, verwenden Sie das DebugView.