Webhook Purchase Coverage - Troubleshooting Guide

De Webhook Purchase Coverage check vergelijkt het aantal aankopen dat via client-side tracking binnenkomt met het aantal via server-side webhooks. Dit is cruciaal voor:

• Volledigheid van conversie tracking - Alle aankopen worden gemeten

• Ad-blocker bypass - Server-side webhooks omzeilen ad blockers

• Betrouwbare ROAS data - Accurate conversie aantallen in advertentieplatformen

Client-side tracking    →  Gemist door ad blockers (~15-30%)
Server-side webhooks    →  Vangt ALLE aankopen, ongeacht ad blockers

Ideale situatie: Webhook count ≥ Client count (webhooks vangen extra aankopen op)

Oorzaak 1: Webhook niet correct geconfigureerd in e-commerce platform

Symptoom: Webhook count is significant lager dan client-side

Diagnose - Shopify:

1. Ga naar Settings → Notifications → Webhooks

2. Controleer of er een webhook bestaat voor orders/paid of orders/create

3. Verifieer dat de webhook URL correct is

Oplossing Shopify:

1. Ga naar Settings → Notifications → Webhooks

2. Klik op "Create webhook"

3. Selecteer event: Order payment of Order creation

4. Vul de TryTagging webhook URL in

5. Selecteer format: JSON

6. Sla op

Diagnose - WooCommerce:

1. Ga naar WooCommerce → Settings → Advanced → Webhooks

2. Controleer of er een webhook bestaat voor "Order completed"

3. Check de delivery URL en status

Oplossing WooCommerce:

1. Ga naar AdPage Wordpress plugin

2. Check of de juiste Server Side Tagging URL is ingevuld

Oorzaak 2: Webhook trigger op verkeerd moment

Symptoom: Sommige orders komen niet binnen, vooral bij bepaalde betaalmethodes

Probleem: Webhook triggert op order created in plaats van order paid

Oplossing:

Voor betrouwbare tracking moet de webhook triggeren wanneer de betaling is voltooid:

Let op bij betaalmethodes:

• iDEAL, Bancontact, creditcard → Directe betaling, webhook moet direct vuren

• Klarna, Afterpay → Betaling kan later komen

• Bank transfer → Handmatige bevestiging nodig

Oorzaak 3: Webhook endpoint problemen

Symptoom: Webhooks werden verstuurd maar komen niet aan

Diagnose:

1. Check webhook logs in je e-commerce platform

2. Zoek naar failed deliveries of timeouts

3. Controleer HTTP response codes

Veelvoorkomende fouten:

Oplossing bij timeouts:

• Shopify heeft een timeout van 5 seconden

• Zorg dat je endpoint snel (< 2 sec) een 200 OK teruggeeft

• Verwerk de data async indien nodig

Oorzaak: Timing verschillen

Symptoom: Kleine discrepantie tussen client en webhook counts

Verklaring:

• Client-side tracking kan iets sneller zijn dan webhook delivery

• Sommige webhooks kunnen in queue staan

• Timezone verschillen in rapportage

Oplossing:

1. Vergelijk over een langere periode (14 dagen in plaats van 7)

2. Check of de discrepantie consistent is

3. Kleine verschillen (< 5%) zijn vaak acceptabel

Oorzaak: Duplicate transaction IDs client-side

Symptoom: Client count lijkt hoger door duplicaten

Diagnose: Check of dezelfde transactie meerdere keren wordt geregistreerd (bijv. door page refresh op thank you page)

Oplossing:

1. Implementeer deduplicatie op transaction_id

2. Gebruik event_id parameter in GA4 voor deduplicatie

3. Check of thank you page alleen één keer het purchase event vuurt

Dit is vaak positief en kan betekenen:

1. Ad-blocker bypass werkt - Webhooks vangen geblokkeerde client-side events

2. Multi-channel orders - Webhooks bevatten ook:

   • Telefonische orders

   • B2B orders via backend

   • POS (Point of Sale) orders

   • Handmatig aangemaakte orders

Actie: Geen actie nodig, dit is gewenst gedrag.

Als je alleen webhooks gebruikt zonder client-side tracking:

• Dit is een valide setup

• Alle conversies komen via server-side binnen

• 100% ad-blocker bypass

• Check wel of webhook coverage compleet is

• [ ] Webhook bestaat in e-commerce platform

• [ ] Correcte trigger event (order paid/completed)

• [ ] Juiste webhook URL geconfigureerd

• [ ] Webhook status is "Active"

• [ ] Maak een test order

• [ ] Check webhook logs in e-commerce platform

• [ ] Verifieer dat webhook succesvol is afgeleverd (HTTP 200)

• [ ] Controleer of order verschijnt in TryTagging logs

• [ ] Check transaction_id format (moet overeenkomen)

• [ ] Vergelijk timestamps

• [ ] Analyseer over langere periode voor accurate vergelijking

Neem contact op met AdPage support als:

• Webhook coverage blijft onder 80% na configuratie check

• Webhooks worden succesvol verstuurd maar verschijnen niet in TryTagging

• Je een custom e-commerce platform gebruikt

• Transaction ID formats niet overeenkomen tussen client en webhook

Contact: support@adpage.io