Gids
ChatGPT Pixel of Conversions API? Het verschil uitgelegd
De Measurement Pixel van ChatGPT Ads is JavaScript dat in de browser van de klant draait. De Conversions API is een endpoint dat je server aanroept. De Pixel ziet wat een klant op de pagina doet; de Conversions API meldt wat je eigen systemen hebben zien gebeuren. Het zijn niet zozeer alternatieven als twee helften: in een webshop gebruik je meestal de Pixel voor de klantreis en verstuur je de aankoop via allebei, met een gedeeld event-ID dat ze aan elkaar koppelt.
Bijgewerkt
Op deze pagina
Kort antwoord: gebruik de Pixel voor events die alleen de browser ziet, zoals productweergaven en toevoegen aan winkelwagen. Verstuur de aankoop vanuit de browser én vanaf de server met hetzelfde event-ID. Zo raak je de verkoop niet kwijt door een geblokkeerd script of een gesloten tabblad, en telt OpenAI hem één keer.
In één oogopslag
Browser tegenover server, in vier vragen
De Pixel ziet de klantreis. De Conversions API bevestigt de verkoop. Samen, met één event-ID, tellen ze elke aankoop één keer.
In de browser
Measurement Pixel
- Sterk in
- De klantreis op de pagina meten.
- Wat hij ziet
- Productweergaven, toevoegen aan winkelwagen, het begin van het afrekenen en de aankoop: alles wat in de browser van de klant gebeurt.
- Wat hij kan missen
- Events waarvan het script wordt geblokkeerd, of waarvan de pagina nooit helemaal laadt.
- Wat deze plugin verstuurt
- Alle vier de events:
contents_viewed,items_added,checkout_started,order_created.
Op de server
Conversions API
- Sterk in
- Conversies bevestigen die je eigen systemen hebben vastgelegd.
- Wat hij ziet
- Wat de webshop weet: de betaalde bestelling, het bedrag en het tijdstip.
- Wat hij kan missen
- Het surfgedrag: hij weet niet dat een product is bekeken, tenzij de browser dat heeft gemeld.
- Wat deze plugin verstuurt
- Alleen de aankoop:
order_created, zodra WooCommerce de bestelling als betaald markeert.
Versturen beide routes dezelfde aankoop, dan hebben ze hetzelfde event-ID. OpenAI houdt de eerste die binnenkomt en negeert het duplicaat, dus de bestelling telt één keer.
Browser · Pixel
Aankoop
Gedeeld event-ID, afgeleid van de WooCommerce-bestelling
Server · Conversions API
Aankoop
Gedeeld event-ID, afgeleid van de WooCommerce-bestelling
Eén conversie
Zelfde Pixel-ID, eventnaam en ID: OpenAI houdt de eerste en negeert het duplicaat.
Waar de Pixel voor dient
De Pixel is de enige manier om te meten wat er gebeurt tussen de klik op een advertentie en de betaling: welke producten zijn bekeken, wat er in de winkelwagen ging, wie bij het afrekenen kwam. OpenAI raadt aan de pixel altijd in de browser te gebruiken. Hij regelt ook de toestemming op de pagina: staat de toestemming op false, dan verstuurt hij geen meetpings.
Zijn zwakte is die van elk browserscript: wordt het script geblokkeerd of laadt de pagina nooit helemaal, dan wordt het event niet verstuurd, en nergens wordt vastgelegd dat het is gemist.
Waar de Conversions API voor dient
De Conversions API meldt events die je server al kent. Voor een webshop is dat de aankoop: de bestelling staat in de database, of een browser haar nu heeft gemeld of niet. De server kan haar versturen zodra de betaling bevestigd is, het opnieuw proberen als het verzoek mislukt, en vastleggen hoe het is afgelopen.
Zijn zwakte is dat de server het surfgedrag niet ziet. Hij weet niet dat iemand een product heeft bekeken, tenzij iets in de browser dat heeft gemeld. Bovendien moet de API-key geheim blijven: volgens OpenAI verstuur je Conversions API-events uitsluitend vanaf je eigen server.
Alleen de Pixel, alleen de API, of allebei
| Opstelling | Wat je krijgt | Wat je mist |
|---|---|---|
| Alleen de Pixel | De volledige klantreis in de browser en de meeste aankopen | Aankopen waarvan het browser-event nooit is verstuurd |
| Alleen de Conversions API | Aankopen, los van de browser | Productweergaven, winkelwagens en het begin van het afrekenen |
| Allebei, met gedeelde ID's | De klantreis uit de browser, en de aankoop via beide routes | Events die alleen in de browser bestaan, blijven van de browser afhankelijk |
Welk event via welke route in een webshop
| Event | Pixel | Conversions API | Waarom |
|---|---|---|---|
contents_viewed | Ja | — | Alleen de browser ziet een productweergave |
items_added | Ja | — | De winkelwagen wordt op de pagina gevuld |
checkout_started | Ja | — | Bij het afrekenen komen is een pagina-event |
order_created | Ja | Ja | De verkoop wordt door de webshop zelf vastgelegd |
De aankoop is het event dat het waard is om twee keer te versturen: daarop worden campagnes beoordeeld, en de webshop kan hem zelfstandig bevestigen.
Naslag
Pixel en Conversions API naast elkaar
De volledige vergelijking, regel voor regel.
| Measurement Pixel | Conversions API | |
|---|---|---|
| Draait in | De browser van de klant | Je server |
| Gegevens | Pixel-ID (openbaar) | Pixel-ID plus een geheime API-key |
| Ziet surfgedrag | Ja: weergaven, winkelwagen, afrekenen | Alleen wat je server vastlegt |
| Last van geblokkeerde scripts of gesloten tabbladen | Ja | Nee: vertrekt vanuit je eigen gegevens |
| Kan een latere betaling bevestigen | Alleen als de klant nog op de pagina is | Ja, zodra de betaling bevestigd is |
| Toestemming | Verstuurt niets als de toestemming op false staat | Je implementatie moet haar toepassen |
| Implementatie | Script op elke pagina, plus code voor de events | Servercode, een startsein, nieuwe pogingen |
Bronnen: de documentatie van OpenAI over de Measurement Pixel en de Conversions API (beide Engelstalig).
Allebei gebruiken zonder dubbeltelling
Dezelfde aankoop twee keer versturen werkt alleen als OpenAI kan zien dat het om dezelfde aankoop gaat. De documentatie van de Pixel zegt dat je de event_id zelf aanmaakt en hergebruikt voor hetzelfde pixel-event en server-event. OpenAI gebruikt vervolgens het eerste event dat binnenkomt met een overeenkomende sleutel (Pixel-ID, eventnaam en ID) en negeert latere duplicaten.
Wat de deduplicatie breekt
- Een willekeurig ID dat in de browser wordt aangemaakt en dat de server nooit te zien krijgt.
- Een nieuw ID bij elke paginalading, waardoor een herladen bedankpagina eruitziet als een nieuwe aankoop.
- Een tweede exemplaar van de Pixel, in een thema of tagmanager geplakt, dat events met eigen ID's verstuurt.
- Verschillende Pixel-ID's in de browser en op de server.
Misverstanden
Veelvoorkomende misverstanden
Vier dingen die mensen vaak aannemen over server-side meten, en hoe het echt zit.
Aanname
‘Server-side betekent dat elk event server-side gaat.’
In de praktijk
Niet per se. Pixel for ChatGPT Ads verstuurt bijvoorbeeld alleen de aankoop vanaf de server.
Aanname
‘Als ik via beide routes verstuur, verdubbelen mijn conversies.’
In de praktijk
Niet met een gedeeld event-ID. Zonder dat ID kan het wel.
Aanname
‘Met de Conversions API omzeil je toestemming.’
In de praktijk
Dat hoort niet. Een server-event moet de toestemming volgen die voor die bestelling is vastgelegd.
Aanname
‘Server-side garandeert attributie.’
In de praktijk
Het maakt de levering van de aankoop betrouwbaarder. Over de attributie beslist nog altijd OpenAI.
Pixel en Conversions API in WooCommerce
Pixel for ChatGPT Ads is een WooCommerce-plugin om ChatGPT Ads-conversies te meten. Hij laadt de Pixel voor contents_viewed, items_added, checkout_started en order_created, en verstuurt order_created via de Conversions API zodra WooCommerce de bestelling als betaald markeert. Beide aankopen hebben een event-ID dat van de bestelling is afgeleid.
De gids over de Conversions API voor WooCommerce gaat dieper in op de serverkant: het startsein, de 7-dagenregel en nieuwe pogingen.
Vragen
Is de ChatGPT Pixel hetzelfde als de OpenAI Measurement Pixel?
Ja. ‘ChatGPT Pixel’ en ‘OpenAI Ads-pixel’ zijn gangbare namen voor de OpenAI Measurement Pixel die ChatGPT Ads gebruikt.
Kan ik de Conversions API gebruiken zonder de Pixel?
Ja, maar dan mis je de events uit het surfgedrag: productweergaven, toevoegen aan winkelwagen en het begin van het afrekenen. Die ziet alleen de browser.
Welke installeer ik als eerste?
De Pixel, want die dekt de hele klantreis. Voeg daarna de server-side aankoop toe met hetzelfde event-ID, zodat de verkoop niet van de browser afhangt.
Beide routes, ingericht voor WooCommerce
Pixel for ChatGPT Ads draait de Pixel voor de klantreis en verstuurt de aankoop server-side met een gedeeld event-ID.
Verwante gidsen
- ChatGPT Pixel voor WooCommerceWat de plugin vanuit een WooCommerce-webshop naar ChatGPT Ads stuurt, hoe je hem instelt en wat hij niet doet.
- OpenAI Conversions API voor WooCommerceWanneer en hoe een WooCommerce-aankoop server-side wordt verstuurd, en wat server-side meten niet oplost.
- ChatGPT Pixel installeren in WooCommerceWat je nodig hebt, waar Pixel-ID en API-key vandaan komen, het instellen en hoe je de eerste bestelling controleert.