OpenAI Ads Conversions API: WordPress-installatiegids

De OpenAI Ads Conversions API in WordPress: server-side events, vergelijking met de pixel, event-ID's, deduplicatie, WooCommerce, formulieren en debuggen.

Laatst bijgewerkt: 3 september 2026. Geschreven door PixelBridge team.

De OpenAI Ads Conversions API is een server-side methode om ondersteunde conversie-events naar de advertentiemeetsystemen van OpenAI te sturen.

Op WordPress betekent dat meestal: een event sturen nadat een formulier, boeking of order is bevestigd, in plaats van alleen op een script in de browser te vertrouwen. PixelBridge is ontworpen om die events te sturen en ze te coördineren met de browserpixel. De Conversions API-koppeling hoort bij de geplande Pro-functies en is nog niet publiek beschikbaar.

Wat de Conversions API is

De Conversions API is een server-naar-serverpad. WordPress, of een andere backend, stuurt een ondersteund conversie-event nadat bekend is dat de actie is geslaagd. De browser hoeft niet de enige boodschapper te zijn.

Het is geen tweede advertentieaccount, en het vervangt geen campagnesetup. Het is een aflevermethode voor meetevents. Officiële requestvelden, authenticatie en ondersteunde eventtypes staan in de developer-documentatie van OpenAI. Bevestig die details voordat je een eigen client bouwt.

PixelBridge is onafhankelijk van OpenAI. De Conversions API via de plugin gebruiken schept geen officieel partnerschap.

Waarom server-side meting ertoe doet

Browserpixels falen in gewone situaties:

De bezoeker weigert meetcookies
Een browser of extensie blokkeert het script
Content Security Policy blokkeert het SDK-domein
De klant sluit de bedankpagina voordat de pixel draait
Een pagebuilder of cacheplugin herschikt scripts

Een server-event kan de conversie nog vastleggen nadat WordPress het formulier, de boeking of de order heeft opgeslagen. Die robuustheid is de reden om de Conversions API toe te voegen. Het is geen reden om de pixel te negeren. Page views en landingscontext komen nog steeds uit de browser.

Server-side aflevering omzeilt consent niet. Als toestemming voor meting nodig is, blijft het server-event achter dezelfde toestemming. Zie cookie consent.

Pixel versus Conversions API

	Browserpixel	Conversions API
Draait waar	Browser van de bezoeker	WordPress / server
Typische events	Page views, client-side conversies	Bevestigde leads, boekingen, aankopen
Sterkte	Snelheid en paginacontext	Bevestiging nadat WordPress de actie vastlegt
Zwakte	Makkelijk te blokkeren	Heeft credentials, ID's en foutafhandeling nodig
Consent	Wacht als dat vereist is	Wacht als dat vereist is

Je kunt met alleen de pixel beginnen. Voeg de Conversions API toe wanneer browserlevering niet genoeg is, of wanneer aankopen en boekingen een bevestigd backendsignaal nodig hebben. Beide gebruiken is een keuze voor robuustheid, geen rankingtruc.

De pixelgids is OpenAI Ads Pixel voor WordPress. Productdocs: Conversions API.

Deduplicatie

Wanneer dezelfde conversie vanuit de browser én vanaf de server wordt gestuurd, heeft meting een manier nodig om ze als één actie te zien. Dat mechanisme is deduplicatie.

Zonder dat kan een geslaagde checkout twee aankopen worden. Met dat mechanisme dragen beide payloads hetzelfde event-ID en kan het advertentiemeetsysteem het paar samenvoegen.

Deduplicatie telt alleen als beide lagen dezelfde conversie sturen. Een lead alleen vanaf de server hoeft niet te mergen. Een page view alleen in de browser mag geen server-tweeling verzinnen.

Event-ID's

Een event-ID is de gedeelde sleutel voor één klanthandeling.

Het beoogde WordPress-patroon:

Maak of hergebruik bij de success-hook één event-ID.
Stuur het browser-event met dat ID, als de pixel mag draaien.
Stuur het server-event met hetzelfde ID, als de Conversions API aanstaat en consent dat toestaat.
Bewaar genoeg van het ID in logs of diagnostiek om een mismatch later te debuggen.

Gebruikt het browser-event één ID en het server-event een ander, dan krijg je duplicaten. Retry je een mislukte servercall met een nieuw ID terwijl het oorspronkelijke browser-event al slaagde, dan kun je ook duplicaten krijgen. Houd het ID stabiel voor die conversie.

PixelBridge is ontworpen om dat ID te maken of te hergebruiken zodat het paar kan worden gededupliceerd.

Implementatie in WordPress

Een WordPress Conversions API-setup is backendwerk:

Bewaar API-credentials in plugininstellingen of omgevingsconfiguratie, niet in een publiek JavaScript-bestand.
Luister naar bevestigde WordPress-hooks, niet naar knopklikken.
Bouw een payload die bij de actuele officiële eventspec past.
Neem het event-ID mee dat het browser-event gebruikt.
Respecteer consent voordat het request de server verlaat.
Leg succes en falen vast in plaats van blind te retryen.

Typische bronnen:

Een bevestigde formulier-success-hook
Een boekingsbevestigingshook
Een WooCommerce-orderstatus die betekent dat de aankoop echt is

Stuur geen server-events vanuit wp_footer op elke pagina. Dan krijg je de slechtste kanten van een pixel, zonder de waarde van page views.

De WordPress-documentatie gaat over hooks en pluginarchitectuur. OpenAI-eventvelden staan daar niet in.

WooCommerce

WooCommerce is een natuurlijke Conversions API-bron omdat de order op de server bestaat, ook als de klant de thank-you-pixel nooit ziet.

Als aankooptracking live gaat, moet het event:

Vuren op de orderstatus die jij als conversie ziet
Een order-ID bevatten
Een conversiewaarde bevatten waar dat is toegestaan
Een event-ID delen met een eventueel browser-purchase-event

De WooCommerce-integratie komt nog. Die is niet uitgebracht. Verwacht niet dat orders OpenAI Ads-events sturen tot die connector bestaat, of tot je zelf een custom hook bouwt.

Formulierverzendingen

Formulieren zijn de andere veelvoorkomende server-side bron. Een PHP-success-hook kan lead_created sturen nadat het bericht is opgeslagen. Dat is betrouwbaarder dan een JavaScript-listener op de verzendknop.

Geplande formulierconnectors (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) komen nog. Tot die tijd vuurt een custom implementatie één keer per geslaagde verzending en slaat validatiefouten over.

Triggert het formulier ook een browser-event, gebruik dan hetzelfde event-ID op beide.

Debuggen

Debug browser en server als paar.

Bevestig dat het pixelpad nog werkt. Een kapotte pixel plus een kapotte API lijkt op "CAPI ligt eruit" terwijl het echte probleem consent of een Pixel ID-mismatch is.
Trigger één conversie.
Kijk of er een browser-event is verstuurd.
Kijk of er een server-event is verstuurd.
Vergelijk event-ID's.
Inspecteer de serverrespons. Houd failures zichtbaar.

De diagnostiek van PixelBridge is ontworpen om de verbindingsstatus van de Conversions API en de verzendstatus van recente events te tonen. Een geplande waarschuwing is "browser-event verstuurd, server-event mislukt". Die check is gepland, niet als geleverd geclaimd. Zie diagnostiek en problemen oplossen.

Veelvoorkomende fouten

Fout	Wat het meestal betekent
Helemaal geen server-event	CAPI niet geconfigureerd, of de WordPress-hook liep nooit
401 / auth-fout	Credentials ontbreken, zijn geroteerd of staan op de verkeerde plek
Event geweigerd	Payloadvelden passen niet bij de actuele officiële spec
Dubbele conversies	Ontbrekende of ongelijke event-ID's
Server-event na consentweigering	Consent niet toegepast op het backendpad
Staging-events in een productieproperty	Verkeerd Pixel ID of verkeerde API-bestemming

Eventnamen en verplichte velden kunnen wijzigen. Wordt een payload geweigerd, check dan eerst de officiële OpenAI-documentatie voordat je WordPress-hooks aanpast.

Setup in PixelBridge

PixelBridge is ontworpen om Conversions API-events vanuit WordPress te sturen en ze te coördineren met browser-events. Die setup is gepland, niet gelanceerd.

Beoogde configuratie, zodra Pro beschikbaar is:

Vul het Pixel ID in en maak browsermeting eerst rond.
Voeg Conversions API-credentials toe in de plugininstellingen.
Zet alleen conversies aan die je in de browser al vertrouwt, of die alleen op de server bestaan.
Controleer of de diagnostiek een verbinding toont en één verzending per testactie.

Tot de lancering: meld je aan voor early access via de homepage. Lees features en prijzen voor de geplande verdeling Free, Pro en Agency. Pro is de geplande plek voor Conversions API, deduplicatie, WooCommerce en bookingintegraties.

Voor het bredere meetmodel, ga verder met OpenAI Ads conversietracking.