Woordenlijst

Hoe een naamgevingsconventie voor events de eerste hernoeming overleeft

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •9 min leestijd
Hoe een naamgevingsconventie voor events de eerste hernoeming overleeftHoe een naamgevingsconventie voor events de eerste hernoeming overleeft

TL;DR, kort antwoord

9 min leestijd

Google 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 webWaarom je ernaar zou grijpen
clickDe voor de hand liggende naam voor elke klikhandler
errorDe voor de hand liggende naam voor een fout aan de clientkant
scrollDe voor de hand liggende naam voor een event over scrolldiepte
file_downloadDe voor de hand liggende naam voor het downloaden van een pdf
page_viewDe voor de hand liggende naam voor een virtuele paginaweergave in een single-page app
session_startDe voor de hand liggende naam voor het equivalent van een app openen
user_engagementDe voor de hand liggende naam voor een event over verblijftijd
video_startDe voor de hand liggende naam voor een event van een videospeler
ad_impressionDe 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:

LimietWaarde
Lengte van de eventnaam40 tekens
Unieke eventnamen, webstreamGeen limiet
Unieke eventnamen, appstream500 per appgebruiker
Eventparameters 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
Gebruikerseigenschappen per property25
Lengte van de naam van een gebruikerseigenschap24 tekens
Lengte van de waarde van een gebruikerseigenschap36 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.

Een developer schetst een naamgevingspatroon op een whiteboard voordat de trackingcode wordt geschreven.

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.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

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.

De volgorde van een event kiezen
1
Controleer de aanbevolen lijst. Kijk of Google al een event definieert voor wat je volgt, zoals add_to_cart of begin_checkout.
2
Treffer gevonden. Gebruik de exacte spelling van Google, met de actie voorop, om de kant-en-klare e-commercerapporten te houden.
3
Geen treffer. Pas je eigen patroon met het object voorop toe, uit een gesloten lijst werkwoorden en objecten.
De volgorde van een naam hangt af van of Google het event al heeft gedefinieerd, niet van de huisstijl.

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.

Twee collega's vergelijken een analyticsdashboard met een andere databron om een verschil in de rapportage op te sporen.

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.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

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

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 doorgeeftHoe een datalaag events aan je analyticstags doorgeeft
Woordenlijst

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.

•9 min leestijd
Hoe eventparameters in GA4 de details achter elk event meedragenHoe eventparameters in GA4 de details achter elk event meedragen
Woordenlijst

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.

•8 min leestijd
Wat er in een trackingplan hoort, en wat het niet kan vangenWat er in een trackingplan hoort, en wat het niet kan vangen
Woordenlijst

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.

•8 min leestijd
Google noemt zeven aparte oorzaken van not set in GA4Google noemt zeven aparte oorzaken van not set in GA4
Woordenlijst

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.

•7 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

Gerelateerde artikelen