GA4-eventparameters met Google Tag Manager

Een event vertelt je dat er iets gebeurde: er werd een formulier verstuurd, er werd een pakket gekozen. Eventparameters vertellen je welk formulier en welk pakket. Zonder parameters kan GA4 tellen, maar niet verklaren. Deze gids zet parameters met Google Tag Manager van begin tot eind op: de datalaag, de variabelen, de GA4 Event-tag, parameters voor elk event, ze registreren voor rapporten, de limieten en de controles. Aan het eind: wat mensen meestal bedoelen met "event parameter matching", en wat er verandert in een servercontainer.

Onderdeel van de GA4-handleiding. Je hebt GA4 nodig, geïnstalleerd via Tag Manager; is dat nog niet zo, doe dat dan eerst.

Wat een eventparameter is

Een parameter is een naam en een waarde die met een event worden meegestuurd, zoals form_name: contact bij een generate_lead event. GA4 verzamelt er zelf een paar (page_location, page_title, link_url bij uitgaande klikken), en aanbevolen events hebben aanbevolen parameters, zoals purchase met value, currency en items. Die vullen de ingebouwde dimensies van GA4 zonder extra instellingen.

Parameters die je zelf bedenkt, zoals form_name of lead_type, worden verzameld zodra je ze verstuurt, maar verschijnen pas in rapporten als je ze registreert als custom dimension of custom metric. Bij die extra stap gaat het bij de meeste setups mis.

1Push de waarden naar de datalaag

De schoonste bron voor een parameter is de datalaag: je site of formuliertool pusht de waarden op het moment dat het event plaatsvindt.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'generate_lead',
  form_name: 'contact',
  lead_type: 'quote'
});

De event key is waar een Tag Manager-trigger op luistert; de andere keys worden parameters. Spreek de namen af voordat iemand code schrijft: kleine letters, underscores, beginnend met een letter. Een custom dimension is gekoppeld aan de exacte parameternaam, dus form_name en formName zijn twee verschillende dingen.

2Lees ze uit met Data Layer Variables

Ga in Tag Manager naar Variables › User-Defined Variables › New en kies Data Layer Variable. Vul de key in, bijvoorbeeld form_name, en laat Data Layer Version 2 staan, die punten leest als nesting (ecommerce.value reikt in een object). Geef hem een naam die je terugvindt, zoals DLV · form_name, en maak er een per waarde.

3Voeg de parameters toe aan de GA4 Event-tag

Maak een trigger: Triggers › New › Custom Event, eventnaam generate_lead. Ga daarna naar Tags › New en kies Google Analytics: GA4 Event.

• Measurement ID: je G-ID, het liefst uit een Constant-variabele.
• Event Name: generate_lead. Gebruik de naam die Google aanbeveelt als er een past.
• Event Parameters: voeg met Add parameter een rij toe voor elke waarde: form_name met {{DLV · form_name}}, lead_type met {{DLV · lead_type}}.

Koppel de trigger en sla op. Omdat de tag vuurt op de push zelf, staan de waarden in de datalaag op het moment dat de tag ze uitleest.

4Parameters voor elk event: de Event Settings-variabele

Sommige parameters horen bij alles: een paginatype, een ingelogde status, de taal van de site. Zet ze in één variabele in plaats van in elke tag. Ga naar Variables › New, kies Google Tag: Event Settings, voeg per parameter een rij toe en sla de variabele op als GA4 · Event settings. Kies daarna waar hij geldt:

• Op elk event: open je Google-tag (in containers met de nieuwe tagtypes van Google: de Google Analytics-tag) en kies de variabele onder Shared event settings.
• Op gekozen events: open een GA4 Event-tag en kies hem onder Event Settings Variable.

Een tag kan een overgeërfde parameter voor zichzelf overschrijven, maar het blijft overzichtelijk als elke parameter op één plek wordt ingesteld. De gids over content groups gebruikt dit patroon voor content_group.

5Registreer custom dimensions in GA4

Ga in GA4 naar Admin › Data display › Custom definitions, open het tabblad Custom dimensions en klik op Create custom dimension.

• Dimension name: wat rapporten tonen, zoals "Formuliernaam". Spaties en underscores mogen, streepjes niet.
• Scope: Event voor eventparameters. User scope is voor user properties, item scope voor parameters binnen items.
• Event parameter: de exacte parameternaam, form_name.

Scope en event parameter kun je na het opslaan niet meer wijzigen. Volgens Google verschijnt de data 24 tot 48 uur nadat de dimensie is aangemaakt en de data is verstuurd, en pas vanaf dat moment; registreer dus eerst en publiceer de container daarna. Eén dimensie dekt de parameter bij elk event dat hem verstuurt. Getallen die je wilt optellen of middelen, zoals een leadscore, horen in een custom metric.

6Controleer in Tag Assistant en DebugView

Klik op Preview in Tag Manager, trigger het event en controleer in Tag Assistant dat de GA4 Event-tag vuurde met de waarden die je verwacht. Tag Assistant zet de browser in debugmodus, dus het event verschijnt ook in GA4 onder Admin › Data display › DebugView binnen enkele seconden; klik erop om elke parameter te zien. Een parameter die wel in DebugView staat maar een paar dagen later niet in rapporten, is bijna altijd niet geregistreerd, of geregistreerd met een andere spelling.

De limieten die ertoe doen

Limiet	Standard	GA4 360
Parameters per event	25	Niet apart vermeld
Lengte van eventnaam en parameternaam	40 tekens	40 tekens
Lengte van een parameterwaarde	100 tekens (page_title 300, page_referrer 420, page_location 1.000)	Gelijk
Custom dimensions met event-scope	50	125
Custom dimensions met user-scope	25	100
Custom dimensions met item-scope	10	25
Custom metrics	50	125

Tekenlimieten kun je niet verhogen, ook niet op 360. Parameternamen mogen niet beginnen met _, firebase_, ga_, google_ of gtag., en een paar namen (user_id, session_id, gclid, currency en andere) kun je niet als custom dimension registreren. Verwijder je een dimensie terwijl je op de limiet zit, dan laat Google je 48 uur wachten op de vrije plek; registreer dus alleen waarover je gaat rapporteren.

Veelgemaakte fouten

• Niet registreren, of te laat registreren. De parameter staat in DebugView en nergens anders, en de weken vóór de registratie blijven leeg.
• Unieke waarden als dimensie. Order-ID's of tijdstempels leveren duizenden rijen op die GA4 samenvoegt onder "(other)".
• Persoonsgegevens in parameters. Google staat geen persoonlijk identificeerbare gegevens toe in Analytics, zoals e-mailadressen. Via formuliervelden en zoektermen sluipen ze erin.
• Vuren voordat de data er is. Een tag op een klik- of paginaweergavetrigger kan de datalaag uitlezen vóór de push; trigger op het eigen event van de push.
• Eén parameter, twee plekken. Ingesteld in de Event Settings-variabele én op de tag, met verschillende waarden. Kies er één.

Wat "event parameter matching" meestal betekent

GA4 heeft geen functie met die naam, maar er gaan drie dingen onder die naam.

Matching conditions in GA4. Onder Admin › Data display › Events, Modify event en Create event gebruiken matching conditions op de parameters van een event, zoals event_name equals form_submit en form_id equals contact; alle voorwaarden moeten kloppen. Een property kan 50 aangepaste en 50 aangemaakte events hebben, geen van beide werkt met terugwerkende kracht op historische data, en Measurement Protocol-events kun je niet aanpassen. De gids over key events heeft een uitgewerkt voorbeeld.

Triggervoorwaarden in Tag Manager. Een trigger kan alleen vuren bij een bepaalde waarde, zoals {{DLV · lead_type}} equals quote. In een servercontainer doet een variabele van het type Event Data met de parameternaam als Key Path hetzelfde.

Event Match Quality bij Meta. Meta geeft elk serverevent in Events Manager een score van 0 tot 10 voor hoe goed de klantgegevens (e-mail, telefoon, IP-adres en meer) aan een Meta-account te koppelen zijn. Dat gaat over klantgegevens, niet over GA4-parameters; zie de gids over de Meta Conversions API.

Eventparameters via een servercontainer

Niets in deze setup verandert als GA4 via een servercontainer loopt. De parameters reizen mee in de GA4-hit naar je eigen tagging-domein, de GA4-client zet elk ervan om in event data, en de GA4-tag van Google stuurt ze door. Custom dimensions registreer je in de property, zoals in stap 5.

Wat je wint is een tweede plek om ze te gebruiken. Elke servertag kan een parameter uitlezen via een Event Data-variabele, dus de lead_type die je één keer hebt opgebouwd, kan ook naar Meta of Google Ads, en een transformation kan een parameter verwijderen voordat die je server verlaat. Met Measurebase voegt Data Enrichment locatie- en apparaatheaders toe die je als GA4-parameters kunt meesturen, en de tracking-audit laat je weten wanneer je container een parameter verstuurt die niet geregistreerd is. Hits naar je eigen domein komen langs de domeinlijsten van adblockers, en met Enhanced Ad Blocker Protection ook langs hun padregels, dus de parameters van meer bezoekers bereiken GA4.

Veelgestelde vragen