OpenAI Ads (ChatGPT Ads) koppelen aan cPixel

Hoe koppel ik OpenAI Ads aan cPixel?

Open in OpenAI Ads Manager Tools, dan Conversions: de Pixel ID staat afgedrukt onder je databron op het tabblad Data Source, en het sleutelicoon in de paginakop maakt een Conversions API key aan, die maar één keer wordt getoond. Plak beide in cPixel, dat vervolgens paginaweergaven, productweergaven, toevoegingen aan het winkelwagentje, checkouts en aankopen vanaf zijn servers naar ChatGPT Ads verzendt.

Plak ze in cPixel

  1. Open in cPixel Bestemmingen en klik op het OpenAI Ads-icoon onder Een platform koppelen. OpenAI Ads instellen opent op Plak je ID’s.
  2. Plak de Pixel ID (waar vind je die) en de Conversions API key (hoe maak je die aan); beide zijn verplicht. Geef het account desgewenst een naam onder Geef dit account een naam (optioneel).
  3. Klik op Verbinding testen. OpenAI valideert een testevent zonder het te registreren, dus Je toegangsgegevens bereiken dit account bevestigt toegang, geen aflevering.
  4. Klik op Doorgaan. Houd op Kies opties Gebeurtenissen vanuit de browser verzenden en Gebeurtenissen vanaf onze servers verzenden aangevinkt, beantwoord Is de officiële OpenAI Ads-app ook geïnstalleerd? (hieronder) en klik op Opslaan en doorgaan. Testen bevestigt OpenAI Ads is gekoppeld.

Dialoogvenster OpenAI Ads instellen, stap 1, met een helptekst en een link naar de volledige handleiding boven velden voor Pixel ID en een verplichte Conversions API key

Belangrijk: OpenAI’s eigen ChatGPT Ads-app voor Shopify verzendt de gebeurtenissen van je winkel ook naar een OpenAI-pixel. Twee verzenders geven één bestelling twee gebeurtenis-ID’s, en OpenAI bewaart ze allebei. Geef elke tool zijn eigen Pixel ID, of beantwoord Ja — houd hem, en cPixel stopt met server-side verzenden naar OpenAI Ads, wat, ondanks het label, zowel de browser- als de serververzendingen van cPixel naar die pixel stopt (één verzender per pixel).

Waar vind ik mijn OpenAI Ads Pixel ID?

Open in OpenAI Ads Manager Tools → Conversions: op het tabblad Data Source is de grijze ID onder de naam van je databron de Pixel ID, niet de advertentieaccount-ID in je adresbalk.

  1. Klap in het linkermenu Tools open en kies Conversions.

    Zijmenu van OpenAI Ads Manager met Tools opengeklapt en Conversions geselecteerd, boven Feeds, Change History en Audiences

  2. Kopieer op het tabblad Data Source de grijze ID, of maak een databron aan als je er nog geen hebt.

    Pagina Conversions op het tabblad Data Source, met één webdatabron waarvan de Pixel ID onherkenbaar is gemaakt, onder de banner Ads cannot serve until you finish account setup

Hoe maak ik een Conversions API key aan?

Klik op het sleutelicoon naast Warnings op de pagina Conversions, en dan op Create new key. Kopieer de key, die begint met sk-svcacct-, meteen: OpenAI toont hem maar één keer.

  1. Klik op het sleutelicoon. Conversion keys toont je keys gemaskeerd; OpenAI onthult een oude nooit opnieuw.

    Paneel Conversion keys geopend naast de pagina Conversions, met één key, onherkenbaar gemaakt, een verwijdericoon en een knop Create new key

  2. Klik op Create new key, geef hem een naam en kopieer de key uit Save your key voordat je het venster sluit.

    Dialoogvenster Save your key met de nieuwe key onherkenbaar gemaakt en knoppen Copy en Download, met de melding dat de key volledige toegang geeft tot de conversiegebeurtenissen van een databron

  3. Plak hem in cPixels veld Conversions API key.

Tip: Een key verwijderen trekt hem meteen in, dus maak en plak de nieuwe key voordat je de oude verwijdert.

Blokkeert “Ads cannot serve until you finish account setup” dit?

Nee. Nieuwe accounts tonen dit totdat facturering en een accountlogo zijn ingesteld; het beperkt het uitleveren van advertenties, niet de Conversions API.

Wat verzendt cPixel naar ChatGPT Ads?

Sinds 13 november 2026 verzendt cPixel vijf gebeurtenissen vanaf zijn servers via de Conversions API van OpenAI: paginaweergaven, productweergaven, toevoegingen aan het winkelwagentje, checkouts en aankopen, als page_viewed, contents_viewed, items_added, checkout_started en order_created. Met de app-insluiting aan verzendt de tag van OpenAI in de winkel ook de paginaweergave, met dezelfde gebeurtenis-ID, zodat OpenAI hem één keer telt.

  • De tag in de winkel verzendt alleen de paginaweergave. Productweergaven en toevoegingen aan het winkelwagentje gaan alleen vanaf de server, en checkouts en aankopen altijd, omdat een thema niet kan draaien op de checkout of bedankpagina van Shopify.
  • Met de app-insluiting uit gaan alle vijf nog steeds vanaf de server.
  • OpenAI ontvangt geen enkel betaalgegevens-event.
  • Serververzendingen bevatten gehashte e-mail, telefoon en klant-ID wanneer cPixel die heeft, de gehashte apparaat-ID, oppref en obref, IP-adres en user agent. OpenAI Ads heeft marketingtoestemming nodig; cPixel verzendt nooit namen of postadressen.
  • OpenAI ontdubbelt op Pixel ID, gebeurtenisnaam en gebeurtenis-ID, waarbij de eerste kopie behouden blijft, en accepteert gebeurtenissen tot 7 dagen oud. Een paginaweergave kan toch twee keer meetellen wanneer de serverkopie van cPixel zonder de gebeurtenis-ID van de tag wordt verzonden, wat kan gebeuren op de eerste pagina van een klant.
  • Zolang serververzendingen gepauzeerd zijn bij je maandelijkse bestelquotum, verzendt de tag in de winkel naast paginaweergaven ook productweergaven en toevoegingen aan het winkelwagentje, totdat de maand reset. Checkouts worden niet verzonden, aankopen wachten tot de maand reset, en met de app-insluiting uit krijgt OpenAI tijdens de pauze niets.

OpenAI Ads Manager scoort dagelijks de gebeurteniskwaliteit van elke databron. cPixels pagina Gebeurteniskwaliteit leest die score niet uit, en de opmerking dat OpenAI er geen publiceert is verouderd.

Wat is oppref, en verzendt cPixel het?

oppref is de clickreferentie die OpenAI aan het adres van je landingspagina toevoegt wanneer iemand op een ChatGPT-advertentie klikt. OpenAI gebruikt het om een conversie aan de klik te koppelen, met gehashte contactgegevens als terugval. cPixel verzendt het met zijn servergebeurtenissen wanneer het er een heeft.

  • cPixel leest het uit het adres en, met de app-insluiting aan, uit het cookie __oppref dat de tag van OpenAI op je domein bewaart, wat een verhuizing tussen www en je kale domein overleeft.
  • De tag van OpenAI bewaart dat cookie 30 dagen, en telt opnieuw vanaf het moment dat oppref weer in het adres verschijnt.
  • OpenAI vraagt je oppref door redirects heen te behouden: een redirect die queryparameters verwijdert, verliest het.

Hoe controleer ik of het werkt?

Start een sessie in Live en plaats een echte bestelling: de Server-rij van de aankoop toont het antwoord van OpenAI, Geaccepteerd, Geweigerd of Fout, met de HTTP-status. Controleer daarna het tabblad Event Stream in Ads Manager.

  1. Open in cPixel Live en klik op Sessie starten.
  2. Plaats in een ander tabblad een echte bestelling; cPixel slaat testbestellingen standaard over.
  3. Open de Server-rij van de aankoop: OpenAI Ads zou Geaccepteerd moeten tonen. Met de app-insluiting aan tonen paginaweergaven een Browser-rij, zonder antwoord, en een Server-rij; productweergaven, toevoegingen aan het winkelwagentje en checkouts tonen alleen Server-rijen.
  4. Open in Ads Manager Tools → Conversions, dan het tabblad Event Stream, en selecteer een gebeurtenis om de details te zien. OpenAI markeert browsergebeurtenissen als pixel_sdk en servergebeurtenissen als server_to_server (OpenAI). Productweergaven, toevoegingen aan het winkelwagentje, checkouts en aankopen horen alleen als server_to_server aan te komen.

Bestemmingen markeert het account als Geverifieerd na de eerste geaccepteerde serververzending. Toegeschreven conversies bereiken de rapportages van OpenAI binnen 24 tot 48 uur.

Wat als het niet werkt?

Als OpenAI de key weigert, markeert cPixel het account als Token ongeldig, stopt de serververzendingen ervan en e-mailt een kritieke melding naar het contactadres van je winkel; Home toont OpenAI herstellen.

  1. Maak een nieuwe key aan.
  2. Klik op OpenAI herstellen op Home, of op Beheren naast het account op Bestemmingen, en plak hem over Opgeslagen — plak een nieuwe om te vervangen. Verbinding testen controleert hem.
  3. Klik op Doorgaan, dan op Opslaan en doorgaan.
Wat je ziet Wat je moet doen
Verbinding testen: het platform heeft dit token geweigerd De key is verwijderd of verkeerd getypt: maak een nieuwe aan
Conversies tonen 0 in Ads Manager Het conversiedoel van de campagne moet overeenkomen met de verzonden gebeurtenis, order_created voor aankopen (OpenAI)
Aankopen dubbel geteld Een andere tool verzendt naar deze Pixel ID: één verzender per pixel
Een aankoop toont Overgeslagen in Live Lees de reden, en zie dan ontbrekende aankopen

Verwijderen in OpenAI Ads beheren stopt de verzendingen en verwijdert de opgeslagen key. OpenAI’s eigen documentatie: Conversions API.

Hulp nodig met cPixel? Mail naar support@b2bgold.app.