GTM Preview-modus gebruiken (en wat te doen als hij niet werkt)

Met de Preview-modus (preview mode) van Google Tag Manager laad je het concept van je werkruimte op je eigen site, zonder te publiceren. Tag Assistant toont per dataLayer-event welke tags wel en niet zijn afgegaan en welke waarden je variabelen op dat moment hadden.

Wat gebeurt er technisch in de Preview-modus?

De site laadt in de Preview-modus je werkruimteconcept (of een gekozen versie) en meldt elke dataLayer-push en tagactivering aan Tag Assistant. De debuginformatie is alleen zichtbaar in de browser waarmee je de preview hebt gestart, of bij iemand met wie je de sessie deelt.

Dit mechanisme staat niet in de Google-Help-pagina's over Preview en Tag Assistant. Volgens Simo Ahava (2020, bijgewerkt in 2021) bepaalt de pagina op drie signalen of het debugvenster actief wordt: een debugparameter in de URL, tagassistant.google.com als referrer of een first-party cookie __TAG_ASSISTANT. De gegevens gaan daarna via window.postMessage naar het Tag Assistant-tabblad. Dat kanaal bestaat alleen voor vensters die je via Tag Assistant hebt geopend: een los geopend tabblad met dat cookie vindt geen debugger. Google noemt de URL-parameter _dbg, Ahava noemt gtm_debug=x.

Op elke paginalading verschijnen in de tijdlijn de events gtm.init_consent, gtm.init, gtm.js, gtm.dom en gtm.load (Analytics Mania, 2026). Ontbreekt gtm.js, dan wijst dat volgens Analytics Mania op een beschadigde dataLayer. Een push zonder event-sleutel verschijnt als "Message".

Hoe start je de Preview-modus in GTM?

1. Open je container in GTM.
2. Klik in de werkruimte rechtsboven op Voorbeeld. Tag Assistant opent in een nieuw tabblad.
3. Vul de URL van je site in en klik op Verbinding maken.
4. Je site opent in een nieuw venster en toont rechtsonder Gekoppeld.
5. Ga terug naar het tabblad van Tag Assistant en klik op Doorgaan.

Een oudere versie test je via Versies => Meer acties => Voorbeeld. Wijzig je daarna iets in de werkruimte, start de preview dan opnieuw (Analytics Mania). Stoppen doe je met het kruisje linksboven in Tag Assistant of met Foutopsporing stoppen. Stop je via Tag Assistant terwijl er geen actieve verbinding met het debugvenster is, dan blijft het cookie staan. Sluit dan de preview-badge op de site (Ahava).

Met de Chrome-extensie Tag Assistant opent het debugvenster in een tabblad in plaats van een pop-up. Daarmee kun je meerdere vensters in één sessie debuggen, iframes inspecteren en referrer-afhankelijke acties testen. De oude Tag Assistant Companion is volgens Google samengevoegd met de nieuwe extensie. Zonder extensie verbreekt het typen in de adresbalk van het debugvenster het kanaal (Ahava, voor Chrome).

Waarom maakt Tag Assistant geen verbinding?

Loop de oorzaken uit de troubleshooting van Google na:

• De tag staat niet op de pagina. Probeer een URL waar de containercode zeker staat en controleer de container-ID in het gtm.js-request. Zie Google Tag Manager installeren en wat een GTM-container is.
• De tag laadt te laat. Tag Assistant probeert te verbinden voordat het script is geladen. Klik op Opnieuw proberen.
• De debugparameter breekt de pagina. Zet het vinkje Foutopsporingssignaal opnemen in de URL uit.
• Adblockers of browserextensies blokkeren de tag. Zet ze uit voor je eigen site en geef de Tag Assistant-extensie rechten om sitegegevens te lezen en te wijzigen.
• Meerdere redirects voorkomen dat het debugvenster laadt.
• Een iframe of AMP-pagina. AMP wordt niet ondersteund; een tag in een iframe debug je alleen met de extensie.
• Een consenttool blokkeert Google-tags. Configureer de tool zo dat interactie met de consent-API van Google is toegestaan.
• Een firewall, proxy of Content Security Policy (CSP) houdt de tag tegen.

Bij een CSP moet Preview extra bronnen kunnen laden. Google noemt onderstaande bronnen voor de Preview-modus. Voeg ze toe aan je bestaande policy:

Content-Security-Policy:
  script-src-elem https://www.googletagmanager.com https://tagmanager.google.com;
  style-src https://www.googletagmanager.com https://tagmanager.google.com https://fonts.googleapis.com;
  img-src https://www.googletagmanager.com https://ssl.gstatic.com https://www.gstatic.com;
  font-src https://fonts.gstatic.com data:

Een tip uit de community (taggingdocs.com): laadt je cookiebanner of een cachingplugin GTM pas later, wis dan de cache en test opnieuw. Verschijnen wijzigingen uit de werkruimte niet in de preview, dan noemt de auteur van Analytics Mania in een reactie caching als oorzaak en adviseert hij gtm.js van caching uit te sluiten.

Wat kun je nog meer controleren als tags niet afgaan?

Maakt Tag Assistant wel verbinding, maar gaat je tag niet af? Selecteer eerst het event in de tijdlijn en open daarna pas de tag:

• Triggers: onder de tag zie je per voorwaarde of die is voldaan. Variabelen die undefined teruggeven wijzen vaak op een verkeerd gespelde dataLayer-sleutel; die zijn hoofdlettergevoelig.
• Toestemming (consent): het consenttabblad toont de toestemmingsstatus op dat moment, en of een tag daarop wacht. Lees ook Consent Mode v2 instellen met Cookiebot en GTM.
• Fouten: een tabblad met een teller boven 0 toont onder meer fouten in tagtemplates.
• Werkruimte of gepubliceerde versie: de preview toont je werkruimte. Werkt het in de preview maar niet live, dan heb je nog niet gepubliceerd (Submit).

De ingebouwde variabele Foutopsporingsmodus (Debug Mode) geeft true zolang de container in de voorbeeldmodus draait. Daarmee kun je een test-tag tot de preview beperken.

Let op: de Preview-modus toont dat een tag afgaat en welke hit uitgaat. Of GA4 de data goed verwerkt, zie je daar niet. Volgens Google helpt de debugparameter om events ook in DebugView te bekijken. Controleer de verwerking daarna in DebugView of in het realtimerapport van GA4.