Documentation de Pixel for ChatGPT Ads

1. 1Téléchargez le ZIP de l'extension depuis votre confirmation d'achat.
2. 2Dans WordPress, allez dans Extensions → Ajouter une extension → Téléverser une extension, sélectionnez le ZIP puis cliquez sur Installer maintenant.
3. 3Cliquez sur Activer l'extension.
4. 4Ouvrez l'onglet Licence, collez votre clé de licence et activez-la.

Une licence active est nécessaire avant tout envoi d'événement de conversion. L'écran de licence affiche la formule, les activations restantes et la date de fin de validité de la licence. L'interface de l'extension est en anglais.

• Un site WordPress avec WooCommerce installé et activé.
• Une boutique servie en HTTPS.
• Des requêtes HTTPS sortantes autorisées depuis votre serveur, pour que les événements d'achat puissent atteindre la Conversions API.
• Un Pixel ID OpenAI pour la mesure dans le navigateur.
• Une clé OpenAI Conversions API pour les événements d'achat côté serveur.
• Une clé de licence Pixel for ChatGPT Ads.

Le stockage des commandes haute performance de WooCommerce (HPOS) et l'ancien stockage des commandes sous forme de publications WordPress sont tous deux pris en charge. Aucune modification du thème ni des modèles de la page de commande n'est nécessaire.

Dans l'onglet Settings, collez votre Pixel ID OpenAI dans le champ OpenAI Pixel ID et enregistrez. Avec le suivi navigateur activé, l'OpenAI Measurement Pixel se charge sur la boutique et les événements navigateur commencent à partir.

Si la gestion du consentement est activée, le pixel reste bloqué jusqu'à ce que le visiteur donne son consentement marketing (voir Consentement).

Sur le même écran, collez votre clé Conversions API dans le champ Conversions API key. La clé est enregistrée pour un usage exclusivement côté serveur. Elle n'est jamais écrite dans le code HTML de la page ni envoyée au navigateur.

Avec le suivi côté serveur activé, order_created est envoyé depuis votre serveur lorsqu'une commande WooCommerce atteint un statut payé. Chaque tentative est consignée dans l'onglet Diagnostics avec sa réponse HTTP : une clé refusée ou une limite de débit est visible, pas silencieuse.

Ces événements sont envoyés depuis la page :

• Produit consultécontents_viewed
• Ajout au panieritems_added
• Début de commandecheckout_started
• Achatorder_created

Désactiver le suivi navigateur arrête les quatre événements navigateur. Le suivi des achats côté serveur n'est pas affecté et continue de fonctionner. La comparaison Pixel vs Conversions API explique ce que chaque canal peut voir ou non.

order_created est l'événement envoyé via la Conversions API. Il se déclenche lorsque WooCommerce marque la commande comme payée, et non au chargement d'une page : un client qui ferme l'onglet avant la page « Commande reçue » génère quand même un événement d'achat. Il en va de même pour les moyens de paiement différés.

L'ID d'événement est dérivé de la commande : l'événement serveur et l'événement navigateur d'un même achat portent donc le même identifiant et peuvent être fusionnés en une seule conversion. Recharger la page « Commande reçue » ne crée pas de second identifiant.

Les envois en échec sont relancés automatiquement. Ce qui échoue encore après les relances reste dans le journal et peut être renvoyé manuellement.

Pour le contexte (pourquoi seul l'achat part côté serveur, la règle des 7 jours d'OpenAI sur l'horodatage et ce que l'envoi côté serveur ne peut pas corriger), consultez le guide de l'OpenAI Conversions API pour WooCommerce.

L'extension lit le consentement marketing via la WordPress Consent API. Si votre extension de consentement implémente cette API, elle est prise en compte sans autre configuration.

• Les événements navigateur restent bloqués jusqu'à l'obtention du consentement marketing.
• L'événement d'achat côté serveur utilise l'état de consentement enregistré pour la commande : un changement de préférence ultérieur ne modifie pas les commandes passées.
• Les commandes sans consentement marketing apparaissent dans l'onglet Diagnostics comme Not sent, et non comme un échec.

Les outils de consentement qui n'implémentent pas la WordPress Consent API ne sont pas détectés automatiquement. Vos obligations de conformité dépendent de votre boutique, de votre configuration et de votre juridiction.

L'onglet Diagnostics liste les commandes payées et ce qu'il est advenu de leur événement d'achat. Les colonnes portent les libellés anglais de l'interface :

• Order : la commande WooCommerce à laquelle appartient l'événement.
• WC paid : indique si la commande a atteint un statut payé.
• Consent : l'état du consentement marketing enregistré pour la commande.
• Delivery : envoyé, en cours de relance, en échec ou non envoyé.
• Attempts : le nombre de tentatives d'envoi.
• HTTP status : le code de réponse renvoyé lors de la dernière tentative.

Un envoi en échec peut être renvoyé depuis le même écran une fois la cause corrigée.

Les licences sont annuelles et couvrent un nombre fixe d'activations, une par installation WordPress. Désactiver un site libère son activation pour une autre boutique.

Active

Suivi autorisé. Les événements sont envoyés, les mises à jour sont distribuées et le support est disponible.

Expired

Aucun nouveau suivi des conversions. Renouvelez-la pour rétablir l'envoi des événements, les mises à jour et le support.

Disabled

Aucun nouveau suivi des conversions. La licence a été désactivée et plus aucun nouvel événement n'est envoyé.

Les noms de statut apparaissent tels quels dans l'extension, dont l'interface est pour l'instant en anglais.

Les mises à jour de l'extension arrivent par l'écran standard des mises à jour de WordPress tant que la licence est active. Voir les tarifs et limites des formules.

Aucun événement navigateur sur la boutique

Vérifiez que le suivi navigateur est activé, que le Pixel ID est enregistré et, si la gestion du consentement est activée, que le consentement marketing a été donné. Un cache de pages complet peut aussi servir une version de la page antérieure à la configuration de l'extension.

Une commande payée affiche Not sent

Le consentement marketing n'a pas été donné pour cette commande : aucun événement serveur n'a donc été envoyé. C'est le comportement voulu d'un suivi qui respecte le consentement.

Envoi en échec avec le code 401

La clé Conversions API a été refusée. Mettez à jour la clé dans l'onglet Settings, puis renvoyez l'événement depuis l'onglet Diagnostics.

L'envoi affiche 429

La requête a été limitée en débit. Elle est relancée automatiquement ; aucune action n'est nécessaire, sauf si elle finit en Failed.

Les envois restent en relance

Votre serveur ne parvient peut-être pas à joindre l'API. Vérifiez les requêtes HTTPS sortantes, les règles du pare-feu et tout proxy placé devant WordPress.

Une commande est absente du journal

L'événement d'achat est enregistré quand la commande atteint un statut payé. Les commandes encore en attente de paiement n'ont pas encore été envoyées.

Les conversions semblent doublées

Vérifiez qu'aucun second pixel n'est installé ailleurs. Un snippet dans le thème ou un conteneur de gestionnaire de balises se déclenche sans l'ID d'événement attribué par l'extension : il ne peut donc pas être dédupliqué avec l'événement serveur.

Toujours bloqué ? Envoyez-nous le numéro de commande et le code HTTP affichés dans l'onglet Diagnostics : contacter le support.