Er is een bestelling geplaatst in de webshop, maar Meta ziet die niet. Soms ziet Meta de bestelling twee keer. Het team stuurt campagnes vervolgens bij met cijfers die het niet vertrouwt, en het eerste idee is: laten we CAPI implementeren, dan lost het alles op.
Conversions API kan metingen nauwkeuriger maken, omdat het bepaalde marketinggebeurtenissen vanaf de server, CRM of het platform rechtstreeks naar de systemen van Meta stuurt. Maar de API herstelt geen gegevens die het bedrijf nooit aanmaakt en corrigeert ook geen conversies met slechte namen. Eerst heb je een meetplan nodig. Pas daarna volgt de gegevensoverdracht.
CAPI vervangt de Pixel of toestemming niet
Meta beschrijft Conversions API als een directere verbinding tussen de marketinggegevens van een bedrijf en zijn systemen voor het meten en optimaliseren van advertenties. Voor webgebeurtenissen raadt Meta aan CAPI te overwegen in combinatie met de Meta Pixel. Browser- en serverroutes kunnen elkaar aanvullen.
Dat betekent niet dat de server alles mag versturen wat de browser niet heeft verstuurd. Meta stelt uitdrukkelijk dat CAPI niet is ontworpen om privacyregels, Europese regelgeving of platformbeperkingen te omzeilen. Behandel toestemming en de rechtmatigheid van verwerking op basis van de specifieke gegevens, regio en juridische beoordeling. Een gehasht e-mailadres is nog steeds van een persoon afgeleide informatie, geen rookgordijn.
Bepaal eerst welke gebeurtenissen bedrijfswaarde hebben
Voor een webshop is het meestal zinvol om het traject te meten vanaf het bekijken van een product, via winkelmandje en checkout, tot aan de aankoop. Voor een leadgeneratiewebsite kan een verzonden formulier of gekwalificeerde lead belangrijker zijn. Ik zou niet elke klik als conversie versturen alleen omdat het kan.
Leg voor elke gebeurtenis vast:
- wat er precies in de echte wereld moet gebeuren,
- of het de belangrijkste bedrijfsuitkomst is of slechts een diagnostisch signaal,
- welk systeem de bron van waarheid is,
- welke unieke identificatie je gebruikt,
- welke parameters advertenties en rapportages nodig hebben,
- onder welke voorwaarden je de gegevens mag versturen.
Bij een aankoop is de bron van waarheid vaak de bevestigde bestelling in de webshop of backend, niet alleen het openen van de bedankpagina. Bij een lead kan het formulier het eerste signaal zijn, maar alleen het CRM bevestigt de kwaliteit van het contact.
Deduplicatie bepaalt of dubbele meting helpt
Wanneer je dezelfde gebeurtenis zowel via de Pixel als via de server verstuurt, moet Meta deze als één gebeurtenis herkennen. Daarvoor zijn dezelfde gebeurtenisnaam en dezelfde event_id nodig in beide routes.
Voor een aankoop kan een stabiele bestel-ID een geschikte basis zijn. Maak voor een gebeurtenis zonder eigen bedrijfs-ID een unieke identificatie aan op het moment dat de actie plaatsvindt en geef die door aan zowel de browser- als serverlaag. Een willekeurige identificatie die aan beide kanten afzonderlijk wordt gegenereerd, helpt niet — de waarden komen niet overeen.
Deduplicatie is geen detail voor een ontwikkelaar. Als deze mislukt, kunnen campagnes een dubbel signaal ontvangen en gaat rapportage liegen.
Vier implementatieroutes hebben verschillende kosten
Een partner of functie van een e-commerceplatform
Voor een gebruikelijke webshop is dit vaak de eerste keuze. Het platform onderhoudt de integratie voortdurend en het bedrijf hoeft geen API-code te beheren. Controleer wel welke gebeurtenissen worden verzonden, of deduplicatie en toestemming worden afgehandeld en of je de parameters kunt bekijken.
Een beheerde dienst of gateway
Een provider neemt een deel van de infrastructuur en updates over. Je betaalt voor beheer en afhankelijkheid, maar vermindert je eigen technische onderhoud. Dit is zinvol als de dienst je stack ondersteunt en je duidelijke toegang tot diagnoses hebt.
Server-side Google Tag Manager
Een servercontainer kan verschillende overdrachten van marketinggegevens samenbrengen en het bedrijf meer controle geven. Tegelijkertijd voegt deze hosting, templates, rechten en een extra testlocatie toe. Ik zou hiervoor niet kiezen alleen vanwege een mooi architectuurdiagram.
Een aangepaste rechtstreekse integratie
Deze biedt de meeste flexibiliteit en ook de grootste verantwoordelijkheid. Je hebt veilig tokenbeheer, invoervalidatie, logging zonder gevoelige gegevens te lekken, herstel na fouten, beheer van API-versies en iemand nodig die de integratie onderhoudt.
Het oorspronkelijke artikel bevatte een kort PHP-script en een openbaar toegankelijk endpoint. Ik raad een dergelijke oplossing niet langer aan als algemene handleiding. De oplossing bevatte een oude API-versie en te veel aannames over beveiliging en beheer. Code die vandaag na kopiëren werkt, kan morgen stilzwijgend gebeurtenissen laten vallen. Werk voor een rechtstreekse integratie vanuit de actuele documentatie van Meta en doe normale ontwikkeling, geen copy-and-paste-marketing.
De kwaliteit van gebeurtenissen is belangrijker dan het aantal parameters
Een server-side gebeurtenis heeft doorgaans een naam, tijdstip, actiebron en URL of andere context nodig, afhankelijk van de bron. Voeg voor een zakelijke gebeurtenis de relevante waarde, valuta, items en stabiele ID toe. Verstuur gebruikersidentificaties alleen als je deze mag hebben, ze correct zijn genormaliseerd en de vereiste indeling hebben.
Meer identificaties kunnen de matching verbeteren, maar ‘meer is beter’ geldt niet zonder grenzen. Verstuur geen lege, verzonnen of verouderde waarden. Maak al helemaal geen fingerprint om de keuze van de gebruiker te omzeilen.
De test moet de volledige klantreis omvatten
- Start de testmodus in Meta Events Manager.
- Doorloop een realistisch scenario vanaf het bezoeken van de website tot en met een bestelling of lead.
- Controleer de browser- en servergebeurtenissen, hun parameters en overeenkomende ID's.
- Controleer of Meta het paar dedupliceert en geen diagnostische fout weergeeft.
- Vergelijk waarde, valuta en ID met de backend of het CRM.
- Test zowel het geven als weigeren van toestemming volgens je oplossing.
- Monitor na implementatie diagnoses en uitval over tijd, niet alleen één geslaagde test.
Test Events bevestigt dat het technische bericht is aangekomen. Het bevestigt niet dat je de juiste conversie hebt geselecteerd of dat de integratie juridisch compliant is.
CAPI en GA4 zijn twee verschillende lagen
CAPI stuurt gebeurtenissen naar Meta voor meting en advertentieoptimalisatie. GA4 analyseert de website en app over verschillende bronnen heen. De cijfers kunnen verschillen door attributie, toestemming, identiteit en verwerking. Ik probeer ze niet geforceerd exact gelijk te maken; eerst controleer ik of elk systeem technisch correcte gegevens ontvangt en of we deze voor de juiste beslissing gebruiken.
Als je een gedeeld overzicht van kosten en websiteresultaten nodig hebt, lees dan ook Meta Ads verbinden met GA4. De Google Tag Manager-gids behandelt de tagimplementatie zelf, en de gids voor GA4 legt de betekenis van gebeurtenissen uit.
Wanneer ik CAPI nog niet zou implementeren
Als het bedrijf zijn conversies niet heeft gedefinieerd, niet weet welke bestelling geldig is of de huidige Pixel niet kan onderhouden, vergroot een server-side route de chaos. Los eerst de brongegevens en het meetplan op. CAPI is zinvol wanneer je weet welk signaal je wilt leveren, waarom Meta dit nodig heeft en wie de integratie beheert.
Als je de kleinste verstandige oplossing voor je webshop of leadgeneratiewebsite wilt kiezen, stuur me dan via contact het platform, de huidige meetopstelling en de gebeurtenis die voor je bedrijf het belangrijkst is.