Je conversietracking gaat niet meer af. Verkeer verdwijnt. Een event wordt niet meer geactiveerd. Er is iets stuk, maar je weet niet wat. Debuggen is het proces van het probleem vinden en oplossen.
De meeste trackingproblemen hebben een duidelijke oorzaak als je weet waar je moet kijken. Leren debuggen scheelt uren gokken.
Het debugproces
Stap 1: Bevestig dat het probleem bestaat
Is tracking echt kapot, of heb je de data verkeerd gelezen? Bekijk meerdere weergaven. Bekijk verschillende periodes. Bevestig dat het probleem echt en blijvend is.
Stap 2: Bepaal wanneer het begon
Wanneer stopte de tracking? Gisteren? Vorige week? Kun je de dag aanwijzen? Kijk naar historische data. Wanneer viel het weg? Zo beperk je de mogelijke oorzaken.
Stap 3: Kijk of er iets is veranderd
Heb je recent code uitgerold? Configuratie veranderd? Een nieuwe functie gelanceerd? Veranderingen veroorzaken vaak problemen. Wat veranderde rond de tijd dat de tracking kapotging?
Stap 4: Gebruik debugtools
Gebruik de debugmodus van je analytics-tool. Gebruik de ontwikkelaarstools van je browser. Gebruik netwerkmonitoring. Zie verzoeken in realtime gebeuren om te zien waar ze falen.
Stap 5: Test handmatig
Maak testverkeer. Test een conversie. Test een event. Activeert je test de tracking maar echt verkeer niet, dan zit het probleem in productie. Werkt de test ook niet, dan zit het probleem in de implementatie.
Stap 6: Repareer en controleer
Voer de oplossing door. Test opnieuw. Controleer of de oplossing werkt voordat je zegt dat het klaar is.
Veelvoorkomende trackingproblemen en hoe je ze debugt
Trackingcode gaat niet af
Open de ontwikkelaarstools van je browser. Ga naar het tabblad Network. Zoek verzoeken naar je analytics-domein. Zie je ze? Zo niet, dan gaat de code niet af.
Kijk in de console van de browser naar JavaScript-fouten. Fouten voorkomen dat de trackingcode draait. Los de fout op en de tracking gaat af.
Trackingcode laadt maar data verschijnt niet in rapporten
Het verzoek wordt verstuurd (je ziet het in het tabblad Network) maar verschijnt niet in rapporten. Mogelijke oorzaken: een firewall die het verzoek blokkeert, een adblocker die het blokkeert, een verkeerd property-ID, een conversiedoel dat verkeerd is ingesteld.
Controleer of je de juiste property volgt. Controleer of filters de testdata niet uitsluiten. Controleer of botfiltering je test niet vangt.
Tracking gaat soms af maar niet consistent
Wisselende problemen zijn lastiger te debuggen. Het kunnen race conditions zijn (tracking gaat af voordat de data klaar is). Het kunnen netwerktimeouts zijn. Het kan code zijn met voorwaarden die niet altijd draait.
Bekijk de code. Zijn er voorwaarden die soms voorkomen dat tracking afgaat? Zijn er timeouts? Gebeurt de tracking op het juiste moment?
Conversietracking gaat af maar conversies verschijnen niet
De trackingcode gaat af. Het verzoek bereikt de server. Maar conversies verschijnen niet in rapporten. Mogelijke oorzaken: het conversiedoel is niet ingesteld, de URL van het doel komt niet overeen met de echte conversiepagina, het doel gaat meerdere keren per sessie af (en telt als één).
Controleer de configuratie van je conversiedoel. Komt de URL overeen? Gaat het doel af bij het juiste event? Is het ingesteld om één keer of meerdere keren te tellen?
Eventtracking gaat af maar data is onvolledig
Events gaan af, maar sommige eventparameters ontbreken. Omzet staat op 0 dollar. Product-ID is leeg. Het event wordt gevolgd, maar onvolledig.
Controleer je trackingcode. Worden parameters goed vastgelegd? Worden ze doorgegeven aan de trackingaanroep? Is de data beschikbaar op het moment van tracking?
Tools om te debuggen
Ontwikkelaarstools van de browser
Tabblad Network: zie verzonden verzoeken. Tabblad Console: zie JavaScript-fouten. Beide zijn essentieel voor het debuggen van tracking aan de clientkant.
Debugmodus van analytics
De meeste tools hebben een debugmodus. Google Analytics heeft DebugView. Productanalyticsplatforms hebben een live-weergave van events. Die tonen events in realtime terwijl ze afgaan.
Browserextensies
Extensies zoals Tag Assistant, Analyzer of GA Debugger helpen je trackingcode te inspecteren en problemen te debuggen.
Serverlogs
Serverlogs tonen alle verzoeken, ook trackingverzoeken. Bekijk ze om te zien of trackingverzoeken je server wel bereiken.
Trackingproblemen voorkomen
Test vóór het uitrollen
Rol wijzigingen in trackingcode niet uit naar productie zonder te testen. Test eerst in een testomgeving. Controleer of tracking werkt in de testomgeving voordat je live gaat.
Houd het in de gaten na het uitrollen
Volg na het uitrollen van wijzigingen 24 uur lang wat er gebeurt. Let op dalingen in verkeer of conversies. Vang problemen snel.
Houd wijzigingslogboeken bij
Leg elke wijziging in trackingcode vast. Wanneer het veranderde, wat er veranderde en waarom. Zo kun je problemen terugvoeren naar hun oorzaak.
Gebruik versiebeheer
Houd trackingcode in versiebeheer (Git). Zo kun je versies vergelijken als er iets stukgaat. Je kunt zo nodig terug naar de vorige versie.
Veelgestelde vragen
Hoe weet ik of mijn tracking kapot is of dat het gewoon weinig verkeer is?
Vergelijk met normale patronen. Is je verkeer gemiddeld 1000 en zakt het ineens naar 100, dan is er iets mis. Zakt het naar 800 en je draaide die week geen campagnes, dan is het waarschijnlijk prima. Met de websitebouwer van WEMASY zet je dit direct op je website.
Kan ik tracking debuggen zonder ontwikkelaarstools?
Niet makkelijk. Ontwikkelaarstools zijn essentieel. Voel je je er niet prettig bij, vraag dan een ontwikkelaar om hulp of gebruik de ingebouwde debugfuncties van je analytics-tool.
Hoe lang moet debuggen duren?
Simpele problemen (verkeerd property-ID, verkeerd ingesteld doel): 15-30 minuten. Complexe problemen (race conditions, netwerkproblemen): 1-4 uur. Zorg dat een ontwikkelaar beschikbaar is als debuggen langer dan een uur duurt.
Wat als ik het probleem niet vind?
Leg vast wat je al hebt gecontroleerd. Vraag hulp aan je analytics-leverancier of een consultant. Soms ziet een frisse blik het probleem.
Moet ik wijzigingen terugdraaien als tracking na het uitrollen stukgaat?
Ben je net uitgerold en gaat tracking stuk, dan ja. Draai meteen terug. Debug daarna in de testomgeving voordat je opnieuw uitrolt.
Kunnen adblockers mijn tracking blijvend kapotmaken?
Adblockers breken tracking niet voor bezoekers zonder blokkers. Ze blokkeren het alleen voor bezoekers met blokkers. Je tracking werkt prima voor de meeste bezoekers zonder blokkers.