Module ChatGPT Ads pour PrestaShop : conversions, ajout au panier et CAPI

Ce que fait le module, évènement par évènement

Le module traduit le parcours d’achat PrestaShop dans les évènements standard définis par OpenAI :

• contents_viewed sur la fiche produit, avec l’identifiant, le nom et le prix de la déclinaison affichée ;
• items_added à l’ajout au panier, y compris l’ajout en AJAX depuis une liste de produits ou la fenêtre modale du thème ;
• checkout_started à l’entrée dans le tunnel de commande ;
• order_created à l’achat, envoyé à la fois par le pixel sur la page de confirmation et par le serveur ;
• registration_completed à la création de compte client, et lead_created sur le formulaire de contact si vous le souhaitez.

L’évènement d’achat est celui qui compte le plus : c’est lui que vous choisirez comme objectif d’une campagne optimisée pour la conversion. Il part du serveur dès que PrestaShop valide la commande, par le hook actionValidateOrder, qu’un client revienne ou non de la page de paiement. Pour les moyens de paiement différés, virement ou chèque, nous décidons ensemble du statut de commande qui fait foi.

oppref, déduplication et données envoyées

Quand un visiteur arrive depuis une annonce, l’URL porte un paramètre oppref. Le pixel le range dans le cookie __oppref, mais la Conversions API ne le lit pas d’elle-même. Le module le récupère donc à l’arrivée, l’associe au panier PrestaShop, puis à la commande, et le joint à l’appel serveur avec l’identifiant de navigateur obref. Un client qui revient finaliser son panier trois jours plus tard reste rattaché à son clic.

Pour la déduplication, le module génère un identifiant opaque à la création de la commande et l’utilise des deux côtés : event_id dans le pixel, id dans la Conversions API, avec le même Pixel ID et le même nom d’évènement. OpenAI conserve alors une seule vente. Le montant part en entier dans l’unité mineure de la devise de la commande, comme l’exige la documentation.

Les e-mails et téléphones des clients ne quittent jamais la boutique en clair : ils sont normalisés puis hachés en SHA-256 avant l’envoi. La clé de la Conversions API reste stockée côté serveur, dans la configuration du module, jamais dans le JavaScript du thème.

Consentement, RGPD et outils de bannière

Rien n’est chargé ni envoyé avant le consentement du visiteur : pas de script, pas de cookie __oppref ni __obref, pas d’appel serveur. Le module est compatible avec tarteaucitron.js, où le pixel est déclaré comme service personnalisé, et avec Axeptio, Cookiebot, Didomi, CookieYes ou Complianz, où il est rattaché à la finalité marketing. Il sait aussi lire le signal de stockage publicitaire du mode consentement de Google quand la bannière le publie.

L’état du consentement est enregistré avec la commande : un client qui a refusé ne sera pas transmis par la Conversions API. Je vous remets la liste exacte des données envoyées, pour votre politique de confidentialité et votre registre des traitements ; le choix de la base légale reste le vôtre ou celui de votre DPO.

Compatibilité PrestaShop

Le module est conçu pour PrestaShop 1.7, 8 et 9. Il s’appuie sur les hooks standard plutôt que sur des surcharges du cœur : il ne modifie ni les classes de PrestaShop ni les fichiers du thème, et se désinstalle proprement. En multiboutique, chaque boutique peut avoir son propre Pixel ID et sa propre clé ; en multidevise, chaque commande est envoyée dans sa devise. Un journal consultable depuis le back-office garde la trace des envois serveur et des réponses d’OpenAI, ce qui permet de vérifier un écart sans ouvrir les fichiers du serveur.

Un thème très personnalisé ou un tunnel de commande en une page tiers peut demander un ajustement : c’est précisément pour cela que je fais l’installation moi-même plutôt que de vous laisser un fichier à téléverser. Pour la logique générale du suivi ChatGPT Ads, lisez le guide complet sur le pixel OpenAI, la Conversions API et le consentement.