Clerk.io GTM tag template

De Clerk.io-template regelt gepersonaliseerd zoeken, aanbevelingen en doelgroeptracking in GTM, met vijf action types: Initialize, Track Product View, Track Cart, Track Purchase/Sale en Track Search.

Hij laadt clerk.js van de CDN van Clerk en stuurt je data daar vandaan door.

• Vijf action types in één template
• Initialize laadt clerk.js van https://cdn.clerk.io/clerk.js en zet je API-key
• Instelbare taal en e-mailverzameling (collect_email)
• Productweergaven sturen product-ID's door voor gedragsprofielen
• Winkelmandtracking synchroniseert de volledige mandinhoud als array van product-ID's
• Aankooptracking legt order-ID, product-ID's en optioneel het e-mailadres vast voor aanbevelingen na aankoop
• Zoektracking vangt zoekopdrachten op voor de zoekanalyse van Clerk

• Ga in je GTM-workspace naar Templates, dan Tag Templates, dan Search Gallery.
• Zoek op Clerk.io en voeg de template toe.
• Maak één Initialize-tag voor alle pagina's, plus een tag per trackingactie die je nodig hebt.

Stap 1. Initialize. Zet Action Type op Initialize en vul je API-key in. Stel eventueel Language in bij een meertalige winkel en zet Collect Email aan. Deze tag moet op elke pagina afgaan zodat clerk.js laadt.

Stap 2. Productweergaven. Action Type Track Product View, met Product IDs gekoppeld aan een Data Layer-variabele die op productpagina's het huidige product-ID teruggeeft.

Stap 3. Winkelmandje. Action Type Track Cart, met Product IDs gekoppeld aan een variabele die de array van producten in het mandje teruggeeft. Laat hem afgaan bij elke wijziging: toevoegen, verwijderen en het bekijken van de mandpagina.

Stap 4. Aankopen. Action Type Track Purchase/Sale, met Order ID en Product IDs gekoppeld aan de variabelen van je bevestigingspagina. Voeg het e-mailadres toe als je aanbevelingen per mail wilt sturen.

Stap 5. Zoekopdrachten. Action Type Track Search, met Search Query gekoppeld aan de zoekterm. Laat hem afgaan zodra er gezocht wordt, meestal op de resultatenpagina of via een eigen zoekevent.

Volgorde. Zet de Initialize-tag als setup tag voor alle andere, zodat clerk.js geladen is voordat iets hem probeert te gebruiken.

// productdetailpagina
dataLayer.push({
  event: 'view_item',
  clerk_product_ids: ['PROD-12345']
});

// bij wijziging van het mandje
dataLayer.push({
  event: 'cart_update',
  clerk_cart_product_ids: ['PROD-12345', 'PROD-67890']
});

// orderbevestiging
dataLayer.push({
  event: 'purchase',
  clerk_order_id: 'ORD-2024-001',
  clerk_product_ids: ['PROD-12345', 'PROD-67890'],
  clerk_email: 'klant@voorbeeld.nl'
});

// bij zoeken
dataLayer.push({
  event: 'search',
  clerk_search_query: 'blauwe hardloopschoenen'
});

clerk.js laadt niet. Controleer of de Initialize-tag afgaat en kijk in het Network-tabblad naar https://cdn.clerk.io/clerk.js. Wordt die geblokkeerd, kijk dan naar een adblocker of je content security policy.

API-keyfout in de console. Controleer of de key overeenkomt met de publieke API-key in je Clerk.io-dashboard onder Settings, API Keys. Gebruik niet de private key.

Productweergaven komen niet aan. Controleer in Preview of de Product IDs-variabele op productpagina's oplost, en of die waarden overeenkomen met de product-ID's in je Clerk.io-feed.

Winkelmandje loopt achter. Track Cart stuurt de volledige mandinhoud, geen wijzigingen. De variabele moet op het moment van afgaan de complete array teruggeven.

Aankopen ontbreken. Het order-ID moet uniek zijn per transactie, want Clerk.io dedupliceert daarop. Controleer ook of de array met product-ID's niet leeg is.

Zoekopdrachten worden niet gemeten. De Search Query-variabele moet de echte zoekterm teruggeven, niet undefined of leeg. Laat de trigger afgaan ná het versturen van de zoekopdracht, niet bij elke paginalading.

• Clerk.io-documentatie: https://docs.clerk.io/docs/clerkjs-quick-start
• Clerk.io-dashboard: https://my.clerk.io/
• GTM Community Template Gallery: zoek op Clerk.io
• GTM Help Center: https://support.google.com/tagmanager/