ChatGPT Ads meten: de pixel en de Conversions API via je servercontainer

Advertenties in ChatGPT komen met hun eigen meting: een pixel, een Conversions API en een click-ID met de naam oppref. De pixel van OpenAI en de Conversions API-tag van Stape staan allebei in de Tag Manager-galerij, en de Measurebase-import verbindt ze met één event-ID. Dit is de setup.

Wat je nodig hebt

• Pixel-ID: ChatGPT Ads Manager → Conversions.
• Conversions API-sleutel: aangemaakt op dezelfde pagina; het is een bearer-sleutel, dus die blijft alleen in Measurebase en de servercontainer.
• Je Measurebase-domein met het Enhanced script geïnstalleerd en GA4-events die binnenkomen.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de officiële template Ads Measurement Pixel van OpenAI met de events page_viewed, contents_viewed, items_added, checkout_started en order_created, een constante met je pixel-ID en de variabele Unique Event ID. OpenAI verwacht bedragen in centen; de import rekent je waarden om.

Servercontainer: de template OpenAI Ads Conversions API (Stape, uit de galerij) als één tag die naar elk GA4-event luistert en de namen zelf koppelt, gehasht e-mailadres, IP-adres en user agent meestuurt met oppref en de browserreferentie, en de cookies __oppref en __obref vanaf de server zet.

Stap 4 · Eén event-ID voor browser en server

Een platform dat hetzelfde event van een browserpixel én van een servertag ontvangt, telt het dubbel, tenzij beide hetzelfde event-ID dragen. De import regelt dat: de variabele Unique Event ID maakt één ID per event in de webcontainer, de GA4-eventinstellingen sturen het naar je servercontainer als event_id, en zowel de pixeltag als de servertag sturen diezelfde waarde mee in hun ontdubbelingsveld. Het platform houdt één kopie en gooit de andere weg.

Met de Shopify-app, de WordPress-plugin of de Shopware-plugin draagt een aankoop die ook server-side wordt doorgestuurd het ordernummer mee als mb_event_id, zodat ook de twee aankoopkopieën aan elkaar gekoppeld kunnen worden.

OpenAI ontdubbelt op pixel-ID, eventnaam en event-ID.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

ChatGPT Ads Manager → Conversions toont events zodra ze van de pixel en de API binnenkomen, met de gematchte identifiers.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Click-ID's en cookies

Een klik vanuit ChatGPT landt met oppref in de URL. De pixel bewaart hem in de cookie __oppref voor 30 dagen en bewaart een browserreferentie in __obref voor een jaar, allebei gezet door JavaScript en dus begrensd door Safari. De schakelaar ChatGPT Ads in Click ID Restorer vangt oppref op in een first-party cookie zodra de bezoeker landt, en de groep ChatGPT Ads in Cookie Keeper zet beide cookies opnieuw met hun volledige levensduur.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Veelgestelde vragen

Waarom de pixel niet via mijn eigen domein doorsturen, zoals de hits van Google?

Een third-party pixel doorsturen levert een slechter gematcht duplicaat op: het IP-adres wordt dat van het doorstuurpunt, en OpenAI routeert het niet first-party zoals Google dat doet. De blockerbestendige route is de Conversions API-tag, gevoed door de gemaskeerde first-party hits.