Was ist ein Ereignisparameter?
In Google Analytics 4 ist jede Interaktion ein Ereignis: ein Seitenaufruf, ein Klick, ein Download, ein Kauf. Das Ereignis allein ist aber dünn. file_download sagt dir nur, dass jemand etwas heruntergeladen hat.
Ein Ereignisparameter liefert das Detail dazu. Google beschreibt ihn als zusätzliche Information zu einer Nutzerinteraktion auf einer Website oder in einer App. Beim Download sind das zum Beispiel file_name und file_extension — also welche Datei und welches Format.
Technisch ist jeder Parameter ein Paar aus Name und Wert: links der Schlüssel, rechts sein Inhalt. Zum Beispiel form_name → „kontakt“.
Welche Parameter es gibt
Einen Teil der Parameter sammelt GA4 von selbst. Bei jedem Ereignis auf einer Website gehören dazu laut Google unter anderem page_location (die Adresse), page_referrer (die Seite davor), page_title, language und screen_resolution.
Die optimierte Analyse bringt eigene Parameter mit — etwa link_url und outbound bei Klicks auf fremde Seiten oder search_term bei der Suche auf deiner Website. Empfohlene Ereignisse wie purchase haben feste Parameter wie value, currency und items. Und für alles andere legst du eigene Parameter an.
Dazu kommen zwei Verwandte, die oft verwechselt werden:
- Nutzereigenschaft: gilt für eine Person über alle ihre Ereignisse hinweg, etwa „Bestandskunde“. Bis zu 25 pro Property.
- Artikelparameter: beschreiben einzelne Produkte im items-Array eines Kaufs, etwa Farbe oder Größe.
Warum du Parameter registrieren musst
Hier stolpern die meisten. Einen eigenen Parameter zu senden reicht nicht. Google sagt dazu klar: Ohne Registrierung werden die Daten zwar erfasst, stehen aber für Berichte nicht zur Verfügung. Du musst ihn als benutzerdefinierte Dimension (Text) oder benutzerdefinierte Metrik (Zahl) anlegen.
- In GA4 auf Verwaltung → Datenanzeige → Benutzerdefinierte Definitionen
- „Benutzerdefinierte Dimensionen erstellen“ wählen
- Name, Bereich (Ereignis, Nutzer oder Artikel) und den Namen des Parameters eintragen
- Speichern und 24 bis 48 Stunden warten, bis Daten in den Berichten auftauchen
Die Plätze sind begrenzt. In der kostenlosen Version von GA4 gelten diese Obergrenzen je Property:
Typ
Limit
Dimensionen, Ereignis
50
Dimensionen, Nutzer
25
Dimensionen, Artikel
10
Eigene Metriken
50
Dazu kommen Grenzen beim Senden: höchstens 25 Parameter je Ereignis, Parameternamen bis 40 Zeichen, Werte bis 100 Zeichen. Nur wenige automatische Parameter dürfen länger sein, page_location etwa bis 1.000 Zeichen. Die kostenpflichtige Version GA4 360 erlaubt mehr Dimensionen, an den Zeichengrenzen ändert sie nichts.
Beispiele aus der Praxis
So sieht das bei einer typischen KMU-Website aus. Jede Zeile ist ein Ereignis mit einem Parameter, den du später auswerten willst:
Ereignis
Parameter → Wert
file_download
file_name → preisliste.pdf
generate_lead
form_name → kontakt
video_progress
video_percent → 75
purchase
value → 89,90
Mit dem Parameter form_name siehst du plötzlich, ob Anfragen über das Kontaktformular kommen oder über den Rückruf-Wunsch. Ohne ihn hast du nur eine Zahl „Leads“ — und keine Ahnung, welches Formular arbeitet.
Häufige Fehler
Fehler 1 · Gesendet, aber nicht registriert
Der Klassiker. Im DebugView ist der Parameter zu sehen, im Bericht nicht. Die Daten sind da, du kommst nur nicht ran. Lösung: als Dimension registrieren — und ab dann zählt es.
Fehler 2 · Vorhandene Parameter doppelt anlegen
Viele Werte gibt es schon als Standard-Dimension, etwa Seite oder Transaktions-ID. Wer sie trotzdem registriert, verbraucht Plätze. Google rät ausdrücklich davon ab. Schau erst, ob es die Dimension schon gibt.
Fehler 3 · IDs und Zeitstempel als Dimension
Ein Parameter mit einem anderen Wert für jeden Nutzer oder jede Sitzung bläht die Berichte auf. Google warnt vor solcher hoher Kardinalität (sehr vielen verschiedenen Werten): Ein Teil landet dann in der Zeile „(other)“. Solche Werte gehören in den BigQuery-Export, nicht in den Standardbericht.
Fehler 4 · Wildwuchs bei den Namen
formName, form_name und Formular sind für GA4 drei verschiedene Parameter. Leg einmal fest, wie Parameter heißen, und halt dich dran — am besten nach Googles Schreibweise: klein, mit Unterstrich.
So gehst du vor
- Frage zuerst: Welche Entscheidung willst du mit dem Bericht treffen? Daraus ergibt sich der Parameter, nicht umgekehrt.
- Vorhandenes prüfen: Liefern automatische oder empfohlene Parameter das schon?
- Plan schreiben: Eine einfache Tabelle mit Ereignis, Parameter, Beispielwert und Bereich.
- Umsetzen: Im Google Tag Manager trägst du Parameter im GA4-Ereignis-Tag unter „Ereignisparameter“ ein, mit gtag.js als drittes Argument im event-Befehl.
- Testen: Im DebugView das Ereignis öffnen und die Parameter ansehen.
- Registrieren: als benutzerdefinierte Dimension oder Metrik, sofort beim Livegang.
Häufige Fragen
Warum sehe ich meinen Ereignisparameter nicht in den Berichten?
Meist fehlt die Registrierung. Eigene Parameter musst du in GA4 unter Benutzerdefinierte Definitionen als Dimension oder Metrik anlegen. Danach dauert es laut Google 24 bis 48 Stunden, bis Daten in Berichten erscheinen. Im DebugView siehst du sie dagegen sofort.
Wie viele Parameter darf ein Ereignis haben?
Bis zu 25 Parameter je Ereignis. Parameternamen dürfen höchstens 40 Zeichen lang sein, Werte höchstens 100 Zeichen. Einige automatische Parameter wie die Seitenadresse dürfen länger sein.
Was ist der Unterschied zwischen Ereignisparameter und Nutzereigenschaft?
Ein Ereignisparameter beschreibt eine einzelne Interaktion, etwa welches Formular abgeschickt wurde. Eine Nutzereigenschaft beschreibt die Person über alle Ereignisse hinweg, etwa ob sie Bestandskunde ist. Bei der Registrierung wählst du dafür den Bereich Ereignis oder Nutzer.
Sind UTM-Parameter auch Ereignisparameter?
Nein. UTM-Parameter hängen an der URL und sagen, woher ein Besuch kommt. GA4 liest sie aus und ordnet daraus Quelle und Medium zu. Ereignisparameter schickt dein Tracking mit einem Ereignis mit.
Welche Parameter erfasst GA4 automatisch?
Bei Websites unter anderem Seitenadresse, vorherige Seite, Seitentitel, Sprache und Bildschirmauflösung. Die optimierte Analyse ergänzt Parameter für Klicks, Suche, Downloads, Videos und Formulare. Diese brauchst du nicht selbst zu registrieren.
Quellen
- Google Analytics-Hilfe: Ereignisparameter
- Google Analytics-Hilfe: Limits bei der Datenerhebung
- Google Analytics-Hilfe: Benutzerdefinierte Dimensionen und Messwerte
- Google for Developers: Ereignisparameter senden
- Google Analytics-Hilfe: Benutzerdefinierte Dimensionen anlegen
- Google Analytics-Hilfe: Automatisch erfasste Ereignisse
