Log-Ereignisse

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


Einige Ereignisse werden in Analytics automatisch protokolliert. Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten erfassen muss, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App protokollieren. Es gibt keine Beschränkung für die Gesamtzahl der Ereignisse, die Ihre App protokolliert. Beachten Sie bei der Benennung von Ereignissen die Groß-/Kleinschreibung. Zwei Ereignisnamen, die sich nur bei der Groß-/Kleinschreibung unterscheiden, führen zu zwei unterschiedlichen Ereignissen.

Hinweis

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

Wenn Sie Kampagnenattributionsdaten für Apps auf Apple-Plattformen erfassen möchten, müssen Sie Ihrem Projekt das AdSupport-Framework hinzufügen.

Log-Ereignisse

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

Vordefinierte Ereignisse

Für den Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die in verschiedenen Arten von Apps häufig vorkommen, darunter Einzelhandels- und E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie unter Empfohlene Ereignisse.

Die Logmethoden 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ätzlich zu den vorgeschriebenen (erforderlichen) Parametern weitere 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. Benutzerdefinierte Dimensionen können für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für alle Parameterdaten verwendet werden, die sich besser numerisch darstellen lassen. 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 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 Google Analytics 4 BigQuery Export.

  • value-Parameter: Ein allgemeiner Parameter, der nützlich ist, um einen wichtigen Messwert zu erfassen, der sich auf ein Ereignis bezieht. Beispiele hierfür sind Umsatz, Entfernung, Zeit und Punkte.

  • Parameternamen können bis zu 40 Zeichen lang sein, müssen mit einem Buchstaben beginnen und dürfen nur alphanumerische Zeichen und Unterstriche enthalten. Die Typen „String“ und „Num“ werden unterstützt. Stringparameterwerte können bis zu 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 bestimmte 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 ereignisübergreifend protokollieren. Standardparameter werden 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 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 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.