Hoe Lead Data met UTM Parameters via Webhooks te Versturen

Deze handleiding legt uit hoe je lead generation data, inclusief UTM parameters en marketing attributie data, kunt vastleggen en doorsturen naar externe platformen via webhooks door middel van Google Tag Manager Server-Side.

Overzicht

Wanneer een bezoeker converteert op je website, wil je vaak deze conversie data samen met marketing attributie informatie versturen naar externe platformen voor verdere verwerking, CRM integratie, of automatisering workflows.

Welke Data Kan Worden Vastgelegd?

Lead Informatie

• Formulier inzending data (naam, e-mail, telefoon, etc.)
• Gebruikersgedrag data
• Pagina informatie waar conversie plaatsvond
• Tijdstempel van conversie

Marketing Attributie Data

• UTM Parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Platform Tracking ID's: Google Click ID (gclid), Facebook Click/Browser ID (fbc/fbp), TikTok Click ID (ttclid)
• Sessie Data: Sessie ID, aantal sessies, user agent
• Verkeersbron: Verwijzer URL, landingspagina

Webhook Integratie Instellen

Vereisten

• Google Tag Manager Server-Side container geconfigureerd
• AdPage tracking implementatie op je website
• Webhook endpoint van je gekozen platform (Zapier, Make, of N8N)

Stap 1: Configureer de Webhook Client

Je kunt de Webhook client downloaden en importeren door naar deze URL te gaan: GitHub AdPage Webhook client

De AdPage Webhook Client parseert automatisch inkomende lead data en structureert deze voor doorsturen. Het verwerkt:

// Voorbeeld van geparseerde data structuur
{
  "event_name": "trytagging_generate_lead",
  "form_data": {
    "name": "Jan de Vries",
    "email": "jan@voorbeeld.com",
    "phone": "+31612345678"
  },
  "marketing": {
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "zomer-actie",
    "gclid": "abc123...",
    "fbp": "fb.1.1234567890",
    "user_agent": "Mozilla/5.0...",
    "ip": "192.168.1.1"
  },
  "user_data": {
    "first_name": "Jan",
    "last_name": "de Vries",
    "email": "jan@voorbeeld.com",
    "phone": "+31612345678"
  }
}

Stap 2: Maak HTTP Request Tag aan

Configureer de JSON HTTP Request tag om data door te sturen naar je gekozen platform:

1. URL: Je webhook endpoint URL
2. Method: POST
3. Headers: Content-Type: application/json
4. Body: Neem form_data en marketing variabelen op

Je kunt de Gallery functie van Google Tag Manager server side downloaden of gebruiken om de HTTP request tag van Stape te gebruiken: HTTP request tag

Stap 3: Stel Trigger in

Maak een trigger aan die afvuurt wanneer lead data wordt ontvangen:

• Trigger Type: Custom Event of Always
• Voorwaarden:
• • Event Name bevat "generate_lead" of vergelijkbaar
  • Client Name bevat "Webhook"

Je Setup Testen

1. Gebruik GTM Preview Mode

• Schakel preview mode in GTM in en gebruik Webhook testing
• Verstuur een test formulier op je website
• Controleer of de webhook tag correct afvuurt
• Controleer de data die wordt verstuurd

2. Webhook Test Tools

• Webhook.site: Maak tijdelijke webhook URL's aan voor testen
• Postman: Test webhook endpoints handmatig
• Platform test functies: De meeste platformen bieden webhook test utilities

3. Controleer Data Ontvangst

• Controleer de webhook logs van je gekozen platform
• Controleer of alle verwachte velden worden ontvangen
• Test data formatting en structuur

Troubleshooting

Veelvoorkomende Problemen

Webhook Vuurt Niet Af:

• Controleer trigger voorwaarden
• Controleer of event namen overeenkomen
• Zorg ervoor dat client correct is geconfigureerd

Ontbrekende Data:

• Controleer variabele configuraties
• Controleer data layer implementatie
• Bevestig dat marketing data wordt vastgelegd

Platform Integratie Problemen:

• Valideer webhook URL format
• Controleer authenticatie vereisten
• Controleer platform-specifieke payload structuur

Debug Tips

1. Schakel Logging in: Stel log type in op "Always log to console"
2. Gebruik Debug Headers: Voeg trace-id toe voor request tracking
3. Test Incrementeel: Begin met basis data, voeg complexiteit geleidelijk toe
4. Monitor Response Codes: Controleer op 200 OK responses

Beveiligingsoverwegingen

Data Bescherming

• Verstuur alleen noodzakelijke data velden
• Overweeg data encryptie voor gevoelige informatie
• Implementeer juiste toegangscontroles op webhook endpoints

Webhook Beveiliging

• Gebruik alleen HTTPS endpoints
• Implementeer webhook signature verificatie wanneer beschikbaar
• Stel juiste authenticatie headers in

Best Practices

1. Error Handling: Configureer timeout en retry logica
2. Data Validatie: Valideer data voordat je verzendt
3. Monitoring: Stel alerts in voor gefaalde webhooks
4. Documentatie: Onderhoud duidelijke documentatie van data mappings
5. Testen: Test regelmatig webhook functionaliteit

Conclusie

Webhook integratie stelt je in staat om naadloos lead data met complete marketing attributie door te sturen naar je gewenste automatisering platformen. Door deze handleiding te volgen, kun je uitgebreide lead tracking verzekeren die de volledige customer journey context behoudt van eerste klik tot conversie.

Voor technische ondersteuning of geavanceerde configuraties, neem contact op met je implementatie team of raadpleeg platform-specifieke documentatie.

Bijgewerkt op: 06/08/2025