Log-Ereignisse

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


Analytics protokolliert einige Ereignisse für Sie automatisch. Sie müssen keinen Code hinzufügen, um diese Ereignisse zu erhalten. Wenn Sie zusätzliche Daten benötigen, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App erfassen. Es gibt keine Begrenzung für die Gesamtzahl 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 Einführung in Analytics beschrieben.

Wenn Sie Daten zur Kampagnenattribution für Apps auf Apple-Plattformen erfassen möchten, stellen Sie sicher, das AdSupport-Framework zu Ihrem Projekt hinzuzufügen.

Ereignisse protokollieren

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

Vordefinierte Ereignisse

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

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

Im folgenden Beispiel wird gezeigt, wie Sie ein select_content-Ereignis protokollieren:

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 in Analytics-Berichten als Dimensionen oder Messwerteverwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für alle Parameterdaten verwenden, die besser numerisch dargestellt werden. 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. Gehen Sie dazu zu 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 Google Analytics 4 BigQuery Export.

  • value -Parameter: Ein allgemeiner Parameter, mit dem Sie einen wichtigen Messwert für ein Ereignis erfassen können. 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. Die Typen „String“ und „Num“ werden unterstützt. String-Parameterwerte dürfen maximal 100 Zeichen lang sein. Die Präfixe „firebase“, „google“ und „ga_“ sind reserviert und dürfen nicht für Parameternamen verwendet werden.

Benutzerdefinierte Ereignisse

Wenn Ihre Anwendung spezielle Anforderungen hat, die von einem empfohlenen Ereignistyp nicht abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse protokollieren, wie in diesem Beispiel:

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

Standardereignisparameter festlegen

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

Wie bei benutzerdefinierten Parametern müssen Sie auch Standardereignisparameter registrieren, damit sie in Analytics-Berichten angezeigt werden.

Gültige Parameterwerte sind „String“ und „Num“. Wenn Sie den Wert eines Schlüssels auf null setzen, wird der 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 logEvent() oder log- Methode 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.