Google Tag Assistant: zo debug je je tags stap voor stap

Google Tag Assistant is Googles gratis tool om te controleren of de tags op je website correct werken. Je ziet per pagina en per klik welke tags afvuren, welke niet, welke data ze meesturen en welke consentstatus geldt. Dat maakt het de snelste manier om te ontdekken waarom een conversie ontbreekt, dubbel telt of de verkeerde waarde krijgt. In dit artikel lees je hoe je Tag Assistant opent, hoe je een debugsessie leest en welke controles je minstens doet voor je iets publiceert.

Wat is Google Tag Assistant?

Google omschrijft Tag Assistant in zijn helpcentrum als een tool om “de implementatie en werking van tags op je website te controleren”. Je bekijkt tags, events en data, en je kan debugsessies exporteren en importeren om ze met collega’s te delen.

Tag Assistant werkt via de website tagassistant.google.com, met een optionele Chrome-extensie, Tag Assistant Companion. Die extensie is handig voor twee situaties die anders moeilijk te testen zijn: tags in een iframe (denk aan een ingesloten formulier of agendatool) en pop-ups of nieuwe tabbladen die vanuit je pagina openen. Zoek je nog de oude losse extensie “Tag Assistant Legacy”: werk vandaag met de webversie en de Companion-extensie.

Drie manieren om Tag Assistant te openen

Via Preview in Google Tag Manager

Dit is de route die je het vaakst gebruikt. In je GTM-werkruimte klik je rechtsboven op Preview. Volgens de GTM-documentatie opent Tag Assistant dan in een nieuw tabblad, vul je de URL van je site in en klik je op Connect. Je site opent in een nieuw venster met de melding “Connected” rechtsonder. Alles wat je daarna op de site doet, verschijnt in de debugweergave.

Via tagassistant.google.com

Op tagassistant.google.com kies je Add domain en vul je je URL in. Tag Assistant voegt een debugparameter (_dbg) toe aan de URL en volgt je sessie. Dit werkt ook op sites waar je geen GTM-toegang hebt, bijvoorbeeld om de Google-tag van een nieuwe klant snel te bekijken.

Via GA4 DebugView

Een tag die afvuurt, is nog geen event dat GA4 correct verwerkt. Daarom controleer je ook in GA4 onder Beheer > DebugView. Volgens Googles uitleg over DebugView verschijnen sessies uit Tag Assistant of de previewmodus daar automatisch. Let op: events zijn niet zichtbaar in DebugView als consent mode actief is en de testgebruiker geen toestemming gaf. Accepteer dus de cookies in je testvenster, of test bewust ook de geweigerde route.

Een debugsessie lezen: stap voor stap

1. Begin met de tijdlijn links

Links zie je een tijdlijn met elk moment dat GTM registreert: het laden van de container, “Consent Initialization”, “Initialization”, “Container Loaded”, “DOM Ready”, “Window Loaded”, en daarna elke klik, formulierverzending of eigen event uit je data layer. Klik een moment aan om te zien wat er op dat moment gebeurde. Doe nu de actie die je wil testen, bijvoorbeeld een formulier versturen, en zoek het bijhorende moment.

2. Controleer Tags Fired en Tags Not Fired

Per moment toont Tag Assistant welke tags afvuurden en welke niet. Staat je conversietag bij “Not Fired”, klik hem dan aan: je ziet welke triggervoorwaarde niet voldaan was. Vuurt hij juist bij elke pagina in plaats van enkel na de verzending, dan is je trigger te ruim.

3. Bekijk de data in Variables en Data Layer

Op het tabblad Variables zie je de waarde van elke variabele op dat moment: de conversiewaarde, het formulier-ID, de pagina. Op het tabblad Data Layer zie je wat je website precies heeft doorgegeven. Klopt de waarde in de data layer, maar niet in de variabele, dan zit de fout in GTM. Ontbreekt ze al in de data layer, dan zit de fout op de website. Meer over die opbouw lees je in data layer uitgelegd.

4. Controleer de consentstatus

Op het tabblad Consent zie je de standaardstatus en de bijgewerkte status per consenttype, zoals ad_storage en analytics_storage. Test minstens twee scenario’s: alles geaccepteerd en alles geweigerd. In het tweede geval mogen advertentietags geen cookies zetten. Hoe consent mode in elkaar zit, lees je in consent mode v2 voor Google Ads.

5. Controleer de ontvangst in het platform

Ga daarna naar het platform zelf: GA4 DebugView, de conversiediagnose in Google Ads, de testevents in Meta Events Manager. Pas als het event daar met de juiste parameters binnenkomt, is je test geslaagd.

6. Deel de sessie

Moet een developer of collega meekijken? In Tag Assistant kies je More Actions en dan Share om een previewlink te delen. Je kan een sessie ook exporteren, wat handig is om een probleem later te tonen.

Checklist: wat test je per platform?

Veelgemaakte fouten die we met Tag Assistant vinden

• Een conversie die bij elke paginaweergave afvuurt. Vaak een trigger op “All Pages” of op een bedankpagina die ook via de terugknop opnieuw laadt.
• Twee GA4-configuraties tegelijk. Een hardgecodeerde Google-tag in het thema plus een tag in GTM: elke page view telt dubbel.
• Formulieren in een iframe. Zonder de Companion-extensie zie je ze niet, en zonder een aparte meting tellen ze niet.
• Testverkeer in je cijfers. Bij Tryve bleek bij de audit dat testhits als echte conversies meetelden en zo in de biedstrategie van Google Ads belandden. Filter intern en testverkeer in GA4 en test conversies bij voorkeur in een aparte omgeving.
• Een geslaagde test na een formulierupdate vergeten. Bij Suivo legde een formulierupdate de leadmeting stil zonder foutmelding. De oorzaak vonden we via een root-cause-analyse in GTM Preview.

Meer patronen lees je in veelgemaakte fouten in Google Analytics tracking.

Server-side containers debuggen

Werk je met server-side tagging, dan heeft je server container een eigen previewmodus. Je ziet daar per binnenkomend verzoek welke client het opving, welke tags afvuurden en welke uitgaande verzoeken naar GA4, Google Ads of Meta vertrokken, met hun statuscode. Test de web container en de server container samen: een event dat in de browser correct vertrekt, kan in de server nog sneuvelen.

Wanneer is Tag Assistant niet genoeg?

Tag Assistant toont één sessie in één browser. Het vertelt je niet of je cijfers over een maand kloppen, of GA4 en Google Ads hetzelfde aantal leads tellen of of je CRM en je advertentieplatformen op elkaar aansluiten. Daarvoor heb je een bredere controle nodig. Een tracking audit legt je tags, consent, conversies en de verschillen tussen platformen naast elkaar en geeft je een geprioriteerde lijst van wat je eerst herstelt. Lees ook waarom conversies in Google Ads en GA4 verschillen.

Veelgestelde vragen

Is Google Tag Assistant gratis?

Ja. Tag Assistant op tagassistant.google.com en de Companion-extensie zijn gratis. Je hebt een Google-account nodig, en voor de previewmodus van GTM toegang tot de container.

Waarom ziet Tag Assistant mijn site niet als “Connected”?

Meestal blokkeert iets de verbinding: een adblocker, een cookiebanner die de container niet laat laden, een redirect naar een andere URL of een pop-upblokkering. Probeer een privévenster zonder extensies, en controleer of de GTM-snippet op de pagina staat.

Waarom zie ik mijn events niet in GA4 DebugView?

Vaak omdat consent geweigerd is in je testsessie: dan zijn events niet zichtbaar in DebugView. Controleer ook of je de juiste GA4-property bekijkt en of de debugsessie nog actief is.

Werkt Tag Assistant ook voor de Meta-pixel of LinkedIn?

Tag Assistant toont of de tag in GTM afvuurt, ook voor Meta of LinkedIn. Of het platform het event correct ontvangt, controleer je in de tools van dat platform zelf, zoals de testevents in Meta Events Manager.

Kan ik Tag Assistant gebruiken zonder Google Tag Manager?

Ja. Via “Add domain” op tagassistant.google.com debug je ook een site die de Google-tag rechtstreeks gebruikt. Je ziet dan de Google-tag en de events, maar niet de GTM-specifieke tabbladen zoals triggers.

Laat je tags nakijken

Zie je in Tag Assistant dingen die je niet kan verklaren, of wil je zeker zijn dat elke conversie klopt voor je meer budget inzet? Met een tracking audit controleren we je volledige opzet, en onze tracking specialist herstelt wat er mis is. Voor de basis van je container lees je ook ons artikel over Google Tag Manager. Neem contact op als je meteen wil overleggen.