Direct naar de inhoud
Plugin kopen

Gids

ChatGPT Pixel installeren in WooCommerce

ChatGPT Ads meet verkopen in WooCommerce via twee koppelingen van OpenAI: de Measurement Pixel in de browser van de klant en de Conversions API op je server. Installeren betekent dat je een Pixel-ID en een API-key ophaalt in Ads Manager en die koppelt aan WooCommerce, zodat echte events voor producten, winkelwagen en bestellingen worden verstuurd. Deze gids doet dat met de plugin Pixel for ChatGPT Ads en sluit af met hoe je controleert of alles werkt.

Bijgewerkt

Op deze pagina

In het kort: zeven stappen, en het meeste werk gebeurt op één instellingenscherm

Voordat je begint

Vijf dingen die je klaar moet hebben, en één ding dat weg moet.

  • WordPress met WooCommerce geïnstalleerd en actief, bereikbaar via HTTPS.
  • Beheerderstoegang tot WordPress, om een plugin te uploaden en in te stellen.
  • Toegang tot je ChatGPT Ads-account in OpenAI Ads Manager.
  • Een licentiesleutel voor Pixel for ChatGPT Ads. Die krijg je bij het afrekenen; pakketten beginnen bij één website.
  • Een server die uitgaande HTTPS-verzoeken mag doen. Sommige hostingpartijen en firewalls blokkeren die, en de server-side aankoop heeft ze nodig.

Controleer dit

Verwijder andere exemplaren van de pixel. Staat de ChatGPT Ads-pixel al in de header van je thema, in een plugin voor headerscripts of in een Google Tag Manager-container? Haal hem daar weg voordat je live gaat. Een tweede exemplaar verstuurt eigen events zonder de event-ID's van de plugin. OpenAI herkent ze dan niet als dezelfde aankoop en je conversies kunnen dubbel worden geteld.
1

Stap 1 van 7

Haal je Pixel-ID op

Het Pixel-ID vertelt de Measurement Pixel bij welk ChatGPT Ads-account de events horen. Volgens de documentatie van OpenAI maak je een nieuw Pixel-ID aan op het tabblad voor conversies in Ads Manager (documentatie van de Measurement Pixel, Engelstalig).

Ook voor server-side meten heb je het Pixel-ID nodig: het endpoint van de Conversions API wordt ermee geadresseerd.

Verwacht resultaat

Een Pixel-ID voor je ChatGPT Ads-account, gekopieerd naar een plek waar je het weer kunt plakken.

Veelgemaakte fout

Een ander Pixel-ID gebruiken in de browser dan op de server. Beide routes moeten hetzelfde ID gebruiken, anders kunnen browser- en server-events niet aan elkaar worden gekoppeld.
2

Stap 2 van 7

Haal een Conversions API-key op

Met de Conversions API-key krijgt je server toestemming om events naar OpenAI te versturen. OpenAI geeft hem op dezelfde plek uit: zowel het Pixel-ID als de Conversions API-key maak je aan op het tabblad voor conversies in Ads Manager (documentatie van de Conversions API).

Behandel de API-key als een wachtwoord

OpenAI zegt duidelijk dat server-events uitsluitend vanaf je eigen server worden verstuurd. De plugin bewaart de key voor server-side gebruik en zet hem niet in de pagina.

Verwacht resultaat

Een Conversions API-key, alleen bewaard op de plek waar je ook je wachtwoorden bewaart.

Veelgemaakte fout

De key in een themabestand, pagebuilder of tagmanager plakken. De key mag nooit in de broncode van een pagina staan.
3

Stap 3 van 7

Installeer de plugin

  1. 1Download het zipbestand van de plugin via je aankoopbevestiging, of via de downloadpagina (in het Engels) met je licentiesleutel.
  2. 2Ga in WordPress naar Plugins → Nieuwe plugin (in oudere versies Nieuwe toevoegen), klik op Plugin uploaden, kies het zipbestand en klik op Nu installeren.
  3. 3Klik op Activeren.

Verwacht resultaat

Pixel for ChatGPT Ads staat als actief in je lijst met plugins.
4

Stap 4 van 7

Activeer je licentie

Open het tabblad Licence van de plugin, plak je licentiesleutel en activeer hem. Zolang de licentie niet actief is, worden er geen events verstuurd.

Verwacht resultaat

Op het tabblad Licence staat de status Active, met je pakket en het aantal activeringen dat nog over is.

Veelgemaakte fout

Eerst op een stagingkopie activeren. Staging gebruikt een eigen activering, dus test daar alleen als je pakket er een over heeft.
5

Stap 5 van 7

Koppel je gegevens

Op het tabblad Settings van de plugin:

  • Plak je Pixel-ID in het veld OpenAI Pixel ID.
  • Plak je key in het veld Conversions API key.
  • Laat de browsermeting aanstaan om productweergaven, toevoegingen aan de winkelwagen, het begin van het afrekenen en aankopen vanaf de pagina te versturen.
  • Laat de server-side meting aanstaan om elke betaalde bestelling via de Conversions API te versturen.
  • Ondersteunt je cookiebanner de WordPress Consent API? Zet dan de afhandeling van toestemming aan, zodat de pixel wacht op marketingtoestemming.

De koppelingsinstellingen van de plugin in WordPress (Engelstalige interface).

  1. 1OpenAI Pixel ID: uit stap 1.
  2. 2Conversions API key: uit stap 2.
  3. 3Schakelaars voor browser- en server-side meting: laat ze allebei aanstaan.

Verwacht resultaat

Beide gegevens opgeslagen, browsermeting en server-side meting ingeschakeld.

Controleer dit

Gebruikt je webshop een full-page cache? Leeg die na het opslaan, zodat bezoekers geen kopie van de pagina krijgen van vóór het instellen van de pixel.
6

Stap 6 van 7

Controleer de browser-events

  1. 1Open de webshop in een privévenster en accepteer marketingcookies als er een banner verschijnt.
  2. 2Open de ontwikkelaarstools van je browser en ga naar het tabblad Netwerk.
  3. 3Filter de verzoeken op openai. Je zou het script van de Measurement Pixel moeten zien laden vanaf een openai.com-host.
  4. 4Bekijk een product, leg het in de winkelwagen en ga naar het afrekenen. Let op de nieuwe verzoeken die verschijnen.

Verwacht resultaat

Verzoeken naar een openai.com-host terwijl je een product bekijkt, het in de winkelwagen legt en naar het afrekenen gaat.

Veelgemaakte fout

Helemaal geen verzoeken. Meestal staat de browsermeting uit, ontbreekt het Pixel-ID, is er geen toestemming gegeven of krijg je een pagina uit de cache.
7

Stap 7 van 7

Controleer een betaalde bestelling

Rond een bestelling af die een betaalde status krijgt (een echte bestelling met een klein bedrag, of een testbetaalmethode die bestellingen als betaald markeert). Open daarna het tabblad Diagnostics van de plugin en zoek de bestelling op.

Wat de leverstatus van een bestelling betekent
LeverstatusWat het betekentWat je doet
AcceptedOpenAI heeft de aankoop geaccepteerd.Niets. De meting werkt.
PendingIn de wachtrij of wacht op een nieuwe poging.Kijk zo nog eens.
Not sentDe aankoop is niet verstuurd, meestal omdat er voor die bestelling geen marketingtoestemming is.Open de bestelling om de reden te zien.
FailedDe laatste poging is niet gelukt.Lees de HTTP-status, los de oorzaak op en verstuur opnieuw als dat kan.

Diagnostics toont betaalde bestellingen en wat er met elk aankoop-event is gebeurd (Engelstalige interface).

  1. 1Zoek je testbestelling op aan de hand van het bestelnummer.
  2. 2Het event-ID is het ID dat de aankoop in de browser en op de server delen.

Verwacht resultaat

De bestelling staat in Diagnostics op Accepted.

Controleer dit

Een bestelling die nog op betaling wacht, is nog niet verstuurd: de aankoop wordt pas verstuurd als WooCommerce de bestelling als betaald markeert.

Problemen oplossen

Veelgemaakte fouten

De meeste installatieproblemen zijn een van deze vijf.

Veelgemaakte fouten bij het installeren van de ChatGPT Ads-pixel in WooCommerce
SymptoomWaarschijnlijke oorzaakOplossing
Conversies lijken verdubbeldDe pixel staat ook in het thema of in een tagmanager.Verwijder het andere exemplaar.
Failed met HTTP 401De Conversions API-key is geweigerd.Plak een geldige key en verstuur opnieuw vanuit Diagnostics.
Blijft op Pending, met nieuwe pogingenDe server kan de API niet bereiken.Controleer uitgaande HTTPS-verbindingen, firewall- en proxyregels.
Geen browser-eventsGeen toestemming, meting uitgeschakeld of een verouderde pagina uit de cache.Geef toestemming, controleer de instellingen, leeg de cache.
Bestellingen op Not sentVoor die bestellingen is geen marketingtoestemming vastgelegd.Verwacht gedrag als de afhandeling van toestemming aanstaat.

In het onderdeel problemen oplossen van de documentatie vind je meer situaties.

Zonder plugin

De pixel handmatig installeren

Je kunt de pixel ook zonder plugin installeren. In WooCommerce is de code alleen het begin.

Volgens de instructies van OpenAI zet je de code in de <head> van elke pagina waarop je conversies wilt meten. Daarna begint het werk pas:

  • Elk event (productweergave, toevoegen aan winkelwagen, afrekenen, aankoop) programmeer je zelf, met WooCommerce-waarden.
  • Het aankoop-event moet één keer per bestelling worden verstuurd, niet elke keer dat de pagina Bestelling ontvangen laadt.
  • Een server-side aankoop heeft een eigen API-client nodig, die start bij de betaalde status.
  • De aankoop in de browser en op de server moeten hetzelfde event-ID hebben om te kunnen ontdubbelen.
  • Mislukte verzoeken moeten opnieuw worden geprobeerd, en je moet ze ergens kunnen zien.

De gids over de OpenAI Conversions API voor WooCommerce behandelt de server-side kant uitgebreid.

Vragen

Heb ik zowel het Pixel-ID als de API-key nodig?

Het Pixel-ID heb je voor alles nodig. De API-key is nodig voor de server-side aankoop. Je kunt browsermeting en server-side meting elk uitzetten, maar met allebei aan krijgt de aankoop een tweede route die niet van de browser afhangt.

Heeft de plugin Google Tag Manager nodig?

Nee. De plugin laadt de pixel en bouwt de events rechtstreeks op vanuit WooCommerce.

Gaat de meting stuk als ik van thema wissel?

Er worden geen templates aangepast, dus een ander thema haalt de pixel niet weg. Heb je een sterk aangepaste afrekenpagina, test dan opnieuw met een bestelling.

Werkt het met HPOS?

Ja. WooCommerce High-Performance Order Storage en de oudere opslag van bestellingen worden allebei ondersteund.

Klaar om te installeren?

Pixel for ChatGPT Ads is een jaarlicentie voor 1, 5 of 25 websites, met dezelfde functies in elk pakket.

Bekijk de prijzenWat de plugin verstuurt

Verwante gidsen