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 erfassen (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 erfasst.

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 bei verschiedenen Arten von Apps üblich sind, z. B. bei Einzelhandels-, E-Commerce-, Reise- und Gaming-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'
});
analytics_log_event_params.js

Web

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

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, müssen Sie die Dimension oder den Messwert registrieren, damit diese benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Gehen Sie dazu so vor: Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen

    Benutzerdefinierte Parameter können in Zielgruppen definitionen verwendet werden, die auf jeden Bericht angewendet werden können. Benutzerdefinierte Parameter sind auch in den 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 ein wichtiger Messwert für ein Ereignis erfasst werden kann. 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'});
analytics_log_event_custom_params.js

Web

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

Ereignisse im Dashboard ansehen

In den Firebase Console-Dashboards können Sie aggregierte Statistiken zu Ihren Ereignissen aufrufen. Diese Dashboards werden mehrmals täglich aktualisiert. Für sofortige Tests verwenden Sie die Logcat-Ausgabe, wie im vorherigen Abschnitt beschrieben.

Sie können auf diese Daten über das Ereignisse Dashboard in der Firebase Console zugreifen. In diesem Dashboard werden die Ereignisberichte angezeigt, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.