Wie GA4-Event-Parameter die Details hinter jedem Event tragen

Was sind GA4-Event-Parameter?

Jedes Event, das Google Analytics 4 erfasst, trägt GA4-Event-Parameter, also die Schlüssel-Wert-Paare, die sagen, welcher Link geklickt wurde, wie viel ein Kauf wert war oder welches Produkt ein Besucher angesehen hat. In der deutschen GA4-Oberfläche heißen sie Ereignisparameter. Der Eventname sagt, was passiert ist. Die Parameter liefern die Details. Googles Entwicklerleitfaden fasst es in einem Satz zusammen: "Parameters provide additional information about the ways users interact with your website."

Googles Hilfe zieht dieselbe Trennung zwischen den drei Ebenen der GA4-Daten: "Events measure what users do on your website or app, like clicking a link or watching a video. Event parameters provide more details about these actions, like which link was clicked or how much of the video a user watched. User properties tell you more about the users themselves." Wenn das Event-Modell selbst neu für Sie ist, beginnen Sie mit Event-Tracking und kommen Sie für die Parameter-Ebene hierher zurück.

Welche Parameter erfasst GA4 ohne eigenen Code?

GA4 hängt an jedes Event in einem Web-Stream, auch an eigene Events, eine Reihe von Parametern, bevor Sie eine Zeile Tracking-Code schreiben. Googles Liste der Parameter, die "collected by default with every event, including custom events" sind, nennt für Web-Streams language, page_location, page_referrer, page_title und screen_resolution. GA4 erzeugt außerdem ga_session_id und ga_session_number mit jeder Sitzung und sendet engagement_time_msec mit Events wie user_engagement und page_view.

Empfohlene Events fügen eine zweite Stufe hinzu: Parameter, die Google bereits benannt und mit vordefinierten Reports verbunden hat. Das Event purchase ist das, was die meisten Teams nutzen:

Googles Referenz ergänzt eine Regel, deren Missachtung Umsatzreports kaputt macht: "If you set value then currency is required for revenue metrics to be computed accurately." Parameter an automatisch erfassten Events und an empfohlenen Events füllen vordefinierte Dimensionen und Messwerte. Alles, was Sie selbst erfinden, tut das nicht.

Wie senden Sie einen eigenen Event-Parameter?

Sie senden einen eigenen Event-Parameter, indem Sie ihn als Schlüssel-Wert-Paar in das dritte Argument des Aufrufs gtag('event', ...) einfügen. Googles Leitfaden gibt die Struktur als gtag('event', '<event_name>', {<event_parameters>}); an, mit diesem Beispiel:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

Hier sind app_name und screen_name die Parameternamen, und myAppName und Home sind die Werte. Um einen Parameter an jedes Event auf einer Seite zu hängen, setzen Sie ihn stattdessen in den Befehl config, etwa gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google rät bei eigenen Werten von der dritten Option ab: "The set command may not reliably propagate custom parameters to all Google Analytics measurement streams." Nutzen Sie event oder config für alles, was Sie selbst definiert haben.

Prüfen Sie das Ergebnis im Realtime-Report oder in DebugView. Google formuliert es so: "These reports show data as it arrives." DebugView listet auf dem Tab Parameters des Events den zusammengeführten Satz auf, einschließlich global gesetzter Werte.

Warum erscheint ein eigener Parameter nicht in den GA4-Reports?

Ein eigener Parameter erscheint nicht in den GA4-Reports, weil Google erst dann darüber berichtet, wenn Sie ihn als benutzerdefinierte Dimension oder benutzerdefinierten Messwert registriert haben. Der Entwicklerleitfaden sagt es unverblümt: "Without this registration, the parameter data is collected but isn't available for reporting." Realtime und DebugView zeigen den Rohwert, und deshalb kann ein Parameter im Test gut aussehen und eine Woche später trotzdem in jeder Exploration fehlen.

Die Registrierung ist eine Sache von zwei Minuten in der Admin-Ansicht. Googles Hilfeseite nennt die Schritte:

1. Klicken Sie in Admin unter Data display auf Custom definitions.
2. Öffnen Sie den Tab Custom dimensions und klicken Sie auf Create custom dimensions.
3. Geben Sie einen Dimension name ein. Google erlaubt hier Unterstriche und Leerzeichen, aber keine Bindestriche.
4. Setzen Sie Scope auf Event.
5. Geben Sie unter Event parameter den Parameternamen genau so ein, wie Ihr Code ihn sendet.
6. Klicken Sie auf Save.

Zwei Felder lassen sich nicht rückgängig machen. Google markiert sowohl Scope als auch Event parameter mit "You can't change this field after you save the new dimension." Ein Tippfehler im Parameternamen bedeutet, dass Sie die Dimension löschen und neu anlegen müssen. Nach dem Speichern können Sie die Dimension laut Google zu Reports hinzufügen "after 24-48 hours from when the custom data was sent and the custom dimension was created." In diesem Zeitfenster ist die Dimension eine der dokumentierten Ursachen für (not set) in GA4. Googles Seiten sagen nichts darüber, ob Werte nachträglich übernommen werden, die vor dem Anlegen der Dimension erfasst wurden, also registrieren Sie die Dimension an dem Tag, an dem Sie den Parameter ausliefern.

Zahlen nehmen einen anderen Weg. Ein Parameter, der eine Menge misst, etwa angesehene Sekunden oder Artikel im Warenkorb, gehört in einen benutzerdefinierten Messwert. Für Kategorien schreibt Google, bei "categorical data, however, such as what text was clicked or which page was viewed, it's more appropriate to use an event-scoped custom dimension."

Welche Limits gelten für GA4-Event-Parameter?

GA4-Event-Parameter sind auf 25 pro Event, 40 Zeichen pro Name und 100 Zeichen pro Wert begrenzt, und Google protokolliert nichts, was über diese Grenzen geht. Die Seite zu den Erfassungslimits sagt: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

Google sagt, dass ein Upgrade auf Analytics 360 es erlaubt, "increase certain limits (but not event/parameter character limits)", die Längen für Namen und Werte bleiben also auf jeder Property gleich. Für die meisten Websites ist das bindende Limit die Zahl von 50 eventbezogenen benutzerdefinierten Dimensionen und nicht die 25 Parameter pro Event, weil jede Dimension einen Parameternamen über alle Events abdeckt, die ihn senden. Auch das Erreichen der Dimensionsgrenze hat Folgen: Google sagt "you'll need to wait 48 hours after deleting dimensions to add new ones."

Welche Parameternamen reserviert GA4?

GA4 reserviert fünf Präfixe und eine Liste von Namen für Event-Parameter, und ein reservierter Name kann keine benutzerdefinierte Dimension stützen. Googles Benennungsregeln sagen, dass Parameternamen nicht mit einem Unterstrich, firebase_, ga_, google_ oder gtag. beginnen dürfen ("can't begin with"). Die für benutzerdefinierte Dimensionen und Messwerte reservierten Namen sind cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id und userid.

Bei Events zählt die Groß- und Kleinschreibung, und dieselbe Gewohnheit ist auch für Parameter sicher. Googles Regeln sagen "Event names are case sensitive. For example, my_event and My_Event are distinct events." Wählen Sie einen Stil, etwa Snake Case in Kleinbuchstaben, und behalten Sie ihn für Events und Parameter bei, damit Plan und plan nie als zwei Spalten enden.

Was sollte nie als Event-Parameter gesendet werden?

Personenbezogene Daten und eindeutige Kennungen sollten nie als GA4-Event-Parameter gesendet werden. Googles Richtlinie verlangt, dass "no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", mit E-Mail-Adressen, privaten Mobilfunknummern und Sozialversicherungsnummern als Beispielen. Das übliche Leck ist ein Formularwert oder ein URL-Query-String, der in einen Parameter kopiert wird, was der Abschnitt zu Events und Parametern in wie Google Analytics Nutzerdaten erfasst durchgeht.

Eindeutige Werte verursachen ein zweites Problem, auch wenn sie nicht personenbezogen sind. Google rät Standard-Properties, keine "unnecessary high-cardinality custom dimensions" anzulegen, und nennt drei Beispiele: eine eindeutige ID pro Nutzer, eine eindeutige ID pro Sitzung und einen Zeitstempel. Solche Dimensionen "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." Senden Sie Kategorien wie plan: pro oder method: google, keine Werte, die bei jedem Hit anders sind.

Eine Parsing-Regel erwischt viele Teams. Google warnt, dass "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text", sodass ein Textwert "94E40" als wissenschaftliche Notation gelesen wird. Stellen Sie Codes, die numerisch aussehen, ein Präfix voran, etwa sku_94E40, damit sie Text bleiben.

Wie geht Flowsery mit eigenen Event-Daten um?

Flowsery erfasst ein eigenes Event mit einem einzigen Aufruf wie window.flowsery("signup"), ohne Tag Manager und ohne Registrierung einer benutzerdefinierten Dimension zwischen Code und Dashboard. Sein Ziel- und Event-Tracking deckt Button-Klicks, Formularübermittlungen, Datei-Downloads und Videowiedergaben ab, lässt Sie Umsatzwerte an Events hängen und zeigt jedes Event in einem Echtzeit-Feed, sobald es feuert, sodass Sie das Tracking in dem Moment prüfen, in dem Sie es ausliefern. Events werden ohne Cookies und ohne personenbezogene Daten erfasst. Wenn Sie einen Event-Plan aus GA4 umziehen, zeigt der Vergleich eigenes Event-Tracking in datenschutzfreundlicher Analytics und GA4, welche GA4-Gewohnheiten Sie unterwegs ablegen sollten.

Häufig gestellte Fragen

Wie viele Event-Parameter kann ein GA4-Event haben?

Ein GA4-Event kann auf einer Standard-Property 25 Event-Parameter tragen. Google protokolliert keine Parameter über dieses Limit hinaus, sodass die zusätzlichen Werte nie in Reports ankommen. Analytics 360 hebt einige Limits an, aber nicht die Grenzen von 40 Zeichen für Namen und 100 Zeichen für Werte.

Warum sehe ich meinen Parameter in DebugView, aber nicht in den Reports?

DebugView und Realtime zeigen Rohparameter, sobald sie ankommen, während Standardreports und Explorations nur eigene Parameter zeigen, die Sie als benutzerdefinierte Dimensionen oder Messwerte registriert haben. Registrieren Sie den Parameter unter Admin, Custom definitions, und rechnen Sie dann mit 24 bis 48 Stunden, bis die Daten erscheinen.

Was ist der Unterschied zwischen einem Event-Parameter und einer benutzerdefinierten Dimension?

Ein Event-Parameter ist das Schlüssel-Wert-Paar, das Ihr Code mit einem Event sendet. Eine benutzerdefinierte Dimension ist das Report-Feld, das Sie in GA4 anlegen und das einen Parameternamen über alle Events liest, die ihn senden. Eine eventbezogene benutzerdefinierte Dimension deckt einen Parameter auf beliebig vielen Events ab.

Gelten benutzerdefinierte Dimensionen für Daten, die vor ihrem Anlegen erfasst wurden?

Googles Hilfeseiten sagen nicht, dass benutzerdefinierte Dimensionen frühere Daten nachträglich füllen. Sie sagen, dass Sie eine Dimension 24 bis 48 Stunden nach dem Senden der Daten und dem Anlegen der Dimension nutzen können. Registrieren Sie die Dimension an dem Tag, an dem der Parameter live geht, um eine Lücke zu vermeiden.

Kann ich eine User-ID als Event-Parameter senden?

Registrieren Sie eine User-ID nicht als eventbezogene benutzerdefinierte Dimension. user_id steht auf Googles Liste reservierter Namen, und Google nennt eine eindeutige ID pro Nutzer als Dimension mit hoher Kardinalität, die Sie vermeiden sollten. Google verweist für diesen Fall stattdessen auf seine Funktion User-ID.

Was passiert mit einem Parameterwert, der länger als 100 Zeichen ist?

GA4 protokolliert keinen Parameterwert, der das Limit für diesen Parameter überschreitet. Das Limit liegt für die meisten Parameter bei 100 Zeichen, mit Ausnahmen von 300 für page_title, 420 für page_referrer und 1,000 für page_location. Kürzen Sie lange Werte oder ordnen Sie sie kurzen Kategorien zu, bevor Sie sie senden.

Kann ich den gtag-Befehl set nutzen, um einen eigenen Parameter zu senden?

Google rät davon ab. Der Befehl set überträgt eigene Parameter möglicherweise nicht zuverlässig an alle Google-Analytics-Messstreams. Senden Sie eigene Werte stattdessen über event oder config, die beiden Befehle, die Google dafür empfiehlt.

Wie viele eigene Parameter kann ein E-Commerce-Item tragen?

Die Limit-Tabelle begrenzt eigene Parameter auf Item-Ebene auf 27 pro E-Commerce-Event, zusätzlich zu den von GA4 bereits vorgeschriebenen Item-Parametern wie item_id und item_name. Dieses Limit steht unabhängig vom Deckel von 25 Parametern pro Event.

Darf der Name einer benutzerdefinierten Dimension einen Bindestrich enthalten?

Googles Regel im Verwaltungsbereich erlaubt Unterstriche und Leerzeichen im Namen einer benutzerdefinierten Dimension, aber keine Bindestriche. Bleiben Sie bei Buchstaben, Zahlen, Unterstrichen und Leerzeichen, um beim Speichern einen Validierungsfehler zu vermeiden.

Was passiert, wenn ich eine benutzerdefinierte Dimension versehentlich lösche?

Die Wartezeit gilt, sobald Sie das Limit für benutzerdefinierte Dimensionen erreicht haben. Googles Hinweis lautet: "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." Sind alle 50 eventbezogenen Plätze belegt und Sie löschen die falsche Dimension, um Platz zu schaffen, vergehen zwei Tage, bevor Sie sie neu anlegen können.