OpenAI Ads WooCommerce conversietracking

Hoe WooCommerce-aankopen gemeten moeten worden met OpenAI Ads, inclusief order-ID, conversiewaarde, browser- en serverevents, consent en de geplande PixelBridge-setup.

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

WooCommerce-aankooptracking voor OpenAI Ads moet een purchase-event sturen nadat de order is bevestigd, niet wanneer iemand de checkout opent of een product in de winkelwagen legt. Het event hoort een orderidentificatie mee te geven, plus conversiewaarde en valuta waar dat is toegestaan, en een gedeeld event-ID als dezelfde conversie ook via de Conversions API gaat. Meetconsent moet binnen zijn voordat een browser- of serverevent de site verlaat. PixelBridge is hiervoor ontworpen. De plugin-koppeling is nog niet beschikbaar.

Waar deze integratie voor is

WooCommerce slaat orders, totalen, klantdata en orderstatus al op. OpenAI Ads-meting heeft een conversie-event nodig dat die aankoop vertegenwoordigt, zodat advertentierapporten een bevestigde of betaalde order kunnen koppelen aan campagneactiviteit.

PixelBridge is een onafhankelijke WordPress-plugin voor die meetlaag. Het is geen officieel OpenAI- of WooCommerce-product en het maakt geen campagnes. De WooCommerce-connector hoort bij de eerste geplande integraties. Tot die live is, is niets op deze pagina een werkende pluginfunctie.

Voor de winkel zelf begin je bij de officiële WooCommerce-documentatie. Voor het meetcontract van advertenties gebruik je de Measurement Pixel-docs van OpenAI en de Conversions API-docs. Eventnamen en verplichte velden kunnen wijzigen. Controleer die in de officiële OpenAI-documentatie voordat je een payload als definitief behandelt.

Hoe aankooptracking zou moeten werken

Een bruikbaar purchase-event is een afgeronde commerciële actie. In WooCommerce betekent dat meestal: er bestaat een order en die heeft een status die jouw winkel als echt beschouwt, bijvoorbeeld processing of completed, afhankelijk van de betaalmethode.

De beoogde volgorde is:

  1. De koper rondt checkout af.
  2. WooCommerce maakt een order aan en geeft een identificatie.
  3. Als meetconsent is gegeven, kan een browser-purchase vuren op de order-received- of bedanktpagina.
  4. Als de Conversions API aanstaat, kan WordPress een bijbehorend serverevent sturen nadat de order in PHP is bevestigd.
  5. Beide payloads delen één event-ID, zodat OpenAI Ads-meting ze als één conversie kan zien.

Stuur geen purchase bij:

  • Productpageviews
  • Add to cart
  • Het laden van de checkoutpagina
  • Mislukte of geannuleerde betalingen
  • Conceptorders in de admin die een klant nooit heeft geplaatst

Een pageview op een product- of winkelwagen-URL kan nog steeds page_viewed zijn als je pageviews meet. Dat is geen aankoop. Zie conversie-events voor het verschil tussen die eventtypes.

Orderidentificatie

Elk purchase-event heeft een stabiele orderidentificatie nodig. WooCommerce heeft die al: het order-ID, en vaak een apart ordernummer als je een numbering-plugin gebruikt.

Die identificatie is nuttig voor drie dingen:

  • Debuggen: je kunt een meetevent aan een WooCommerce-order koppelen.
  • Deduplicatie: browser- en serverevents kunnen naar dezelfde order wijzen.
  • Latere acties: als refunds ooit worden ondersteund, is de oorspronkelijke order de koppeling.

Gebruik de identificatie die na checkout niet meer verandert. Als je winkel een opgemaakt ordernummer aan klanten toont, kies of meting het interne ID of het klantnummer gebruikt, en houd die keuze gelijk op browser- en serverevents.

Genereer geen nieuw willekeurig ID op de bedanktpagina als een serverevent ook het order-ID meestuurt. Dan lijken het twee verschillende conversies.

Conversiewaarden

Een aankoopconversie is veel bruikbaarder met een waarde en een valuta. Typische bronnen in WooCommerce zijn het ordertotaal en de winkelvaluta.

Plan de waarde bewust:

  • Bepaal of de waarde btw, verzendkosten en toeslagen bevat.
  • Gebruik dezelfde regel op browser- en serverevents.
  • Stuur de winkelvaluta, geen hardcoded fallback, tenzij de order zelf in een andere valuta staat.
  • Stuur geen waarde voor een onbetaalde of mislukte order.

Waarde is niet hetzelfde als omzet in je winkelrapporten. WooCommerce-totalen kunnen later kortingen, refunds of multi-currency-aanpassingen bevatten. OpenAI Ads-meting ziet alleen wat jij stuurt. Houd de mapping eenvoudig en leg die vast voor je team.

Als consent of je privacystatement geen waarde toestaat, laat het veld weg in plaats van te gokken. Een purchase zonder waarde is nog steeds een conversie. Een verzonnen waarde is slechter dan geen waarde.

Browserevents

Het browserevent is de client-side purchase nadat de pixel is geladen. Bij WooCommerce is de natuurlijke plek de order-received-pagina, nadat WooCommerce een geslaagde order heeft getoond.

Een gepland browserevent moet wachten op:

  1. Initialisatie van de OpenAI Ads Pixel met je Pixel ID.
  2. Meetconsent, als je site dat vereist.
  3. Bewijs dat deze pagina bij een echte order hoort, niet bij een generiek bedankt-template zonder orderobject.

Bedanktpagina's gaan vaak mis. Sommige themes laden hetzelfde template bij mislukte betalingen. Sommige checkoutplugins vervangen de standaard order-received-endpoint. Sommige caches serveren een bedanktpagina zonder ordercontext. De integratie moet het WooCommerce-orderobject lezen, niet aannemen dat elk bezoek aan /checkout/order-received/ een aankoop is.

Browserevents kunnen worden geblokkeerd door extensies, strenge browsers, Content Security Policy of een cookiebanner die nooit meetconsent geeft. Daarom hoort een serverevent bij het ontwerp. Dat is een aanvulling, geen manier om consent te negeren. Zie OpenAI Ads Pixel voor WordPress voor hoe de pixel zelf moet laden.

Server-side events

De Conversions API stuurt dezelfde conversie vanuit WordPress nadat de order in PHP is bevestigd. Dat helpt als de bedanktpagina nooit laadt, de koper het tabblad sluit, of de browserpixel wordt geblokkeerd.

Een gepland WooCommerce-serverevent moet vuren vanaf een order-lifecycle-hook, niet vanuit een generieke wp_footer. De hook moet een bevestigde order vertegenwoordigen. Betaalmethodes verschillen: sommige zetten de order meteen op processing, andere wachten op een webhook. De integratie moet de status volgen die voor die gateway "deze aankoop is echt" betekent.

Serverevents hebben nog steeds nodig:

  • Het Pixel ID
  • De eventnaam (purchase)
  • De orderidentificatie
  • Waarde en valuta waar toegestaan
  • Het gedeelde event-ID
  • Attributiedata zoals oppref wanneer die beschikbaar is
  • Dezelfde consentregel als het browserevent

De Conversions API-koppeling in de plugin hoort bij de geplande Pro-functies en is nog niet publiek beschikbaar. Lees Conversions API en de officiële Conversions API-documentatie voor het actuele veldcontract.

Deduplicatie

Als je voor één WooCommerce-order zowel een browserevent als een serverevent stuurt, moet OpenAI Ads-meting kunnen zien dat het dezelfde actie is. Daarvoor is een gedeeld event-ID.

Het beoogde model is:

  1. WordPress maakt of bewaart één event-ID voor de order.
  2. Het browserevent bevat dat ID.
  3. Het serverevent bevat hetzelfde ID.
  4. Beide events gebruiken hetzelfde Pixel ID en dezelfde eventnaam.

Zonder dat gedeelde ID kunnen een geslaagde bedanktpagina plus een geslaagde serverhook op twee aankopen lijken. Met dat ID kan een geblokkeerd browserevent nog steeds één geldige serverconversie achterlaten.

Hergebruik één event-ID niet voor verschillende orders. Maak geen nieuw ID bij elke refresh van de bedanktpagina. De order is de eenheid van conversie.

Aankooptracking blijft advertentiemeting. Als je juridische setup dat als optioneel behandelt, mag de WooCommerce-integratie de pixel niet laden, geen browser-purchase sturen en geen Conversions API-event sturen totdat de vereiste toestemming er is.

Consent is geen WooCommerce-instelling. Het komt meestal van een cookiebanner of consentplugin. PixelBridge is ontworpen om die staat te lezen in plaats van een tweede banner toe te voegen. Zie consent.

Een paar WooCommerce-specifieke valkuilen:

  • Checkout kan slagen terwijl de banner nog niet is beantwoord.
  • Sommige winkels geven wel statistiekconsent, maar geen marketing- of meetconsent.
  • Serverevents moeten dezelfde toestemming volgen als browserevents. Een PHP-hook is geen achterdeur.

Deze pagina is implementatiebegeleiding, geen juridisch advies.

Refunds

WooCommerce kan een order volledig of gedeeltelijk restitueren. Refund- of correctie-events voor OpenAI Ads worden door PixelBridge nog niet ondersteund.

Tot refund-ondersteuning bestaat:

  • Stuur geen tweede purchase met een negatieve waarde als workaround.
  • Verwijder het oorspronkelijke purchase-event niet uit je eigen logs in de verwachting dat advertentierapporten dat volgen.
  • Behandel de oorspronkelijke purchase als de conversie die is verstuurd, en wacht op een gedocumenteerde refund-mapping.

Als refund-events later worden toegevoegd, moeten ze naar de oorspronkelijke orderidentificatie verwijzen en de officiële meetregels van OpenAI Ads volgen. Dat werk is niet uitgebracht.

Geplande setup

Als de WooCommerce-integratie uitkomt, is het beoogde WordPress-pad:

  1. Installeer PixelBridge wanneer de plugin beschikbaar is. De publieke listing is nog niet live. Zie installatie.
  2. Vul je OpenAI Ads Pixel ID in.
  3. Zet WooCommerce-aankooptracking aan in de plugininstellingen.
  4. Kies de orderstatus die voor jouw betaalmethodes als aankoop moet tellen.
  5. Bepaal of browserevents, serverevents of beide moeten vuren.
  6. Bevestig de consentregels voordat een event is toegestaan.
  7. Plaats een testorder op een staging-site en controleer de diagnostiek.

Tot die tijd plak geen purchase-JavaScript in een WooCommerce-bedankt-template en neem niet aan dat dit de toekomstige plugin volgt. Een tijdelijke handmatige test kan, maar het is niet de ondersteunde integratie.

Problemen oplossen

Als een WooCommerce-aankoop niet in OpenAI Ads-meting verschijnt, loop de problemen in deze volgorde na:

  1. Controleer of de integratie daadwerkelijk is uitgebracht. Als deze pagina nog "binnenkort" zegt, is de hook niet live.
  2. Controleer of het Pixel ID bij het advertentieaccount hoort.
  3. Controleer of de koper een bevestigde order heeft, geen checkout- of mislukte-betalingscherm.
  4. Geef meetconsent en probeer opnieuw.
  5. Controleer of de bedanktpagina is gecached zonder ordercontext.
  6. Controleer of een custom checkoutplugin de standaard order-received-flow heeft vervangen.
  7. Als beide browser- en serverevents gepland zijn, controleer of ze een event-ID delen.
  8. Bekijk diagnostiek en de gids voor problemen oplossen.

Een ontbrekende oppref betekent niet altijd dat tracking is mislukt. Het kan betekenen dat het bezoek niet van een OpenAI-advertentie kwam. Zie oppref-attributie.

Gerelateerd

Gerelateerde gidsen