Log-Ereignisse

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

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. Es gibt keine Einschränkungen im Hinblick auf die Gesamtmenge der Ereignisse, die Ihre App protokolliert. Achten Sie bei den Namen von Ereignissen auf Groß- und Kleinschreibung: Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

Hinweis

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

Wenn Sie Daten zur Kampagnenzuordnung für Apps für Apple-Plattformen erfassen möchten, müssen Sie das AdSupport-Framework zu Ihrem Projekt hinzufügen.

Log-Ereignisse

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

Vordefinierte Ereignisse

Das Analytics SDK enthält eine Reihe empfohlener Ereignisse, die in verschiedenen Arten von Apps häufig vorkommen, z. B. in Einzelhandels- und E-Commerce-Apps, Reise-Apps und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und wann sie verwendet werden sollten, finden Sie unter Empfohlene Ereignisse.

Die Protokollierungsmethoden 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() protokollieren:

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

Das kann nützlich sein, wenn Sie zusätzliche Parameter angeben möchten, die nicht zu den vorgeschriebenen (erforderlichen) Parametern gehören. Sie können 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 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 die benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Verwenden Sie dazu Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen.

    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.

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

  • Parameternamen dürfen maximal 40 Zeichen lang sein und müssen mit einem Buchstaben beginnen. Sie dürfen nur alphanumerische Zeichen und Unterstriche enthalten. String- und Num-Typen werden unterstützt. String-Parameterwerte dürfen maximal 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 spezielle Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Ereignisse wie in diesem Beispiel gezeigt erfassen:

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

Standardereignisparameter festlegen

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

Wie bei benutzerdefinierten Parametern müssen Sie auch Standardereignisparameter registrieren, 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 der entsprechende 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 ein Parameter in der Methode logEvent() oder log angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.

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