Extension ChatGPT Ads pour WooCommerce : conversions, ajout au panier et CAPI

Pourquoi un simple snippet ne suffit pas sur WooCommerce

Coller le code du pixel dans l’en-tête du thème ou dans une extension d’insertion de scripts donne l’impression que tout fonctionne : l’Ads Manager reçoit des pages vues. Mais trois choses manquent presque toujours. D’abord le consentement : le pixel OpenAI considère le visiteur comme consentant par défaut, il se déclenche donc avant la bannière. Ensuite la vente côté serveur : quand le paiement se termine chez Stripe, PayPal ou la banque, une partie des clients ne revoient jamais la page de remerciement. Enfin l’identifiant de clic oppref, que la Conversions API ne récupère pas seule.

À cela s’ajoutent des particularités propres à WordPress : les extensions de cache de page qui servent la même page HTML à tous les visiteurs, l’ajout au panier en AJAX sur les pages boutique, le nouveau tunnel de commande en blocs qui ne déclenche pas les mêmes actions que l’ancien shortcode, et le passage des commandes vers les tables HPOS.

Les évènements envoyés par l’extension

L’extension utilise les noms d’évènements standard documentés par OpenAI :

• contents_viewed sur la page produit, variation comprise pour un produit variable ;
• items_added à l’ajout au panier, que l’ajout se fasse par rechargement de page ou en AJAX depuis la boutique ;
• checkout_started à l’ouverture de la page de commande, en blocs ou classique ;
• order_created pour l’achat : pixel sur la page de remerciement, et envoi serveur au passage de la commande en statut « en cours » ou « terminée » ;
• registration_completed à la création de compte, lead_created sur un formulaire de devis ou de contact si c’est votre conversion principale.

Si vous vendez des abonnements, OpenAI prévoit aussi un évènement subscription_created : nous voyons ensemble s’il est pertinent pour vous.

Commande, métadonnées et HPOS

À l’arrivée d’un visiteur venant d’une annonce, l’extension lit oppref et l’identifiant obref, puis les rattache à la session WooCommerce. À la création de la commande, ils sont copiés dans les métadonnées de la commande par les méthodes de l’objet commande de WooCommerce, et non par des requêtes directes sur les tables de WordPress. C’est ce qui rend l’extension compatible avec HPOS, le stockage des commandes haute performance, dont elle déclare la compatibilité comme WooCommerce le demande.

Un identifiant d’évènement opaque est généré à ce moment-là et stocké avec la commande. Le pixel de la page de remerciement et l’appel serveur l’utilisent tous les deux, avec le même nom d’évènement et le même Pixel ID : OpenAI ne compte qu’une vente, même si le client recharge la page. Le montant part en entier dans l’unité mineure de la devise de la commande. L’e-mail et le téléphone de facturation sont normalisés puis hachés en SHA-256 avant l’envoi, jamais transmis en clair.

La clé de la Conversions API est saisie dans les réglages de l’extension, côté administration, et n’apparaît jamais dans le code servi aux visiteurs. Un journal, consultable dans les journaux de WooCommerce, garde la trace des envois et des réponses, et un mode validation permet de tester sans enregistrer d’évènement chez OpenAI.

Consentement : Complianz, CookieYes, tarteaucitron et les autres

Aucun script OpenAI, aucun cookie et aucun envoi serveur tant que le visiteur n’a pas accepté la finalité marketing. L’extension est compatible avec les extensions WordPress de consentement les plus répandues, Complianz et CookieYes en tête, ainsi qu’avec Axeptio, Cookiebot, Didomi et tarteaucitron.js par un service personnalisé. Quand votre bannière publie les signaux du mode consentement de Google, l’état du stockage publicitaire peut servir de déclencheur.

Le choix du visiteur est mémorisé avec la commande : s’il a refusé, la Conversions API n’envoie rien pour elle. Je vous fournis la liste exacte des données transmises pour mettre à jour votre politique de confidentialité ; la base légale reste une décision du responsable de traitement.