Woordenlijst

Hoe eventparameters in GA4 de details achter elk event meedragen

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •8 min leestijd
Hoe eventparameters in GA4 de details achter elk event meedragenHoe eventparameters in GA4 de details achter elk event meedragen

TL;DR, kort antwoord

8 min leestijd

Eventparameters in GA4 zijn de sleutel-waardeparen die met elk event in Google Analytics 4 worden meegestuurd, zoals op welke link werd geklikt of wat een aankoop waard was. Google staat er 25 per event toe, met namen tot 40 tekens en waarden tot 100. Een aangepaste parameter wordt verzameld zodra de code hem verstuurt, maar volgens Google "isn't available for reporting" totdat je hem als aangepaste dimensie of statistiek registreert, en rapporten tonen hem 24 tot 48 uur daarna.

Wat zijn eventparameters in GA4?

Elk event dat Google Analytics 4 vastlegt, draagt eventparameters mee: de sleutel-waardeparen die zeggen op welke link werd geklikt, wat een aankoop waard was of welk product een bezoeker bekeek. De eventnaam zegt wat er gebeurde. De parameters geven de details. De ontwikkelaarsgids van Google zegt het in één regel: "Parameters provide additional information about the ways users interact with your website."

Het helpcentrum van Google maakt dezelfde verdeling tussen de drie lagen van GA4-data: "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." Ben je nieuw met het eventmodel zelf, begin dan bij eventtracking en kom hier terug voor de laag met parameters.

Welke parameters verzamelt GA4 zonder code?

GA4 hangt een set parameters aan elk event op een webstream, ook aan aangepaste events, nog voordat je één regel trackingcode schrijft. De lijst van Google met parameters die "collected by default with every event, including custom events" zijn, noemt voor webstreams language, page_location, page_referrer, page_title en screen_resolution. GA4 genereert ook ga_session_id en ga_session_number bij elke sessie en verstuurt engagement_time_msec met events zoals user_engagement en page_view.

Aanbevolen events voegen een tweede laag toe: parameters die Google al heeft benoemd en aan vooraf gedefinieerde rapporten heeft gekoppeld. Het event purchase is het event dat de meeste teams gebruiken:

ParameterTypeVerplicht volgens Google
transaction_idstringJa
valuenumberJa
currencystringJa
itemsarray met itemsJa
couponstringNee
shippingnumberNee
taxnumberNee

De referentie van Google voegt een regel toe die omzetrapporten breekt als je hem negeert: "If you set value then currency is required for revenue metrics to be computed accurately." Parameters op automatisch verzamelde events en op aanbevolen events vullen vooraf gedefinieerde dimensies en statistieken. Alles wat je zelf verzint, doet dat niet.

Een ontwikkelaar typt code op een laptop, vergelijkbaar met het met de hand schrijven van een gtag-eventaanroep.

Hoe verstuur je een aangepaste eventparameter?

Je verstuurt een aangepaste eventparameter door hem als sleutel-waardepaar toe te voegen aan het derde argument van de aanroep gtag('event', ...). De gids van Google geeft de structuur als gtag('event', '<event_name>', {<event_parameters>}); met dit voorbeeld:

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

Hier zijn app_name en screen_name de parameternamen, en myAppName en Home de waarden. Wil je een parameter aan elk event op een pagina hangen, zet hem dan in het commando config, zoals in gtag('config', 'G-XXXXXXXXXX', {'page_title': 'Contact Us', 'currency': 'EUR'}). Google waarschuwt tegen de derde optie voor aangepaste waarden: "The set command may not reliably propagate custom parameters to all Google Analytics measurement streams." Gebruik event of config voor alles wat je zelf hebt bedacht.

Controleer het resultaat in het Realtime-rapport of DebugView. Volgens Google "These reports show data as it arrives." DebugView toont de samengevoegde set, inclusief globaal toegepaste waarden, op het tabblad Parameters van het event.

Waarom verschijnt een aangepaste parameter niet in GA4-rapporten?

Een aangepaste parameter verschijnt niet in GA4-rapporten omdat Google er pas over rapporteert nadat je hem als aangepaste dimensie of statistiek hebt geregistreerd. De ontwikkelaarsgids zegt het botweg: "Without this registration, the parameter data is collected but isn't available for reporting." Realtime en DebugView tonen de ruwe waarde, en daarom kan een parameter er bij het testen prima uitzien en een week later toch in elke verkenning ontbreken.

Registreren is een klus van twee minuten in het beheerscherm. De helppagina van Google noemt de stappen:

  1. Klik in Admin onder Data display op Custom definitions.
  2. Open het tabblad Custom dimensions en klik op Create custom dimensions.
  3. Vul een Dimension name in. Google staat hier underscores en spaties toe, maar geen koppeltekens.
  4. Zet Scope op Event.
  5. Typ bij Event parameter de parameternaam precies zoals je code hem verstuurt.
  6. Klik op Save.

Twee velden kun je niet terugdraaien. Google markeert zowel Scope als Event parameter met "You can't change this field after you save the new dimension." Een typfout in de parameternaam betekent de dimensie verwijderen en opnieuw aanmaken. Na het opslaan kun je de dimensie volgens Google aan rapporten toevoegen "after 24-48 hours from when the custom data was sent and the custom dimension was created." In die periode valt de dimensie onder een van de gedocumenteerde oorzaken van (not set) in GA4. De pagina's van Google zeggen niets over het achteraf invullen van waarden die zijn verzameld voordat de dimensie bestond, dus registreer de dimensie op de dag dat je de parameter live zet.

Getallen volgen een ander pad. Een parameter die een hoeveelheid meet, zoals bekeken seconden of items in een winkelwagen, hoort in een aangepaste statistiek. De regel van Google is dat het voor "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."

Van aangepaste parameter naar zichtbaar rapport
1
Verstuur hem. De code voegt de parameter toe aan een gtag-eventaanroep.
2
Verzameld, niet rapporteerbaar. Google legt de waarde vast, maar houdt hem buiten rapporten.
3
Registreer hem. Maak een aangepaste dimensie of statistiek aan in Admin, Custom definitions.
4
Wacht. Reken op 24 tot 48 uur na de registratie voordat de data bijgewerkt is.
5
Controleer het rapport. De dimensie is nu beschikbaar in verkenningen en standaardrapporten.
Een aangepaste parameter verschijnt vanaf de eerste hit in DebugView, maar heeft registratie en wachttijd nodig voordat hij een rapport bereikt.

Welke limieten gelden voor eventparameters in GA4?

Eventparameters in GA4 zijn beperkt tot 25 per event, 40 tekens per naam en 100 tekens per waarde, en Google legt niets vast wat boven die limieten uitkomt. De pagina over verzamellimieten zegt: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

LimietStandaardproperty
Parameters per event25
Lengte van de parameternaam40 tekens
Lengte van de parameterwaarde100 tekens
Waarde van page_title300 tekens
Waarde van page_referrer420 tekens
Waarde van page_location1.000 tekens
Aangepaste parameters op itemniveau per e-commerce-event27, bovenop de voorgeschreven itemparameters
Aangepaste dimensies op eventniveau50 (125 bij Analytics 360)
Aangepaste statistieken50 (125 bij Analytics 360)

Google zegt dat je met een upgrade naar Analytics 360 kunt "increase certain limits (but not event/parameter character limits)", dus de lengtes van namen en waarden blijven op elke property hetzelfde. De bindende limiet voor de meeste sites is de 50 aangepaste dimensies op eventniveau, niet de 25 parameters per event, omdat elke dimensie één parameternaam dekt over elk event dat hem verstuurt. De dimensielimiet bereiken kost ook iets: Google zegt dat "you'll need to wait 48 hours after deleting dimensions to add new ones."

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Welke parameternamen reserveert GA4?

GA4 reserveert vijf voorvoegsels en een lijst met namen voor eventparameters, en een gereserveerde naam kan niet achter een aangepaste dimensie staan. De naamgevingsregels van Google zeggen dat parameternamen "can't begin with" een underscore, firebase_, ga_, google_ of gtag.. De namen die gereserveerd zijn voor aangepaste dimensies en statistieken zijn cid, currency, customer_id, customerid, dclid, gclid, session_id, sessionid, sfmc_id, sid, srsltid, uid, user_id en userid.

Hoofdletters tellen bij events, en dezelfde gewoonte is veilig voor parameters. De regels van Google stellen: "Event names are case sensitive. For example, my_event and My_Event are distinct events." Kies één stijl, zoals snake case in kleine letters, en houd die aan voor zowel events als parameters, zodat Plan en plan nooit als twee kolommen eindigen.

Papieren documenten die op kantoor worden versnipperd, als beeld van de discipline om persoonsgegevens uit trackingaanroepen te houden.

Wat mag je nooit als eventparameter versturen?

Persoonsgegevens en unieke identificatoren mag je nooit als eventparameters in GA4 versturen. Het beleid van Google zegt dat "no data be passed to Google that Google could use or recognize as personally identifiable information (PII)", met e-mailadressen, persoonlijke mobiele nummers en burgerservicenummers als voorbeelden. Het gebruikelijke lek is een formulierwaarde of een querystring uit een URL die in een parameter wordt gekopieerd, en dat behandelt het deel over events en parameters in hoe Google Analytics gebruikersdata verzamelt.

Unieke waarden veroorzaken een tweede probleem, ook als ze niet persoonlijk zijn. Google zegt tegen standaardproperty's dat ze geen "unnecessary high-cardinality custom dimensions" moeten aanmaken en geeft drie voorbeelden: een unieke ID per gebruiker, een unieke ID per sessie en een tijdstempel. Zulke dimensies "may negatively impact your reports and explorations, and cause data to be condensed under the (other) row." Verstuur categorieën, zoals plan: pro of method: google, geen waarden die bij elke hit anders zijn.

Eén verwerkingsregel overvalt teams. Google waarschuwt dat "any value in a custom dimension that resembles a number will be treated as a number, even if it was originally formatted as text", dus een tekstwaarde "94E40" wordt als wetenschappelijke notatie gelezen. Zet een voorvoegsel voor codes die numeriek lijken, zoals sku_94E40, zodat ze tekst blijven.

Hoe gaat Flowsery om met data van aangepaste events?

Flowsery legt een aangepast event vast met één aanroep zoals window.flowsery("signup"), zonder tagmanager en zonder registratiestap voor aangepaste dimensies tussen de code en het dashboard. De doel- en eventtracking dekt klikken op knoppen, formulierinzendingen, bestandsdownloads en het afspelen van video's, laat je omzetwaarden aan events koppelen en toont elk event in een realtime eventfeed zodra het vuurt, zodat je de tracking controleert op het moment dat je hem live zet. Events worden gevolgd zonder cookies of persoonsgegevens. Verhuis je een eventplan uit GA4, dan behandelt de vergelijking in aangepaste eventtracking in privacyvriendelijke analyse vs GA4 welke GA4-gewoonten je onderweg loslaat.

Veelgestelde vragen

Hoeveel eventparameters kan een GA4-event hebben?

Een GA4-event kan op een standaardproperty 25 eventparameters meedragen. Google legt parameters boven die limiet niet vast, dus de extra waarden bereiken nooit een rapport. Analytics 360 verhoogt sommige limieten, maar niet de limieten van 40 tekens voor namen en 100 tekens voor waarden.

Waarom zie ik mijn parameter wel in DebugView maar niet in rapporten?

DebugView en Realtime tonen ruwe parameters zodra ze binnenkomen, terwijl standaardrapporten en verkenningen alleen aangepaste parameters tonen die je als aangepaste dimensies of statistieken hebt geregistreerd. Registreer de parameter onder Admin, Custom definitions, en reken dan op 24 tot 48 uur voordat de data verschijnt.

Wat is het verschil tussen een eventparameter en een aangepaste dimensie?

Een eventparameter is het sleutel-waardepaar dat je code met een event meestuurt. Een aangepaste dimensie is het rapportveld dat je in GA4 aanmaakt en dat één parameternaam leest over elk event dat hem verstuurt. Eén aangepaste dimensie op eventniveau dekt een parameter op zoveel events als je wilt.

Gelden aangepaste dimensies ook voor data die vóór het aanmaken is verzameld?

De helppagina's van Google zeggen niet dat aangepaste dimensies eerdere data achteraf invullen. Ze stellen dat je een dimensie kunt gebruiken 24 tot 48 uur nadat de data is verstuurd en de dimensie is aangemaakt. Registreer de dimensie op de dag dat de parameter live gaat om een gat te voorkomen.

Kan ik een gebruikers-ID als eventparameter versturen?

Registreer een gebruikers-ID niet als aangepaste dimensie op eventniveau. user_id staat op de gereserveerde lijst van Google, en Google noemt een unieke ID per gebruiker als dimensie met hoge kardinaliteit die je moet vermijden. Google verwijst voor dat geval naar de User-ID-functie.

Wat gebeurt er met een parameterwaarde van meer dan 100 tekens?

GA4 legt geen parameterwaarde vast die de limiet voor die parameter overschrijdt. De limiet is 100 tekens voor de meeste parameters, met uitzonderingen van 300 voor page_title, 420 voor page_referrer en 1.000 voor page_location. Kort lange waarden in of zet ze om naar korte categorieën voordat je ze verstuurt.

Kan ik het gtag-commando set gebruiken om een aangepaste parameter te versturen?

Google waarschuwt ertegen. Het commando set geeft aangepaste parameters mogelijk niet betrouwbaar door aan alle meetstreams van Google Analytics. Verstuur aangepaste waarden in plaats daarvan via event of config, de twee commando's die Google daarvoor aanbeveelt.

Hoeveel aangepaste parameters kan een e-commerce-item meedragen?

De limietentabel beperkt aangepaste parameters op itemniveau tot 27 per e-commerce-event, bovenop de itemparameters die GA4 al voorschrijft, zoals item_id en item_name. Die limiet staat los van de limiet van 25 parameters op het event zelf.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Mag de naam van een aangepaste dimensie een koppelteken bevatten?

De regel van Google in het beheerscherm staat underscores en spaties toe in de naam van een aangepaste dimensie, maar geen koppeltekens. Houd het bij letters, cijfers, underscores en spaties om een validatiefout bij het opslaan van de dimensie te voorkomen.

Wat gebeurt er als ik per ongeluk een aangepaste dimensie verwijder?

De wachttijd geldt zodra je de limiet voor aangepaste dimensies hebt bereikt. De opmerking van Google zegt: "If you hit the limit for custom dimensions, you'll need to wait 48 hours after deleting dimensions to add new ones." Zijn alle 50 plekken op eventniveau vol, dan kost het verwijderen van de verkeerde om ruimte te maken twee dagen voordat je hem opnieuw kunt aanmaken.

Was dit artikel nuttig?

Laat ons weten wat je ervan vindt!

Zie ons vaker in Google

Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.

Voordat je gaat...

Flowsery

Flowsery

Analytics voor je website, met omzet voorop

Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Gerelateerde begrippen

Wat aangepaste dimensies in GA4 doen, en de quota die ze begrenzenWat aangepaste dimensies in GA4 doen, en de quota die ze begrenzen
Woordenlijst

Wat aangepaste dimensies in GA4 doen, en de quota die ze begrenzen

Door aangepaste dimensies in GA4 te registreren worden je eventparameters rapportvelden. Bekijk de drie bereiken, de quota van 50, 25 en 10 en de valkuil van kardinaliteit.

•8 min leestijd
Wat er veranderde met key events en conversies in GA4Wat er veranderde met key events en conversies in GA4
Woordenlijst

Wat er veranderde met key events en conversies in GA4

Google splitste één woord in tweeën: key events en conversies in GA4 zijn nu verschillende objecten in Analytics en Ads. Wat ze betekenen en waar je ze terugziet.

•7 min leestijd
Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage isWaarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is
Woordenlijst

Waarom je GA4-bouncepercentage gewoon het omgekeerde engagementpercentage is

Je GA4-bouncepercentage is het aandeel sessies zonder engagement. Hoe Google het definieert, hoe het verschilt van Universal Analytics en waar je het toevoegt.

•7 min leestijd
Gebruikerseigenschappen in GA4 instellen en erover rapporterenGebruikerseigenschappen in GA4 instellen en erover rapporteren
Woordenlijst

Gebruikerseigenschappen in GA4 instellen en erover rapporteren

Stel gebruikerseigenschappen in GA4 in met gtag of Tag Manager, registreer ze als aangepaste dimensies op gebruikersniveau en blijf binnen de limiet van 25 eigenschappen.

•8 min leestijd
Hoe pagina's per sessie worden berekend en wat het zegt over een bezoekHoe pagina's per sessie worden berekend en wat het zegt over een bezoek
Woordenlijst

Hoe pagina's per sessie worden berekend en wat het zegt over een bezoek

In GA4 heet pagina's per sessie Views per session: pagina- en schermweergaven gedeeld door sessies. De formule, waar je hem vindt en hoe je hem leest.

•7 min leestijd
Wat klikregistratie op een website vastlegt, en welke klikken verloren gaanWat klikregistratie op een website vastlegt, en welke klikken verloren gaan
Woordenlijst

Wat klikregistratie op een website vastlegt, en welke klikken verloren gaan

Klikregistratie op een website legt vast op welk element een bezoeker klikte, op welke pagina en wanneer. Bekijk de drie methoden, de velden die je meestuurt en waarom sommige klikken verdwijnen.

•8 min leestijd

Gerelateerde artikelen