Documentatie van Pixel for ChatGPT Ads

1. 1Download het zipbestand van de plugin via je aankoopbevestiging.
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.
4. 4Open het tabblad Licence, plak je licentiesleutel en activeer hem.

Er worden pas conversie-events verstuurd als de licentie actief is. Het licentiescherm toont het pakket, het aantal resterende activeringen en de datum tot wanneer de licentie loopt.

• Een WordPress-site waarop WooCommerce geïnstalleerd en actief is.
• De webshop draait op HTTPS.
• Je server mag uitgaande HTTPS-verzoeken doen, zodat aankoop-events de Conversions API kunnen bereiken.
• Een OpenAI Pixel-ID voor meting in de browser.
• Een OpenAI Conversions API-key voor server-side aankoop-events.
• Een licentiesleutel voor Pixel for ChatGPT Ads.

WooCommerce High-Performance Order Storage en de oudere opslag van bestellingen als berichten worden allebei ondersteund. Je hoeft je thema en afrekentemplates niet aan te passen.

Plak op het tabblad Settings je OpenAI Pixel-ID in het veld OpenAI Pixel ID en sla op. Staat de browsermeting aan, dan laadt de OpenAI Measurement Pixel in je webshop en beginnen de browser-events te lopen.

Staat de afhandeling van toestemming aan, dan blijft de pixel geblokkeerd tot die bezoeker marketingtoestemming heeft gegeven. Zie Toestemming.

Plak op hetzelfde scherm je Conversions API-key in het veld Conversions API key. De key wordt alleen voor server-side gebruik opgeslagen. Hij komt niet in de HTML van de pagina en wordt nooit naar de browser gestuurd.

Staat de server-side meting aan, dan wordt order_created vanaf je server verstuurd zodra een WooCommerce-bestelling een betaalde status krijgt. Elke poging wordt in Diagnostics vastgelegd met de HTTP-respons, zodat een geweigerde key of een rate limit zichtbaar is en niet ongemerkt blijft.

Deze events worden vanaf de pagina verstuurd:

• Product bekekencontents_viewed
• In winkelwagenitems_added
• Afrekenen gestartcheckout_started
• Aankooporder_created

Zet je de browsermeting uit, dan stoppen alle vier de browser-events. De server-side meting van aankopen merkt daar niets van en blijft gewoon werken. De vergelijking tussen Pixel en Conversions API legt uit wat elke route wel en niet ziet.

order_created is het event dat via de Conversions API gaat. Het vertrekt bij de overgang naar een betaalde status in WooCommerce, niet bij het laden van een pagina. Een klant die het tabblad sluit voordat de pagina Bestelling ontvangen verschijnt, levert dus toch een aankoop-event op. Voor betaalmethoden met een latere bevestiging werkt het net zo.

Het event-ID wordt afgeleid van de bestelling. Het server-event en het browser-event voor dezelfde aankoop hebben dus hetzelfde ID en kunnen tot één conversie worden samengevoegd. Het herladen van de pagina Bestelling ontvangen levert geen tweede ID op.

Mislukte leveringen worden automatisch opnieuw geprobeerd. Wat na die pogingen nog steeds mislukt, blijft in het logboek staan en kun je handmatig opnieuw versturen.

Voor de achtergrond (waarom alleen de aankoop server-side gaat, de 7-dagenregel van OpenAI voor tijdstempels en wat server-side versturen niet oplost) lees je de gids over de OpenAI Conversions API voor WooCommerce.

De plugin leest marketingtoestemming uit via de WordPress Consent API. Ondersteunt je consentplugin die API, dan wordt hij zonder verdere instellingen gebruikt.

• Browser-events blijven geblokkeerd tot er marketingtoestemming is gegeven.
• Het server-side aankoop-event gebruikt de toestemming die voor die bestelling is vastgelegd. Verandert een klant later van voorkeur, dan worden eerdere bestellingen niet herschreven.
• Bestellingen zonder marketingtoestemming staan in Diagnostics op Not sent, niet als fout.

Consenttools die de WordPress Consent API niet ondersteunen, worden niet automatisch herkend. Aan welke regels je moet voldoen, hangt af van je webshop, je configuratie en het land waar je actief bent.

Het tabblad Diagnostics toont betaalde bestellingen en wat er met hun aankoop-event is gebeurd. De kolommen (Engelstalig in de plugin):

• Order: de WooCommerce-bestelling waar het event bij hoort.
• WC paid: of de bestelling een betaalde status heeft.
• Consent: de marketingtoestemming die voor de bestelling is vastgelegd.
• Delivery: verstuurd, wordt opnieuw geprobeerd, mislukt of niet verstuurd.
• Attempts: hoe vaak er is geprobeerd te leveren.
• HTTP status: de responscode van de laatste poging.

Is de oorzaak opgelost, dan kun je een mislukte levering vanuit hetzelfde scherm opnieuw versturen.

Licenties gelden een jaar en bieden een vast aantal activeringen: één per WordPress-installatie. Deactiveer je een website, dan komt die activering vrij voor een andere webshop.

Active

Meten toegestaan. Events worden verstuurd, updates komen binnen en je kunt support krijgen.

Expired

Geen nieuwe conversiemeting. Verleng de licentie om events, updates en support te hervatten.

Disabled

Geen nieuwe conversiemeting. De licentie is gedeactiveerd en er worden geen nieuwe events verstuurd.

Zo staan de statusnamen in de plugin, waarvan de interface momenteel Engelstalig is.

Plugin-updates komen binnen via het gewone updatescherm van WordPress zolang de licentie actief is. Zie prijzen en limieten per pakket.

Geen browser-events in de webshop

Controleer of de browsermeting aanstaat, of het Pixel-ID is opgeslagen en, als de afhandeling van toestemming aanstaat, of er marketingtoestemming is gegeven. Ook een full-page cache kan een kopie van de pagina tonen van vóór het instellen van de plugin.

Een betaalde bestelling staat op Not sent

Voor die bestelling is geen marketingtoestemming gegeven, dus er is geen server-event verstuurd. Zo hoort meten met toestemming te werken.

Levering mislukt met 401

De Conversions API-key is geweigerd. Werk de key bij op het tabblad Settings en verstuur het event daarna opnieuw vanuit Diagnostics.

Levering toont 429

Het verzoek liep tegen een rate limit aan. Het wordt automatisch opnieuw geprobeerd; je hoeft niets te doen, tenzij het eindigt op Failed.

Leveringen worden steeds opnieuw geprobeerd

Misschien kan je server de API niet bereiken. Controleer uitgaande HTTPS-verzoeken, firewallregels en een eventuele proxy vóór WordPress.

Een bestelling ontbreekt in het logboek

Het aankoop-event wordt vastgelegd zodra WooCommerce de bestelling als betaald markeert. Bestellingen die nog op betaling wachten, zijn nog niet verstuurd.

Conversies lijken verdubbeld

Controleer of er niet ergens anders een tweede pixel staat. Een codefragment in het thema of een tagmanager-container verstuurt events zonder het event-ID dat de plugin toekent, en kan dus niet tegen het server-event worden ontdubbeld.

Kom je er niet uit? Neem contact op met support en stuur het bestelnummer en de HTTP-status uit Diagnostics mee.