Woordenlijst

Wat er in een trackingplan hoort, en wat het niet kan vangen

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •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

TL;DR, kort antwoord

8 min leestijd

Een trackingplan is de geschreven specificatie van elk analyticsevent dat een product verstuurt: de naam, het precieze moment waarop het afgaat, de eigenschappen en hun types, de bron die het verstuurt en de persoon die eigenaar is. Tools zoals Segment Protocols en Amplitude Data valideren binnenkomende events tegen het plan, maar Segment stelt dat het een Track-call niet verplicht kan stellen omdat het niet kan weten wanneer die zou moeten afgaan, dus een gepland event dat nooit binnenkomt levert geen overtreding op.

Wat is een trackingplan?

In productanalytics is een trackingplan de geschreven specificatie die elk event noemt dat een product verstuurt, het precieze moment waarop elk event afgaat, de eigenschappen die het meedraagt met hun types, de bron die het verstuurt en de persoon die eigenaar is, afgesproken voordat iemand instrumentatiecode schrijft. De Protocols-documentatie van Segment definieert het als "a data spec outlining the events and properties you intend to collect across your Segment Sources." De versie van Amplitude voegt de reden voor elke regel toe: "A tracking plan defines every event and property you collect, why you collect each one, and which source emits it."

Het plan is het contract en de trackingcode is de implementatie. Zijn de twee het oneens, dan moet iemand beslissen welke van de twee fout is, en zonder plan is er niets om de code tegen te controleren. Eventtracking is het vastleggen van wat gebruikers deden. Het trackingplan is het document dat zegt wat "deden" voor elk event betekent.

Welke kolommen heeft een trackingplan nodig?

Een trackingplan heeft één regel per event nodig en genoeg kolommen dat een engineer het event kan implementeren zonder een vraag te stellen. De kolommen hieronder zijn de kolommen die later echte discussies voorkomen. De Tracking Plan-editor van Segment gebruikt een deel ervan, met de namen Name, Description, Status, Data Type en Permitted Values.

KolomWat erin staatWaarom de kolom zijn plek verdient
EventnaamDe precieze string die wordt verstuurd, zoals signup_completedDe editor van Segment "strictly validates the name passed in your Track calls. Casing, spacing and spelling matter."
TriggerHet ene moment waarop het event afgaat, in gewone woordenTwee engineers die "bij aanmelding" lezen, leveren twee verschillende events op
Vraag die het beantwoordtHet rapport of de metric die dit event voedtEen event waarvoor niemand een gebruik kan noemen, is een kandidaat om te schrappen
EigenschappenElke eigenschapsnaam die met het event meegaatMet eigenschappen splits je één event op in segmenten
Typestring, integer, boolean, datum enzovoortEen prijs die op de ene plek als "49" en op de andere als 49 wordt verstuurd, breekt optellingen
Verplicht of optioneelPer eigenschapDe Status-kolom van Segment bevat precies dit
Toegestane waardenLijst met waarden of patroonVoorkomt dat Pro, pro en PRO drie abonnementen worden
BronWeb, iOS, Android, serverDe definitie van Amplitude noemt "which source emits it"
EigenaarEen benoemde persoon of een teamIemand moet wijzigingen goedkeuren
StatusGepland, live, verouderdVoorkomt dat uitgefaseerde events per ongeluk opnieuw worden geïmplementeerd

De lijst met datatypes van Segment is een redelijke standaard voor de kolom Type: "any, array, object, boolean, integer, number, string, null, Date time", waarbij datum-tijden "required to be in ISO-8601 format." De kolom Permitted Values accepteert "simple regular expressions to validate property values", en dat werkt alleen op eigenschappen van het type string.

Hoe ziet een ingevulde regel in een trackingplan eruit?

Een ingevulde regel leest als een kleine specificatie. Hier is één event uit een aanmeldflow van een SaaS-product, geschreven zoals een plan in een repository het zou bewaren:

event: signup_completed
trigger: >
  Fires once, from the server, after the account row is written.
  Not on button click. Not on page load of /welcome.
answers: Signup-to-activation funnel, weekly signups by channel
source: backend
owner: growth-eng
status: live
properties:
  plan:
    type: string
    required: true
    allowed: [team, pro]
  signup_method:
    type: string
    required: true
    allowed: [email, google, github]
  invited:
    type: boolean
    required: false

De tekst van de trigger is het deel dat de meeste plannen fout hebben. "Gaat af bij aanmelding" zegt niet of een mislukte formulierverzending meetelt, of een retry twee keer afgaat en of het event uit de browser of van de server komt. Door "niet bij een klik op de knop" te schrijven, sluit je het meest voorkomende duplicaat uit, waarbij de klik afgaat en de server het formulier daarna weigert. De stijl van naamgeving is een aparte keuze, en een naamgevingsconventie voor events kiezen vóór de eerste regel bespaart je later een hernoeming.

Een medewerker in een magazijn vergelijkt artikelen met een checklist op een klembord, zoals een tool binnenkomende events tegen een plan controleert.

Wat kan een tool voor trackingplannen valideren, en wat niet?

Een tool voor trackingplannen valideert de events die binnenkomen tegen de events die het plan beschrijft, en kan je niets vertellen over de events die nooit binnenkomen. Die tweede helft is het nuttigste om over deze tools te weten, en de leveranciers zeggen het zelf.

De documentatie van Segment beschrijft de controlekant: "Violations generate when an event doesn't match the spec'd event in the Tracking Plan." En dan, in de beschrijving van de Status-kolom: "You can't require a Track call because Segment is unable to verify when a Track call should be fired." Segment kan controleren of een event zijn verplichte eigenschappen heeft, maar kan op geen enkele manier weten dat het event had moeten afgaan en dat niet deed.

Amplitude behandelt de andere richting. Events die binnenkomen zonder in het plan te staan, verschijnen als "Unexpected", en Amplitude zegt "You can add them to your plan, or delete them to stop ingestion and remove them from your data catalog." Voor de ontbrekende richting publiceert Amplitude een aparte gids met de titel "Planned events that never arrived: confirm the problem", die je vertelt "Compare your tracking plan with observed data and your planning records to find planned events that never reached Amplitude." Dezelfde pagina zegt "Data Assistant doesn't identify these entries" en dat Observe, de weergave die laat zien of een event binnenkwam, "the selected time range, up to 14 days" dekt.

Een groen validatiedashboard betekent dus dat elk event dat binnenkwam aan zijn specificatie voldeed. Het betekent niet dat elk event uit de specificatie binnenkomt. De praktische oplossing is een controle per release. Maak een lijst van de events die in het plan als live staan, vraag voor elke naam recente data op en markeer alles met een aantal van nul. De gids van Amplitude voegt de juiste waarschuwing toe: een event zonder activiteit "might belong to a rare workflow, a disabled feature, or a future release", dus vraag het de eigenaar voordat je de regel verwijdert.

Releasecontrole voor geplande events
Lijst van events die live staan
Vraag recente data per naam op
Markeer alles met nul
Vraag het de eigenaar
Houd of verwijder de regel
Doe dit één keer per release, want geen enkel validatiedashboard meldt uit zichzelf een ontbrekend event.

Welke limieten van bestemmingen horen in het plan?

De limieten van elke tool waar de events naartoe stromen horen in het plan, want een regel die een limiet overschrijdt, faalt stilletjes in de bestemming. Google Analytics zegt het ronduit: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

LimietGA4Amplitude
Lengte van eventnaam40 tekensNiet vermeld op de pagina met limieten
Verschillende eventnamenGeen limiet voor webstreams; 500 per appgebruiker voor appstreams2.000 eventtypes per project
Eigenschappen per event25 eventparametersGeen limiet per event
Lengte van eigenschapsnaam40 tekensNiet vermeld op de pagina met limieten
Lengte van eigenschapswaarde100 tekens, met uitzonderingen voor page_title (300), page_referrer (420) en page_location (1.000)1.024 tekens voor de meeste waarden
Gebruikerseigenschappen25 per property, namen tot 24 tekens, waarden tot 361.000 per project

De twee tools falen verschillend als een plan ze overschrijdt. GA4 laat het item vallen: het voorbeeld is dat "Analytics doesn't process the 26th user property nor does it process an event name with more than 40 characters." Amplitude blijft data opnemen maar "stops indexing new values", dus de data bestaat in exports maar kan niet in grafieken worden opgevraagd. Amplitude voegt toe dat events boven de limiet voor eventtypes "still count toward the monthly event volume", wat betekent dat een ontspoorde instrumentatiebug geld kost voor data die niemand in een grafiek kan zetten.

Segment heeft een eigen limiet voor plannen die als bestanden worden beheerd: een geüploade Tracking Plan-CSV "must be smaller than 15 mb", en moet "have fewer than 100.000 rows and 2.000 rules."

Een klein team sorteert sticky notes op een whiteboard om de paar prioriteiten te kiezen die eerst tellen, zoals het kiezen van de eerste events voor een trackingplan.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

Realtime dashboard

Doelen bijhouden

Tracking zonder cookies

Hoeveel events hoort de eerste versie te bevatten?

De eerste versie bevat de paar events die de vragen beantwoorden die het team nu al elke week stelt, en verder niets. De implementatiegids van Amplitude zegt "resist the urge to track everything upfront" en raadt aan "starting with two important events in your product to give you initial insights." Het taxonomie-playbook ordent het werk als eerst bedrijfsdoelen, dan kernmetrics, dan de events en eigenschappen die die metrics nodig hebben.

Die volgorde klopt. Begin bij de metric uit de wekelijkse review, zoals de north star metric, schrijf de vraag op die hij oproept en voeg alleen de events toe die nodig zijn om die te beantwoorden. Een aanmeldflow die een funnelanalyse nodig heeft, vraagt één event per stap en één eigenschap die het resultaat opsplitst, geen veertig events voor elke klik op de pagina. Gebruik je Flowsery, dan "records signups, purchases, downloads, and custom events in one place" de doeltracking, en in het plan beslis je welke van die doelen het definiëren waard zijn.

Hoe houd je een trackingplan actueel?

Een trackingplan blijft actueel als een wijziging in de trackingcode niet kan worden gemerged zonder bijpassende wijziging in het plan. Al het andere is een herinnering die mensen negeren.

De Status-kolom doet het meeste werk. Een event als verouderd markeren in plaats van de regel te verwijderen, voorkomt dat een nieuwe engineer de oude naam zes maanden later opnieuw invoert. Beide tools houden een geschiedenis bij. Segment zegt dat wijzigingen in het plan via een upload "reflected in the Audit Trail and Tracking Plan changelog" worden, en de CSV-export geeft elk bestand de naam workspaceSlug-trackingPlanName--yyyy-mm-dd--hh-mm-utc. Een plan dat naast de code in de repository staat, krijgt de geschiedenis gratis via versiebeheer.

Veelgestelde vragen

Wat is het verschil tussen een trackingplan en een naamgevingsconventie voor events?

Een naamgevingsconventie voor events is één regel binnen een trackingplan: hoe namen worden gevormd, zoals object_action in snake case. Het trackingplan is de volledige lijst van events die die regel volgen, met per event de trigger, eigenschappen, types, bron en eigenaar.

Wie hoort eigenaar te zijn van het trackingplan?

Eén benoemde persoon hoort wijzigingen goed te keuren, uit het team dat de data het meest leest, terwijl engineers regels voorstellen. Een plan dat iedereen zonder review kan bewerken, glijdt af naar dezelfde staat als geen plan hebben.

Hoort een trackingplan in een spreadsheet of in een tool?

Een spreadsheet werkt voor een eerste versie met een paar dozijn events. Een tool zoals Segment Protocols of Amplitude Data voegt validatie van binnenkomende events tegen het plan toe, en een bestand in de coderepository voegt review en geschiedenis via pull requests toe.

Horen server-side events in hetzelfde trackingplan?

Ja. Houd één plan met een Bron-kolom, want dezelfde eventnaam die uit de browser en van de server wordt verstuurd, telt dubbel, tenzij het plan zegt welke van de twee het record is. De eigen definitie van Amplitude van een trackingplan bevat "which source emits it".

Hoe vind je geplande events die nooit zijn afgegaan?

Vergelijk de events die in het plan als live staan met de eventnamen in recente data en markeer alles met een aantal van nul. Segment stelt dat het een Track-call niet verplicht kan stellen, en Amplitude zegt dat de Data Assistant deze regels niet herkent, dus geen enkel validatiedashboard meldt het probleem uit zichzelf.

Maakt autocapture een trackingplan overbodig?

Nee. Autocapture legt klikken en pageviews vast, maar niet wat een klik betekende, zoals welk abonnement een gebruiker koos of of de server het formulier accepteerde. De events die omzet- en activatiemetrics voeden, hebben nog steeds een geschreven trigger en lijst met eigenschappen nodig.

Wat hoort er in de trigger-kolom te staan?

Het ene moment waarop het event afgaat, in gewone woorden, inclusief wat niet meetelt. "Gaat af bij aanmelding" laat open of een mislukte verzending of een retry meetelt, en of de browser of de server het verstuurt. "Gaat één keer af, vanaf de server, nadat de accountregel is geschreven. Niet bij een klik op de knop" laat niets te raden over.

Met hoeveel events begint een trackingplan?

Begin met de paar events die vragen beantwoorden die het team elke week stelt. De implementatiegids van Amplitude zegt "resist the urge to track everything upfront" en raadt aan met twee belangrijke events te beginnen. Voeg er pas meer toe als een metric ze nodig heeft.

Wat gebeurt er als een plan de limieten van GA4 of Amplitude overschrijdt?

GA4 laat het item vallen, dus een 26e gebruikerseigenschap of een eventnaam van meer dan 40 tekens wordt nooit verwerkt. Amplitude blijft data opnemen maar indexeert geen nieuwe waarden meer, dus de data verschijnt in exports maar kan niet in grafieken worden opgevraagd. Events boven de limiet voor eventtypes tellen nog steeds mee voor het maandelijkse eventvolume.

Waarom markeer je een event als verouderd in plaats van de regel te verwijderen?

Een verouderde regel voorkomt dat een nieuwe engineer de oude naam maanden later opnieuw invoert. Hij houdt ook de geschiedenis in het plan. Vraag het de eigenaar voordat je een regel verwijdert voor een event zonder activiteit, want het "might belong to a rare workflow, a disabled feature, or a future release."

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 een naamgevingsconventie voor events de eerste hernoeming overleeftHoe een naamgevingsconventie voor events de eerste hernoeming overleeft
Woordenlijst

Hoe een naamgevingsconventie voor events de eerste hernoeming overleeft

Een naamgevingsconventie voor events moet voldoen aan de gereserveerde namen, het maximum van 40 tekens en de hoofdlettergevoeligheid van GA4, want hernoemen na de lancering raakt de historie nooit.

•9 min leestijd
Wat gedragsanalyse meet dat paginaweergaven missenWat gedragsanalyse meet dat paginaweergaven missen
Woordenlijst

Wat gedragsanalyse meet dat paginaweergaven missen

Anders dan een kale telling van paginaweergaven legt gedragsanalyse vast wat een bezoeker echt op een pagina doet, als een stroom benoemde events die aan die specifieke bezoeker gekoppeld zijn.

•6 min leestijd
Hoe event tracking vastlegt wat gebruikers echt dedenHoe event tracking vastlegt wat gebruikers echt deden
Woordenlijst

Hoe event tracking vastlegt wat gebruikers echt deden

In productanalytics legt event tracking benoemde gebruikersacties met eigenschappen vast, en dat maakt van verkeer op paginaniveau een overzicht van wat mensen deden.

•7 min leestijd
Wat autocapture vastlegt zonder handmatige instrumentatieWat autocapture vastlegt zonder handmatige instrumentatie
Woordenlijst

Wat autocapture vastlegt zonder handmatige instrumentatie

In productanalytics legt autocapture elke klik, paginaweergave en formulierverzending automatisch vast, zonder één handgeschreven trackingcall.

•5 min leestijd
Hoe productanalytics gebruikers volgt in plaats van paginaweergavenHoe productanalytics gebruikers volgt in plaats van paginaweergaven
Woordenlijst

Hoe productanalytics gebruikers volgt in plaats van paginaweergaven

Anders dan webanalytics meet productanalytics gedrag per event en per gebruiker, zodat je vragen over activatie, retentie en funnels kunt beantwoorden.

•7 min leestijd

Gerelateerde artikelen