1. De bestelwebhook aanmaken
- Shopify-admin: Instellingen > Meldingen, dan Webhooks.
- Klik op Webhook aanmaken, kies het event Order payment en het JSON-formaat, met als bestemming:
https://serverside.datafirefly.com/v1/shopify/UW-SITE-ID
waarbij uUW-SITE-IDvervangt door de exacte Site ID van de pagina van uw site. - Aanbevolen: voeg ook Refund creation toe zodat terugbetalingen doorkomen. Checkout creation en Cart creation zijn alleen nuttig zolang de DataFirefly-pixel nog niet is geplaatst.
Kies Order payment, nooit Order creation: die laatste wordt ook geactiveerd bij onbetaalde bestellingen en veroorzaakt dubbeltellingen.
2. Het signing secret plakken
- Onderaan de pagina Webhooks toont Shopify het signing secret: kopieer het.
- Plak het in het veld "Shopify webhook signing secret" op uw DataFirefly-sitepagina en sla op.
3. De DataFirefly-pixel plaatsen
- Shopify-admin: Instellingen > Klantgebeurtenissen, en voeg daar een aangepaste pixel toe.
- Plak de snippet uit de Shopify-gids van uw klantomgeving (pagina Modules).
- Zodra de pixel actief is, verwijdert u de webhooks Checkout creation en Cart creation: de pixel vervangt ze.
ChatGPT Ads
De aankoop wordt vanaf de server verstuurd, via de ondertekende Order payment-webhook. De referentie van de advertentieklik (oppref en obref) wordt vastgelegd door de DataFirefly-pixel uit stap 3, die u in de Shopify-admin plakt (Instellingen > Klantgebeurtenissen) en niet in het thema: de pixel koppelt de referentie aan de checkout, en de server voegt ze toe aan de aankoop. Ze wordt alleen vastgelegd met marketingtoestemming.
Gebruikt u ook een eigen OpenAI-pixel, vervang dan de aankoopaanroep daarvan door de code uit de Shopify-gids van uw klantomgeving, zodat de aankoop in de browser hetzelfde event-ID krijgt als die op de server (shopify-order- gevolgd door het ordernummer). Anders schakelt u het aankoopevent in uw eigen OpenAI-pixel uit.
Toestemming
De DataFirefly-pixel volgt de marketingtoestemming die in Shopify is vastgelegd. Weigert een bezoeker marketing, dan stuurt de pixel diens events als geweigerd gemarkeerd naar DataFirefly, zonder enige verwijzing naar een advertentieklik, en wordt daarvan niets doorgestuurd naar de advertentieplatformen. Bestellingen komen echter binnen via ondertekende webhooks die geen toestemmingssignaal bevatten; daarvoor geldt het toestemmingsbeleid van uw winkel.
Controleren
- Plaats een betaalde testbestelling: die moet als Delivered verschijnen in de Monitoring.
- De knop "Diagnose my connection" bevestigt de ontvangst van de laatste events.
Bij problemen
- Een webhook die ongeveer 48 uur blijft mislukken, wordt automatisch verwijderd door Shopify. Is de webhook verdwenen, controleer dan de Site ID in de URL, maak hem opnieuw aan en houd de Monitoring in de gaten.
- Dubbele bestellingen? Controleer of er geen webhook Order creation is achtergebleven.
- De andere veelvoorkomende oorzaken vindt u in de gids probleemoplossing.
Bijgewerkt: 1 september 2026