Je servercontainer debuggen met Preview mode als Measurebase ervoor staat

Preview mode is het eerste waar mensen naar grijpen als een tag zich misdraagt, en de eerste vraag als er een proxy vóór de servercontainer staat, is of hij nog werkt. Dat doet hij, voor beide containers, en er is geen Measurebase-instelling voor nodig. Wat wél verandert is waar de debugsessie zich aan hecht, en dat verklaart bijna elke lege preview waar we naar gevraagd zijn.

De webcontainer: er verandert niets

Preview de webcontainer vanuit Tag Manager zoals altijd. Tag Assistant maakt verbinding met je pagina, en de container zelf wordt via je tagging subdomain geserveerd door het Enhanced script, precies als voor een gewone bezoeker. Hits die je tijdens de preview stuurt, bereiken je servercontainer met de previewmarkering; je requestlogs tonen ze met het type GTM preview mode en de tag PREVIEW · NOT COUNTED, dus testen raakt je quotum nooit.

De servercontainer: waar de sessie leeft

Klik je in de servercontainer op Preview, dan opent Tag Assistant de eerste URL die onder Admin → Container Settings → Server container URLs staat en vraagt die om een debugsessie. Die host zet drie kortlevende cookies in je browser (gtm_auth, gtm_debug, gtm_preview) en vraagt vanaf dan diezelfde host om events. Een hit sluit zich bij de sessie aan als hij de container met de preview-header bereikt, en die header plakt de browser alleen op hits naar de host die die cookies heeft.

Twee gevolgen:

• De eerste servercontainer-URL moet het adres zijn waar je site echt naartoe stuurt: je tagging subdomain, of je Same-Origin Tracking -adres als dat aanstaat. Met Same-Origin Tracking gaan de hits naar www.yoursite.com/mb; opende Tag Assistant in plaats daarvan mbase.yoursite.com , dan staan de cookies op de verkeerde host en blijft de preview leeg. De audit markeert dit als bevinding op het domein; de oplossing is het Same-Origin-adres bovenaan de lijst te zetten.
• Measurebase stuurt de preview-header onaangeroerd door, zodat het request de container bereikt zoals Google verwacht. Hits die hem dragen passeren ook IP Filter, zodat je kunt testen vanaf een kantooradres dat je anders uitsluit.

Testhits in de sessie krijgen

• Vanaf je site: surf erop in hetzelfde browserprofiel waarin Tag Assistant draait. Elke GA4-hit draagt dan de header en verschijnt als binnenkomend request met de client die hem claimde, de eventdata en, met Data Enrichment aan, de headers X-GEO-* en X-Device-* die je servertags lezen.
• Vanuit de Shopify-checkout: de checkout draait in een sandbox zonder toegang tot je cookies. De Measurebase-app overbrugt dat: zet de serverpreview-header aan op het tabblad Test van de app en de app geeft het huidige previewtoken met elke checkouthit mee, zodat begin_checkout en purchase in de sessie verschijnen. Hij schakelt zichzelf na 24 uur uit.
• Tags achter toestemming: zet Auto Grant Consent aan zolang je test, zodat je niet voor elke run door je eigen banner hoeft te klikken, en zet het daarna weer uit.

Als de preview leeg blijft

1. Herstart Tag Assistant goed. Sluit het previewtabblad en het debugtabblad en start Preview opnieuw vanuit de servercontainer. De koppeling tussen je browser en de debugsessie wordt aan de kant van Google bijgehouden en raakt soms verouderd, ook al blijft het previewtoken zelf dagenlang hetzelfde. Een frisse start verhelpt de meeste lege previews; tokens vergelijken zegt niets.
2. Controleer of er überhaupt hits binnenkomen. Open de requestlogs van het domein terwijl je surft. Geen rijen betekent dat de site nog niet naar deze tagging subdomain stuurt; rijen zonder het previewtype betekenen dat de browser de header niet meestuurt, meestal door de hostmismatch hierboven of een ander browserprofiel.
3. Controleer de host. De eerste servercontainer-URL in GTM moet gelijk zijn aan de host in je requestlogs. Een hit die met 200 is beantwoord maar in de preview ontbreekt, is een hit die de container niet bij een actieve sessie vond horen; een 403 betekent dat de header bij een andere container hoort.
4. Zoek naar een adblocker in je eigen browser. Tag Assistant en de debugpolling staan op gangbare blokkeerlijsten. Sta je eigen site en tagassistant.google.com toe zolang je debugt.
5. Eén container tegelijk. Een debugsessie is gekoppeld aan één servercontainer. Domeinen die een container delen, delen een preview; domeinen met een eigen container hebben een eigen sessie nodig.

Lezen wat je ziet

Het linkerpaneel toont binnenkomende requests van de GA4-client; het tabblad Tags laat zien welke servertags op elk event afgingen en waarom. Waarden die van Measurebase komen verschijnen als request-headers op het event: land, stad, apparaat, browser en botvlag met Data Enrichment, een gemaskeerd IP met IP Anonymization, en mb_profit op aankopen met Profit Tracking. Leest een servertag een daarvan en toont hij undefined, dan staat de power-up voor dit domein uit of komt de variabelenaam niet overeen met de header.

Veelgestelde vragen

Kan ik de productiecontainer en een workspace tegelijk previewen?

Preview draait altijd de workspace waaruit je hem startte, tegen de live hits. De voorgestelde fixes van de audit landen in de aparte Measurebase-workspace, dus preview die workspace om ze te zien voordat je publiceert.

Tellen previewrequests mee voor mijn quotum?

Nee. Ze worden gelogd, gelabeld en buiten de factureerbare telling gehouden.