Guide
Comment installer le pixel ChatGPT Ads sur WooCommerce
ChatGPT Ads mesure les ventes WooCommerce grâce à deux interfaces OpenAI : le Measurement Pixel, dans le navigateur de l'acheteur, et la Conversions API (API de conversions), sur votre serveur. L'installation consiste à obtenir un Pixel ID et une clé d'API dans Ads Manager, puis à les connecter à WooCommerce pour envoyer les vrais événements liés aux produits, au panier et aux commandes. Ce guide suit ces étapes avec le plugin Pixel for ChatGPT Ads, puis explique comment vérifier que tout fonctionne.
Mis à jour le
Sur cette page
En bref : sept étapes, l'équivalent d'un seul écran de réglages
Avant de commencer
Cinq éléments à préparer, et un à supprimer.
- WordPress avec WooCommerce activé, servi en HTTPS.
- Un accès administrateur à WordPress, pour téléverser et configurer une extension.
- Un accès à votre compte ChatGPT Ads dans OpenAI Ads Manager.
- Une clé de licence Pixel for ChatGPT Ads. Vous la recevez lors de l'achat ; les formules commencent à un site.
- Un serveur capable d'émettre des requêtes HTTPS sortantes. Certains hébergeurs et pare-feu les bloquent ; l'achat côté serveur en a besoin.
À vérifier
Étape 1 sur 7
Récupérer votre Pixel ID
Le Pixel ID indique au Measurement Pixel à quel compte ChatGPT Ads appartiennent les événements. La documentation du Measurement Pixel (en anglais) indique de créer un nouveau Pixel ID dans l'onglet des conversions d'Ads Manager.
Le Pixel ID sert aussi au suivi côté serveur : c'est lui qui identifie le point de terminaison de la Conversions API.
Résultat attendu
Erreur fréquente
Étape 2 sur 7
Obtenir une clé Conversions API
La clé Conversions API autorise votre serveur à envoyer des événements. OpenAI la fournit au même endroit : selon la documentation de la Conversions API, le Pixel ID et la clé Conversions API se génèrent tous deux depuis l'onglet des conversions d'Ads Manager.
Traitez la clé d'API comme un mot de passe
OpenAI est explicite : les événements serveur doivent être envoyés uniquement depuis votre serveur. L'extension enregistre la clé pour un usage côté serveur et ne l'écrit jamais dans la page.
Résultat attendu
Erreur fréquente
Étape 3 sur 7
Installer l'extension
- 1Téléchargez le ZIP de l'extension depuis votre confirmation d'achat, ou depuis la page de téléchargement (en anglais) avec votre clé de licence.
- 2Dans WordPress, allez dans
Extensions → Ajouter une extension → Téléverser une extension(selon la version, le sous-menu s'intitule simplement « Ajouter »), choisissez le ZIP puis cliquez surInstaller maintenant. - 3Cliquez sur
Activer l'extension.
Résultat attendu
Étape 4 sur 7
Activer votre licence
Ouvrez l'onglet Licence de l'extension, collez votre clé de licence et activez-la. Aucun événement n'est envoyé tant que la licence n'est pas active.
Résultat attendu
Erreur fréquente
Étape 5 sur 7
Connecter vos identifiants
Dans l'onglet Settings de l'extension :
- Collez votre Pixel ID dans le champ
OpenAI Pixel ID. - Collez votre clé dans le champ
Conversions API key. - Laissez le suivi navigateur activé pour envoyer depuis la page les vues produit, ajouts au panier, débuts de commande et achats.
- Laissez le suivi côté serveur activé pour envoyer chaque commande payée via la Conversions API.
- Si votre bannière de consentement implémente la WordPress Consent API, activez la gestion du consentement pour que le pixel attende le consentement marketing.
Les réglages de connexion de l'extension dans WordPress. L'interface de l'extension est en anglais.
- 1OpenAI Pixel ID : obtenu à l'étape 1.
- 2Conversions API key : obtenue à l'étape 2.
- 3Interrupteurs de suivi navigateur et côté serveur : laissez-les tous deux activés.
Résultat attendu
À vérifier
Étape 6 sur 7
Vérifier les événements navigateur
- 1Ouvrez la boutique dans une fenêtre de navigation privée et acceptez les cookies marketing si une bannière s'affiche.
- 2Ouvrez les outils de développement du navigateur, onglet Réseau (Network).
- 3Filtrez les requêtes sur
openai. Le script du Measurement Pixel doit se charger depuis un hôte openai.com. - 4Consultez un produit, ajoutez-le au panier et passez à la validation de la commande, en surveillant l'apparition des nouvelles requêtes.
Résultat attendu
Erreur fréquente
Étape 7 sur 7
Vérifier une commande payée
Passez une commande que WooCommerce marque comme payée (une vraie commande de faible montant, ou une passerelle de test qui marque les commandes comme payées). Ouvrez ensuite l'onglet Diagnostics de l'extension et retrouvez la commande.
| État d'envoi | Signification | Que faire |
|---|---|---|
| Accepted | OpenAI a accepté l'achat. | Rien. Le suivi fonctionne. |
| Pending | En file d'attente ou en attente d'une nouvelle tentative. | Revenez vérifier un peu plus tard. |
| Not sent | L'achat n'a pas été envoyé, le plus souvent faute de consentement marketing pour cette commande. | Ouvrez la commande pour en voir la raison. |
| Failed | La dernière tentative n'a pas abouti. | Lisez le code HTTP, corrigez la cause, renvoyez si la commande est éligible. |
Le diagnostic liste les commandes payées et ce qu'il est advenu de chaque événement d'achat. L'interface de l'extension est en anglais.
- 1Retrouvez votre commande de test grâce à son numéro.
- 2L'ID d'événement affiché est celui que partagent l'achat navigateur et l'achat serveur.
Résultat attendu
Diagnostics.À vérifier
Dépannage
Erreurs fréquentes
La plupart des problèmes d'installation se ramènent à l'une de ces cinq situations.
| Symptôme | Cause probable | Solution |
|---|---|---|
| Les conversions semblent doublées | Le pixel est aussi installé dans le thème ou un gestionnaire de balises. | Supprimez l'autre copie. |
| Failed avec HTTP 401 | La clé Conversions API a été refusée. | Collez une clé valide, puis renvoyez depuis l'onglet Diagnostics. |
| Reste en Pending, avec relances | Le serveur ne parvient pas à joindre l'API. | Vérifiez le HTTPS sortant, le pare-feu et les règles de proxy. |
| Aucun événement navigateur | Consentement non donné, suivi désactivé ou page en cache obsolète. | Donnez votre consentement, vérifiez les réglages, videz le cache. |
| Commandes marquées Not sent | Aucun consentement marketing enregistré pour ces commandes. | Comportement attendu quand la gestion du consentement est activée. |
La section Dépannage de la documentation couvre d'autres cas.
Sans extension
L'installer à la main
Vous pouvez installer le pixel sans extension. Sur WooCommerce, le snippet n'est qu'un point de départ.
D'après les instructions d'OpenAI, il faut ajouter le snippet du pixel dans la balise <head> de chaque page où vous voulez mesurer des conversions. Ensuite :
- Chaque événement (vue produit, ajout au panier, validation de commande, achat) doit être codé avec les valeurs WooCommerce.
- L'événement d'achat doit se déclencher une fois par commande, et non à chaque chargement de la page « Commande reçue ».
- Un achat côté serveur nécessite son propre client API, déclenché au passage au statut payé.
- Les achats navigateur et serveur doivent porter le même ID d'événement pour être dédupliqués.
- Les échecs doivent être relancés et consultables quelque part.
Le guide de l'OpenAI Conversions API pour WooCommerce détaille la partie côté serveur.
Questions
Faut-il à la fois le Pixel ID et la clé d'API ?
Le Pixel ID est indispensable dans tous les cas. La clé d'API sert à l'achat côté serveur. Le suivi navigateur et le suivi côté serveur peuvent chacun être désactivés, mais garder les deux actifs donne à l'achat un second canal qui ne dépend pas du navigateur.
L'extension a-t-elle besoin de Google Tag Manager ?
Non. Elle charge le pixel et construit les événements directement à partir de WooCommerce.
Un changement de thème va-t-il casser le suivi ?
Aucun modèle n'est modifié : changer de thème ne supprime donc pas le pixel. Si votre tunnel de commande est très personnalisé, refaites tout de même un test avec une commande.
Est-ce compatible avec HPOS ?
Oui. Le stockage des commandes haute performance de WooCommerce (HPOS) et l'ancien stockage des commandes sont tous deux pris en charge.
Prêt à l'installer ?
Pixel for ChatGPT Ads est une licence annuelle pour 1, 5 ou 25 sites, avec les mêmes fonctionnalités dans chaque formule.
Guides associés
- Pixel ChatGPT Ads pour WooCommerceCe que le plugin envoie à ChatGPT Ads depuis une boutique WooCommerce, comment le configurer et ce qu'il ne fait pas.
- Envoyer les achats WooCommerce à ChatGPT Ads via la Conversions APIQuand et comment un achat WooCommerce part côté serveur, et ce que le suivi côté serveur ne résout pas.
- Pixel ChatGPT Ads ou Conversions API : lequel utiliser ?Mesure navigateur et mesure serveur comparées pour ChatGPT Ads, et pourquoi une boutique utilise les deux.