Ereignisse protokollieren

iOS+ Android Web Flutter

In diesem Leitfaden erfahren Sie, wie Sie Ereignisse in Ihrer App erfassen.

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

Hinweis

Sie müssen Ihr Projekt eingerichtet haben und wie in der Einführung in Analytics beschrieben auf Analytics zugreifen können.

Protokollereignisse

Nachdem Sie eine FirebaseAnalytics-Instanz erstellt haben, können Sie damit Ereignisse mit den log-Methoden der Bibliothek protokollieren.

Vordefinierte Ereignisse

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 detaillierten Daten 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 sie verfügbar sind.

Die Protokollmethoden für die empfohlenen Ereignistypen finden Sie in der API-Referenz.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Alternativ können Sie dasselbe Ereignis mit logEvent() erfassen:

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Das kann nützlich sein, wenn Sie neben den vorgeschriebenen (erforderlichen) Parametern zusätzliche Parameter angeben möchten. Sie können 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. Rufen Sie dazu Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen 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. Beispielabfragen und weitere Informationen finden Sie unter BigQuery Export für Google Analytics 4.

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

• Parameternamen dürfen maximal 40 Zeichen lang sein, müssen mit einem Buchstaben beginnen und nur alphanumerische Zeichen und Unterstriche enthalten. Es werden String- und Zahlentypen unterstützt. Stringparameterwerte können bis zu 100 Zeichen lang sein. Die Präfixe „firebase“, „google“ und „ga_“ sind reserviert und sollten nicht für Parameternamen verwendet werden.

Benutzerdefinierte Ereignisse

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse erfassen, wie in diesem Beispiel gezeigt:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Standardereignisparameter festlegen

Mit setDefaultEventParameters() können Sie Parameter für mehrere Ereignisse protokollieren. Standardparameter werden mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

Registrieren Sie die Standardereignisparameter, damit sie in Analytics-Berichten berücksichtigt werden.

Gültige Parameterwerte sind „String“ und „num“. Wenn Sie den Wert eines Schlüssels auf null festlegen, wird dieser Parameter gelöscht. Wenn Sie einen Nullwert übergeben, werden alle Parameter gelöscht.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Wenn in der logEvent()- oder log-Methode ein Parameter angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.

Wenn Sie einen Standardparameter löschen möchten, rufen Sie die Methode setDefaultEventParameters() mit dem Parameter null auf.

Ereignisse im Dashboard ansehen

In den Firebase-Console-Dashboards können Sie zusammengefasste Statistiken zu Ihren Ereignissen aufrufen. Diese Dashboards werden mehrmals täglich 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.