Ereignisse protokollieren


In diesem Leitfaden erfahren Sie, wie Sie Ereignisse in Ihrer Anwendung protokollieren.

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

In Analytics werden einige Ereignisse automatisch protokolliert. Sie müssen also keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten erfassen muss, können Sie bis zu 500 unterschiedliche Analytics Ereignistypen in Ihrer App erfassen. Die Gesamtmenge der Ereignisse, die in Ihrer App protokolliert werden, ist nicht begrenzt. Bei Ereignisnamen wird zwischen Groß- und Kleinschreibung unterschieden. Das Logging von zwei Ereignissen, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, führt zu zwei unterschiedlichen Ereignissen.

Hinweis

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

Protokollereignisse

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 Befehls event in gtag.js.

Zum Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die für verschiedene Arten von Apps üblich sind, z. B. für Einzelhandels- und E-Commerce-Apps, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie unter Empfohlene Ereignisse.

Hinweis:Wenn Sie Berichte mit möglichst vielen Details erhalten möchten, sollten Sie die empfohlenen Ereignisse, die für Ihre App sinnvoll sind, und die zugehörigen Parameter erfassen. Außerdem profitieren Sie so von den neuesten Google Analytics-Funktionen, sobald diese verfügbar sind.

Implementierungsdetails für verschiedene Ereignisse und die zugehörigen 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 Dimensionen oder Messwerte verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für 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 berücksichtigt werden. Wählen Sie dazu Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen aus.

    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. Beispielabfragen und weitere Informationen finden Sie unter BigQuery Export für Google Analytics 4.

  • value-Parameter: value ist ein allgemeiner Parameter, der sich zum Erfassen eines wichtigen Messwerts für ein Ereignis eignet. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

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

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 zusammengefasste Statistiken zu Ihren Ereignissen aufrufen. Diese Dashboards werden im Laufe des Tages regelmäßig aktualisiert. Verwenden Sie für sofortige Tests die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.

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