TL;DR, kort antwoord
9 min leestijdGoogle Analytics 4 legt eventnamen beperkingen op nog voordat de smaak van je team dat doet. Namen "must start with a letter", mogen "only letters, numbers, and underscores" gebruiken, mogen geen spaties bevatten en zijn hoofdlettergevoelig, dus "my_event and My_Event are distinct events". Gereserveerde namen zoals page_view, scroll, session_start en file_download worden direct geweigerd, en Analytics "will display an error message". Namen mogen 40 tekens lang zijn, en een event van meer dan 40 tekens kan geen belangrijke gebeurtenis worden, omdat "the appended _c will be missing". De eigen aanbevolen events van Google zetten de actie voorop, add_to_cart en view_item, wat ingaat tegen het object_action-advies van de meeste stijlgidsen. Later hernoemen is beperkt tot 50 aangepaste events en geldt, in de woorden van Google, "do not apply to historical data".
Waarom doet een naamgevingsconventie voor events ertoe?
Een naamgevingsconventie voor events kiezen is op dag één goedkoop en op dag tweehonderd duur, omdat Google Analytics 4 een hernoeming nooit toepast op data die het al heeft verzameld. Elke inconsistente naam die je live zet, wordt een permanente tweede rij in elk rapport dat op event groepeert, en de enige manier om die rijen achteraf samen te voegen, is de data zelf opnieuw berekenen in een datawarehouse.
Het falen is niet theoretisch of netjes. Drie developers instrumenteren in drie sprints dezelfde knop en je krijgt signup_click, SignupClick en click_signup. GA4 behandelt alle drie als aparte events, omdat "event names are case sensitive. For example, my_event and My_Event are distinct events." Je funnel splitst in drieën, je aantal belangrijke gebeurtenissen is een derde van de waarheid, en niemand merkt het totdat iemand het dashboard met Stripe vergelijkt. De bredere discipline staat in event tracking; deze pagina gaat over de namen zelf.
Welke namen weigert GA4 direct?
GA4 weigert gereserveerde namen en gereserveerde prefixen, en de naamgevingsregels van Google noemen het gevolg zonder omwegen: "If you try to use a reserved prefix or name, Analytics will display an error message." De regels die voor elke naam gelden, zijn kort:
- "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces."
- "Event names are case sensitive."
- "Event names can include English and non-English words and letters."
Voor webdatastreams reserveert Google query_id als prefix en negentien eventnamen volledig. De namen die een implementatieteam opbreken, zijn de aannemelijk klinkende die je vanzelf zou kiezen:
| Gereserveerd op web | Waarom je ernaar zou grijpen |
|---|---|
click | De voor de hand liggende naam voor elke klikhandler |
error | De voor de hand liggende naam voor een fout aan de clientkant |
scroll | De voor de hand liggende naam voor een event over scrolldiepte |
file_download | De voor de hand liggende naam voor het downloaden van een pdf |
page_view | De voor de hand liggende naam voor een virtuele paginaweergave in een single-page app |
session_start | De voor de hand liggende naam voor het equivalent van een app openen |
user_engagement | De voor de hand liggende naam voor een event over verblijftijd |
video_start | De voor de hand liggende naam voor een event van een videospeler |
ad_impression | De voor de hand liggende naam voor een eigen advertentieplek |
De meeste daarvan worden al voor je verstuurd door uitgebreide metingen, en daarom zijn ze gereserveerd. Controleer wat je property zonder configuratie verzamelt voordat je iets een naam geeft, en lees autocapture voor wat automatische verzameling wel en niet vangt.
De referentie van het Measurement Protocol voegt een tweede, langere lijst toe die geldt als je events aan de serverkant verstuurt, met onder meer first_open, first_visit, app_exception, os_update en de hele firebase_-familie, en vermeldt dat "ad_impression, in_app_purchase and screen_view events are only allowed for App streams."
Parameters hebben hun eigen reserveringen. De naam firebase_conversion is gereserveerd, en parameternamen "cannot begin with" _, firebase_, ga_, google_ of gtag.. Namen van gebruikerseigenschappen mogen niet beginnen met _, firebase_, ga_ of google_, en de namen first_open_time, first_visit_time, last_deep_link_referrer, user_id en first_open_after_install zijn bezet.
Welke lengtelimieten gelden er?
Veertig tekens voor de eventnaam, en de straf voor overschrijding is vreemder dan een simpele weigering. De limieten voor eventverzameling van Google zeggen dat een eventnaam "40 characters" lang mag zijn, en voegen eraan toe: "If you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing." Het event wordt nog steeds verzameld. Het telt alleen stilletjes niet meer als belangrijke gebeurtenis, omdat GA4 intern _c toevoegt en de aangevulde naam te lang wordt.
De limieten eromheen vormen een conventie net zo sterk als de naamlimiet:
| Limiet | Waarde |
|---|---|
| Lengte van de eventnaam | 40 tekens |
| Unieke eventnamen, webstream | Geen limiet |
| Unieke eventnamen, appstream | 500 per appgebruiker |
| Eventparameters per event | 25 |
| Lengte van de parameternaam | 40 tekens |
| Lengte van de parameterwaarde | 100 tekens |
Waarde van page_title | 300 tekens |
Waarde van page_referrer | 420 tekens |
Waarde van page_location | 1.000 tekens |
| Gebruikerseigenschappen per property | 25 |
| Lengte van de naam van een gebruikerseigenschap | 24 tekens |
| Lengte van de waarde van een gebruikerseigenschap | 36 tekens |
De parameterwaarde van 100 tekens is de limiet waar teams over struikelen. Een productnaam, een zoekopdracht of een foutmelding van een formulier gaat eroverheen, en de waarde wordt afgekapt in plaats van dat het event wordt geweigerd. De naam van een gebruikerseigenschap van 24 tekens is nog krapper, zestien tekens korter dan de limiet voor eventnamen, en dat is een goede reden om eventnamen niet te spiegelen in namen van gebruikerseigenschappen.
Het onbeperkte aantal unieke events op web is eerder een val dan een vrijbrief. Niets houdt je tegen om vierhonderd eventnamen live te zetten; de rapporten worden gewoon onbruikbaar, en elk event moet als custom definitie worden geregistreerd voordat het in de meeste analyses verschijnt. Die registratiekosten worden behandeld in custom dimensies instellen.

Moet het object of de actie voorop staan?
Het gangbare advies is object voorop, cart_added en video_played, omdat rapporten alfabetisch sorteren en namen met het object voorop alle events over hetzelfde ding bij elkaar zetten. Het is goed advies, en het is het oneens met Google.
De aanbevolen events van Google zetten de actie voorop. De retailset alleen al luidt add_payment_info, add_shipping_info, add_to_cart, add_to_wishlist, begin_checkout, purchase, refund, remove_from_cart, select_item, view_item, en de algemene set voegt earn_virtual_currency, join_group, login, search, select_content, share, sign_up, spend_virtual_currency, tutorial_begin en tutorial_complete toe.
Dat telt, want aanbevolen events zijn niet cosmetisch. Google beschrijft ze als "standardized events for different business verticals (e.g., retail, travel, games) that unlock prebuilt reporting panels", terwijl custom events "events that you define yourself because no prepopulated automatic, enhanced, or recommended event fits your needs" zijn die "accessible using custom reports" zijn. add_to_cart hernoemen naar cart_added voor interne consistentie kost je de kant-en-klare e-commercerapporten.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
De werkbare regel splitst dus op herkomst, niet op smaak. Gebruik de spelling van Google overal waar een aanbevolen event bestaat, precies zoals gepubliceerd, en pas je eigen patroon met het object voorop alleen toe op events die Google niet definieert. Een conventie die add_to_cart naast pricing_table_viewed oplevert, ziet er op papier inconsistent uit en is de enige versie die zowel de rapporten als de sorteervolgorde bewaart. Welke volgorde je ook kiest, snake_case met kleine letters is de enige schrijfwijze die de val van hoofdlettergevoeligheid vermijdt, want een conventie waarin elk teken van hoofdletter kan wisselen, is een conventie die vroeg of laat geschonden wordt.
Wat kost het om een event na de lancering te hernoemen?
Het kost je historie, permanent, en het kost je een van vijftig plekken. De documentatie van Google over het hernoemen van events is ondubbelzinnig over het eerste deel: "Modified and new events do not apply to historical data." De aanpassing herschrijft alleen events vanaf dat moment. Elke rij die al in de property staat, houdt de oude naam, en er bestaat geen herverwerking om dat te herstellen.
Er gelden nog twee beperkingen. "An hour or more passes before modifications take effect", dus de fix werkt niet meteen, zelfs nadat je hem hebt doorgevoerd. En "you can modify up to 50 existing events and create up to 50 events based on existing events", wat betekent dat de aanpassingsfunctie een reparatieset is, geen naamgevingslaag waar je eindeloos op kunt leunen.
De praktische kosten van één hernoeming zijn dus:
- Een permanente splitsing op de datum van de wijziging in elk rapport dat op eventnaam groepeert.
- Elke definitie van een belangrijke gebeurtenis, elke doelgroep en elke funnel die naar de oude naam verwijst, moet op de nieuwe naam worden gedupliceerd, anders stopt hij met tellen. Het verschil tussen de twee begrippen staat in belangrijke gebeurtenissen tegenover conversies.
- Vergelijkingen jaar op jaar over de grens heen moeten met de hand aan elkaar worden gezet.
- Een van vijftig aanpassingsplekken, bezet zolang de oude naam nog binnenkomt vanaf een gecachte pagina of een nog niet uitgebrachte appbuild.
Niets daarvan is te herstellen door meer te betalen of langer te wachten, en dat is het hele argument om een middag aan het naamgevingsdocument te besteden voordat de eerste tag live gaat.
Hoe ziet een werkende conventie eruit?
Een conventie is vier opgeschreven beslissingen, geen lijst met namen. Neem elke beslissing één keer en de lijst genereert zichzelf.
Schrijfwijze: alleen snake_case in kleine letters, voor namen en parameters. Letters, cijfers en underscores zijn sowieso alles wat GA4 accepteert, en kleine letters halen de enige manier weg waarop twee identieke events uit elkaar kunnen lopen.
Woordenschat: een gesloten lijst werkwoorden en een gesloten lijst objecten. view, select, add, remove, submit, start, complete dekt de meeste sites. Twee werkwoorden die hetzelfde betekenen, zijn precies hoe signup_submit en signup_complete allebei in productie belanden.
Volgorde: de spelling van Google waar een aanbevolen event bestaat, het object voorop overal elders, en de uitzondering in het document vastgelegd, zodat de volgende engineer hem niet stilletjes wegnormaliseert.
Plaats van details: variabele details horen in parameters, nooit in de naam. form_submit met een parameter form_name is één event waarop je kunt filteren; newsletter_form_submit, contact_form_submit en demo_form_submit zijn drie events die je niet kunt vergelijken zonder per formulier een rapport te bouwen, en ze verbruiken drie van je registraties voor custom definities in plaats van één.
Lengte: houd namen ruim onder de 40 tekens, want de straf voor belangrijke gebeurtenissen voegt _c toe aan wat je ook kiest, en het falen is stil.
Veelgestelde vragen
Welke tekens mag een GA4-eventnaam bevatten?
Letters, cijfers en underscores, en de naam moet met een letter beginnen. Google formuleert de regel als "Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces." Niet-Engelse letters zijn toegestaan: "Event names can include English and non-English words and letters."
Zijn GA4-eventnamen hoofdlettergevoelig?
Ja. De naamgevingsregels van Google zeggen dat "event names are case sensitive. For example, my_event and My_Event are distinct events." Er is geen normalisatiestap, dus twee spellingen van hetzelfde event leveren twee onafhankelijke rijen op in elk rapport dat op eventnaam groepeert.

Wat gebeurt er als ik een gereserveerde eventnaam verstuur?
Analytics weigert hem en toont een foutmelding. De naamgevingsregels zeggen dat "if you try to use a reserved prefix or name, Analytics will display an error message." Gereserveerde namen op web zijn onder meer click, error, scroll, file_download, page_view, session_start, user_engagement en video_start.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Moet ik object_action of action_object gebruiken?
Gebruik de exacte spelling van Google voor zijn aanbevolen events, die de actie voorop zetten, en het object voorop voor al het andere. De aanbevolen set van Google bevat add_to_cart, begin_checkout, select_item en view_item, en wie die hernoemt, verliest de kant-en-klare rapportpanelen die Google eraan koppelt.
Kan ik een GA4-event na de lancering hernoemen?
Je kunt het vanaf nu hernoemen, maar nooit met terugwerkende kracht. Google zegt dat "modified and new events do not apply to historical data", dat "an hour or more passes before modifications take effect", en dat je "can modify up to 50 existing events and create up to 50 events based on existing events."
Hoe lang mag een GA4-eventnaam zijn?
40 tekens. Overschrijding heeft een specifiek gevolg naast weigering: Google waarschuwt dat "if you mark an event as a key event and the event exceeds 40 characters, then the event will not be reported as a key event because the appended _c will be missing."
Wat gebeurt er als een team inconsistente eventnamen live zet?
GA4 behandelt elke spelling als apart event, omdat eventnamen hoofdlettergevoelig zijn. Drie developers die dezelfde knop signup_click, SignupClick en click_signup noemen, leveren drie aparte rijen op in elk rapport, splitsen de funnel in drieën en verlagen het aantal belangrijke gebeurtenissen tot een derde van het echte totaal. Niemand merkt het totdat iemand het dashboard naast een andere databron zoals Stripe legt.
Is er een limiet op hoeveel eventnamen ik naar GA4 kan sturen?
Een webstream heeft geen limiet op unieke eventnamen, maar die afwezigheid werkt eerder tegen je dan voor je. Eventnamen verschijnen vanzelf, maar elke parameter die je toevoegt, heeft een plek voor een custom definitie nodig, dus vierhonderd namen leveren rapporten op die niemand kan lezen. Een appstream heeft wel een maximum, van 500 unieke events per appgebruiker.
Wat is het verschil tussen een custom event en een aanbevolen event?
Een aanbevolen event is een van de gestandaardiseerde namen van Google voor een branche zoals retail of reizen, en volgens Google ontgrendelt het kant-en-klare rapportpanelen. Een custom event definieer je zelf, omdat geen van de automatische, uitgebreide of aanbevolen events van Google past, en het verschijnt alleen in custom rapporten die je zelf bouwt. Wie een aanbevolen event als add_to_cart hernoemt voor interne consistentie, verliest het kant-en-klare paneel dat erbij hoort.
Tellen belangrijke gebeurtenissen nog nadat ik het event dat ze volgen heb hernoemd?
Niet automatisch. Elke definitie van een belangrijke gebeurtenis, elke doelgroep en elke funnel die naar de oude naam wees, moet op de nieuwe naam worden gedupliceerd, anders stopt hij met tellen zodra de hernoeming ingaat. Die duplicatie kost geen aanpassingsplek; alleen de hernoeming zelf verbruikt een van de vijftig die GA4 toestaat.
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
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


Hoe een datalaag events aan je analyticstags doorgeeft
Een datalaag is de wachtrij waarin een pagina analyticsevents zet. Zie hoe Tag Manager dataLayer leest, waarom pushes samensmelten en welke fouten events laten verdwijnen.


Hoe eventparameters in GA4 de details achter elk event meedragen
Google beperkt eventparameters in GA4 tot 25 per event. Bekijk de limieten voor namen en waarden, gereserveerde namen en waarom aangepaste parameters buiten rapporten blijven.
Wat er in een trackingplan hoort, en wat het niet kan vangen
Een trackingplan noemt elk event, elke trigger, eigenschap en eigenaar voordat er code live gaat. Bekijk de kolommen, een ingevuld voorbeeld en het gat dat validatietools missen.


Google noemt zeven aparte oorzaken van not set in GA4
De documentatie van Google geeft not set in GA4 per dimensie een andere oorzaak, van een ontbrekende session_start tot een lege content_group. Hier staat elke oorzaak en de oplossing.


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.


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.
Gerelateerde artikelen


Wat het rapport over landingspagina's in GA4 telt en waar het leeg blijft
Het rapport over landingspagina's in GA4 toont de eerste pagina van elke sessie. Waar je het vindt, de standaardstatistieken, waarom (not set)-rijen verschijnen en hoe je de bron toevoegt.


Hoe het bijhouden van zoekopdrachten op je site in GA4 vastlegt wat bezoekers typen
Stel zoekopdrachten op je site in GA4 in met enhanced measurement, voeg je eigen queryparameters toe, vind de dimensie Search term en volg zoekopdrachten zonder URL.


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.

