ChatGPT Ads tracking pixel via WordPress installeren en testen
Voor conversiemeting in ChatGPT Ads heb je eerst een gegevensbron nodig. Bij een website is dat de website pixel. Ads Manager levert na het aanmaken een uniek Pixel-ID en een installatiescript. Dat basisscript moet op de website beschikbaar zijn voordat afzonderlijke gebeurtenissen, zoals een paginaweergave, lead of afspraak, naar Ads Manager kunnen worden verstuurd.
In deze handleiding plaatsen we het basisscript niet via Google Tag Manager, maar rechtstreeks in WordPress met de plugin WPCode, in het Header-veld dat in de <head> van de site wordt afgedrukt. Google Tag Manager gebruiken we vervolgens in een tweede deel om een testgebeurtenis te versturen en te bevestigen dat de installatie werkt. Voor de bredere context, zie ChatGPT Ads-campagne opzetten; voor het inrichten van je eigen zakelijke conversies (leads, afspraken, telefoonklikken) na deze basisinstallatie, zie ChatGPT Ads conversies instellen via Google Tag Manager.
Belangrijk: plaats het Pixel-installatiescript maar één keer per pagina. Voeg dus niet daarnaast nog hetzelfde basisscript via Google Tag Manager of een tweede WordPress-plugin toe.
Deel 1 – De tracking pixel installeren
Stap 1. Open Conversies in ChatGPT Ads Manager
Ga in Ads Manager naar Tools > Conversies. Wanneer er nog geen gegevensbron is ingesteld, zie je dat ook terug in het overzicht voor conversietracking. Kies voor het aanmaken van een nieuwe gegevensbron.
Conversies in Ads Manager voordat een websitegegevensbron is ingesteld.
Stap 2. Maak een nieuwe websitegegevensbron aan
Geef de gegevensbron een herkenbare naam. Een praktische naamstructuur is: [domeinnaam] - Website Pixel. Daarmee blijft ook bij meerdere websites of advertentieaccounts direct duidelijk bij welke website de pixel hoort. In hetzelfde scherm vermeldt Ads Manager dat automatische geavanceerde matching ondersteunde klantgegevens op de website kan herkennen, normaliseren en veilig in de browser kan hashen. Klik daarna op Aanmaken.
Een nieuwe gegevensbron aanmaken en een herkenbare naam geven.
Stap 3. Kopieer het volledige Pixel-installatiescript
Na het aanmaken toont Ads Manager het unieke Pixel-ID en de installatiecode. Kopieer de volledige code met de kopieerknop naast het codevak. Niet alleen het Pixel-ID is nodig: het volledige script initialiseert de OpenAI Ads pixel op de website. Ads Manager geeft hier expliciet aan dat het script in de HTML-kop van de website moet worden geplaatst, bij voorkeur bovenaan, en dat per pagina slechts één Pixel-installatiescript moet worden toegevoegd.
Ads Manager toont het Pixel-ID en de installatiecode voor de website pixel.
Stap 4. Installeer WPCode in WordPress
Log in op WordPress en installeer de plugin WPCode – Insert Headers and Footers + Custom Code Snippets. Met deze plugin kun je globale scripts in de header van de website opnemen zonder het themebestand header.php handmatig te wijzigen.
De WPCode-plugin in het WordPress pluginoverzicht.
Stap 5. Open in WPCode de globale Header & Footer
Ga in WordPress naar Code snippets > Header & footer. Bovenaan staat het veld Header. Onder het veld wordt aangegeven dat deze scripts in de sectie <head> worden afgedrukt. Dat is precies de plaats die Ads Manager voor het Pixel-installatiescript voorschrijft.
Het Header-veld van WPCode waarin scripts in de <head> worden geplaatst.
Stap 6. Plak de tracking pixel in het Header-veld
Plak de volledige, ongewijzigde installatiecode uit Ads Manager in het Header-veld. Plaats de code niet in Body of Footer. Sla vervolgens de wijzigingen op. Wanneer er al andere scripts in Header staan, kan de OpenAI-code daar als afzonderlijk script naast staan; voorkom alleen dat dezelfde OpenAI Pixel-installatiecode dubbel wordt toegevoegd.
Het ChatGPT Ads Pixel-installatiescript is via WPCode in de Header geplaatst.
Stap 7. Controleer of de code werkelijk in de HTML-kop staat
Controleer niet alleen of WPCode de wijziging heeft opgeslagen. Open de website in de browser en bekijk de paginabron, bijvoorbeeld via ‘Paginabron weergeven’. Zoek vervolgens op oaiq. Als de installatie goed is uitgevoerd, vind je het OpenAI-script in de broncode binnen de <head> van de pagina. Deze controle bewijst dat WordPress de installatiecode publiceert. Het bewijst nog niet dat een specifieke conversiegebeurtenis in Ads Manager wordt ontvangen – dat controleren we in deel 2 hieronder.
Controle in de paginabron: de OpenAI pixelcode is in de HTML aanwezig.Wat is na deze stap gereed? De websitegegevensbron bestaat in Ads Manager, het bijbehorende Pixel-installatiescript staat rechtstreeks via WordPress in de <head> en de aanwezigheid ervan is in de broncode gecontroleerd. Daarmee is de basisinstallatie gereed. De volgende stap is een gebeurtenis versturen om te controleren of de keten website > OpenAI pixel > Ads Manager daadwerkelijk functioneert.
Deel 2 – Testen of de pixel echt werkt via Google Tag Manager
De basispixel is al via WPCode in de <head> van de website geplaatst. We gaan die basiscode dus niet nogmaals in Google Tag Manager installeren. GTM gebruiken we alleen om een gebeurtenisaanroep uit te voeren. Als die gebeurtenis vervolgens in Ads Manager > Gebeurtenisstroom verschijnt, is de technische keten aantoonbaar werkend.
Testopzet: voor deze controle gebruiken we bewust de basisgebeurtenis Pagina bekeken en de conversienaam Pagina bekeken – Test. Dit is een technische test en hoeft niet de uiteindelijke primaire campagneconversie te zijn.
Stap 1. Maak in Ads Manager een aangepaste conversie aan
Ga naar Tools > Conversies en kies voor het aanmaken van een conversiegebeurtenis. Selecteer de websitegegevensbron waarop de eerder geïnstalleerde tracking pixel staat.
Een aangepaste conversie aanmaken op de bestaande websitegegevensbron.
Stap 2. Kies als basisgebeurtenis ‘Pagina bekeken’
Open Basisgebeurtenis en selecteer Pagina bekeken. Geef de conversie voor deze controle een duidelijk herkenbare testnaam, bijvoorbeeld ‘Pagina bekeken – Test’. In het getoonde scherm staan ook de attributievensters: 30 dagen voor doorklikattributie en 1 dag voor view-through-attributie. Voor deze technische controle hoeven we die waarden niet te wijzigen.
Basisgebeurtenis Pagina bekeken met de conversienaam Pagina bekeken – Test.
Stap 3. Kopieer de Pixel-gebeurtenisaanroep
Na het aanmaken toont Ads Manager de code voor de conversiegebeurtenis. Kies het tabblad Pixel. Voor deze test levert Ads Manager een gebeurtenisaanroep met measure en page_viewed. Kopieer exact de code die jouw eigen Ads Manager toont; de interface is hierbij leidend.
oaiq("measure", "page_viewed", { type: "contents" });De door Ads Manager verstrekte Pixel-gebeurtenisaanroep voor page_viewed.
Stap 4. Maak in Google Tag Manager een Aangepaste HTML-tag
Open Google Tag Manager en maak een nieuwe tag. Kies als tagtype Aangepaste HTML. Plaats de door Ads Manager verstrekte gebeurtenisaanroep tussen <script> en </script>. Geef de tag een herkenbare naam, bijvoorbeeld ‘4. ChatGPT Ads – Pagina bekeken – Test’. Voor deze technische controle kan de trigger All Pages worden gebruikt. Omdat de basispixel al via WordPress geladen wordt, hoeft het volledige Pixel-installatiescript niet in deze GTM-tag te worden opgenomen. Heb je nog geen ervaring met Google Tag Manager, bekijk dan eerst de training Google Tag Manager van Optimize Online.
Testtag in Google Tag Manager met de page_viewed-gebeurtenisaanroep en trigger All Pages.
Stap 5. Test met Voorbeeldmodus in Google Tag Manager
Start de Voorbeeldmodus van GTM en open de website via Tag Assistant. Controleer bij de paginaweergave of de testtag onder Geactiveerde tags staat. In de test is ‘4. ChatGPT Ads – Pagina bekeken – Test’ één keer geactiveerd. Daarmee weten we dat Google Tag Manager de gebeurtenisaanroep uitvoert. Let op: dit is nog niet de eindcontrole; Ads Manager moet de gebeurtenis ook ontvangen.
De ChatGPT Ads testtag is in GTM Preview één keer geactiveerd.
Stap 6. Controleer de Gebeurtenisstroom in Ads Manager
Ga terug naar Ads Manager > Tools > Conversies > Gebeurtenisstroom. Start polling en laad de website opnieuw via de GTM-testomgeving. Wanneer de implementatie werkt, verschijnt een gebeurtenis van het type page_viewed. In de geslaagde test is als API-kanaal pixel_sdk zichtbaar en staat in de JSON van de gebeurtenis type ‘contents’. Dit is de doorslaggevende end-to-end controle: niet alleen GTM heeft de tag uitgevoerd, maar Ads Manager heeft de gebeurtenis daadwerkelijk ontvangen.
De page_viewed-testgebeurtenis is daadwerkelijk ontvangen in de Gebeurtenisstroom.Wat bewijst deze test precies? De test bevestigt drie onderdelen tegelijk: de via WordPress geïnstalleerde basispixel is beschikbaar op de website, de oaiq-gebeurtenisaanroep kan vanuit Google Tag Manager worden uitgevoerd en Ads Manager ontvangt de gebeurtenis via de Pixel SDK. Daarmee is de technische basis gereed om echte conversiegebeurtenissen in te richten, bijvoorbeeld een gemaakte showroomafspraak of een succesvol verzonden contactformulier – zie ChatGPT Ads conversies instellen via Google Tag Manager.
Wat doe je met de testtag na de controle? Gebruik ‘Pagina bekeken – Test’ niet automatisch als primaire optimalisatieconversie voor een campagne. Het doel was hier uitsluitend de implementatie controleren. Nadat de test is afgerond, kun je de testtag pauzeren of verwijderen en vervolgens de relevante zakelijke conversies inrichten. Voor een showroomgerichte campagne is een daadwerkelijk gemaakte afspraak bijvoorbeeld veel waardevoller dan een willekeurige paginaweergave.
Veelgestelde vragen
Moet de ChatGPT Ads tracking pixel in de <head> staan?
Ja. In het installatiescherm van Ads Manager wordt aangegeven dat het Pixel-installatiescript in de HTML-kop van de website moet worden geplaatst, bij voorkeur bovenaan. Met WPCode kan dat via Code snippets > Header & footer > Header. Onder dit veld geeft WPCode zelf aan dat de scripts in de <head>-sectie worden afgedrukt. Controleer na het opslaan de paginabron en zoek op oaiq. Daarmee controleer je de daadwerkelijke HTML-uitvoer in plaats van alleen de instelling in WordPress.
Kan ik de basispixel ook via Google Tag Manager plaatsen?
Technisch zijn er verschillende manieren om scripts op een website te laden. In deze specifieke implementatie kiezen we er bewust voor om het door Ads Manager geleverde Pixel-installatiescript rechtstreeks via WordPress/WPCode in de <head> te plaatsen. Google Tag Manager gebruiken we vervolgens voor afzonderlijke meetgebeurtenissen. Het voordeel van deze scheiding is dat de basispixel permanent op paginaniveau aanwezig is en dat gebeurtenissen in GTM afzonderlijk kunnen worden ingericht en getest. Voeg het basisscript in elk geval niet via meerdere methoden tegelijk toe.
Waarom zie ik nog geen page_viewed-event na alleen de basisinstallatie?
De installatiecode initialiseert de website pixel, maar in deze werkwijze versturen we een page_viewed-gebeurtenis afzonderlijk. Alleen de aanwezigheid van oaiq in de broncode betekent daarom nog niet dat je in de Gebeurtenisstroom automatisch een page_viewed-regel moet zien. Om de volledige implementatie te testen, maken we in Ads Manager een testconversie met de basisgebeurtenis Pagina bekeken en gebruiken we de daarbij verstrekte gebeurtenisaanroep in Google Tag Manager. Zodra die wordt uitgevoerd, kan Ads Manager het page_viewed-event in de Gebeurtenisstroom tonen.
Mag de tracking pixel meer dan één keer op dezelfde pagina staan?
Nee, dat is niet de bedoeling. Ads Manager vermeldt bij de installatie expliciet dat je per pagina slechts één Pixel-installatiescript moet toevoegen. Controleer daarom of de code niet al via een thema, andere snippet-plugin, Google Tag Manager of een eerdere implementatie wordt geladen. Een dubbele basisinstallatie maakt de implementatie onnodig complex en kan het analyseren van meetproblemen lastiger maken. Kies één centrale methode voor de basispixel; in deze handleiding is dat WPCode in de WordPress-header.
Waarom testen we met page_viewed en niet direct met een afspraak?
Een paginaweergave is eenvoudig en gecontroleerd op te roepen. Daardoor kun je eerst vaststellen of de technische keten werkt zonder afhankelijk te zijn van een formulier, boekingsmodule of bedankpagina. Als page_viewed vanuit Google Tag Manager in de Gebeurtenisstroom van Ads Manager verschijnt, weet je dat de basispixel, de JavaScript-gebeurtenisaanroep en de ontvangst in Ads Manager samenwerken. Daarna kun je dezelfde implementatiemethode toepassen op echte conversies, maar dan met een trigger die uitsluitend na de gewenste gebruikersactie afgaat.
Hoe weet ik dat niet alleen GTM, maar de volledige meting werkt?
Dat een tag in GTM Preview onder Geactiveerde tags staat, bewijst alleen dat Google Tag Manager de tag heeft uitgevoerd. De sterkere controle is Ads Manager > Gebeurtenisstroom. Daar moet de verstuurde gebeurtenis daadwerkelijk verschijnen. In de geslaagde test zien we page_viewed als type gebeurtenis, de juiste websitegegevensbron en pixel_sdk als API-kanaal. Pas dan is de keten tot en met Ads Manager getest. Daarom combineren we GTM Preview altijd met de Gebeurtenisstroom.
