Configurer le pixel OpenAI Ads (ChatGPT Ads) avec Google Tag Manager

Introduction au tracking des publicités ChatGPT

OpenAI propose désormais de diffuser des publicités dans ChatGPT. Comme pour toute plateforme publicitaire, OpenAI ne peut pas savoir ce qui se passe sur votre site après un clic sur une annonce. Le Measurement Pixel est le script à installer sur votre site pour informer OpenAI des actions réalisées par vos visiteurs : pages vues, ajouts au panier, achats, leads, inscriptions.

Ces remontées servent à trois choses :

• Attribuer vos conversions : OpenAI relie chaque conversion à un clic sur une annonce (attribution post-clic) et, lorsque la fonctionnalité est disponible sur votre compte, à une impression (attribution post-vue, sur une fenêtre fixe d’un jour).
• Optimiser vos campagnes : l’enchère, le calcul du CPA et l’optimisation des conversions reposent sur les conversions post-clic remontées par le pixel.
• Mesurer vos performances dans Ads Manager, avec des montants et des devises fiables.

Plutôt que d’ajouter le snippet officiel dans une balise HTML personnalisée puis d’écrire vous-même chaque appel oaiq("measure", ...), nous allons utiliser la balise OpenAI Ads Measurement Pixel by DMS, que j’ai développée pour Google Tag Manager Web. Elle charge le SDK, lit votre dataLayer au format GA4, convertit les montants au format attendu par OpenAI et hache les données utilisateur dans le navigateur.

Ajouter la balise OpenAI Ads Measurement Pixel by DMS

Téléchargez ici le fichier template.tpl de la balise.

Rendez-vous dans la section Templates de Google Tag Manager. Dans la section Tag Templates, cliquez sur New.

Cliquez sur les 3 petits points en haut à droite de l’éditeur de modèle, puis sur Import. Sélectionnez le fichier template.tpl que vous venez de télécharger puis cliquez sur Save.

La balise est désormais disponible dans la liste de vos modèles lorsque vous créez une nouvelle balise.

Récupérer votre Pixel ID

Dans OpenAI Ads Manager, rendez-vous dans Tools > Conversions, onglet Data Source, et créez une source de données web. OpenAI vous fournit un Pixel ID, une chaîne de 22 caractères qui ressemble à Xk3PqR8mZt2vLn7wHs5yBa, affichée sous le nom de la source.

C’est ce même Pixel ID qui sert au pixel navigateur et, si vous en avez besoin, à l’API de conversions côté serveur.

Configurer la balise

Rendez-vous dans la section Tags de Google Tag Manager, cliquez sur New et sélectionnez la balise OpenAI Ads Measurement Pixel by DMS.

Pixel ID(s)

Renseignez votre Pixel ID. Pour envoyer le même événement à plusieurs pixels, par exemple un pixel par marque ou un pixel pour votre agence, séparez les identifiants par une virgule : Xk3PqR8mZt2vLn7wHs5yBa, 7kPz2QxLm4Ns8vRtYb1cDw.

Chaque pixel est initialisé à chaque déclenchement et reçoit l’événement via la commande measureSingle du SDK. Contrairement à la commande measure, elle ne cible que le pixel indiqué : si un autre pixel OpenAI est déjà présent sur la page, il ne recevra pas vos événements.

Event Name Setup Method

Ce champ détermine le nom de l’événement OpenAI envoyé. Deux modes sont disponibles.

Inherit From dataLayer (par défaut) : la balise lit le nom de l’événement dataLayer sur lequel elle se déclenche et le convertit en événement OpenAI. Voir la table de correspondance des événements GA4 vers OpenAI. Un événement dataLayer qui n’a pas d’équivalent est envoyé en tant qu’événement custom, dont le nom est celui de l’événement dataLayer en minuscules, les caractères non autorisés étant remplacés par _. Un événement Newsletter Signup devient donc l’événement custom newsletter_signup côté OpenAI.

Override : vous choisissez vous-même l’événement. Le champ Event Type propose Standard Event, qui affiche la liste déroulante des événements standards d’OpenAI, ou Custom Event, qui affiche le champ Custom Event Name.

Un nom d’événement custom doit contenir entre 1 et 64 caractères (lettres, chiffres, tirets ou underscores), commencer et finir par une lettre ou un chiffre, et ne pas reprendre le nom d’un événement standard. Sinon la balise échoue et explique pourquoi dans la console de la preview.

Ecommerce Data

Lorsque la case Read e-commerce data from the dataLayer est cochée (par défaut), la balise lit l’objet ecommerce de votre dataLayer : ecommerce.value devient le montant de l’événement, ecommerce.currency sa devise et ecommerce.items la liste des contenus.

Les champs Amount, Currency et Plan ID permettent de forcer une valeur. Un champ renseigné l’emporte toujours sur la valeur du dataLayer.

Le type de données de l’événement est choisi automatiquement à partir de son nom : les événements lead_created, registration_completed et appointment_scheduled n’acceptent qu’un montant et une devise, jamais de contenus. Plan ID n’est envoyé qu’avec subscription_created, trial_started et les événements custom.

Items Data

Cette section pilote la construction du tableau contents envoyé à OpenAI.

• Contents : une variable renvoyant un tableau d’items. Elle remplace ecommerce.items lorsqu’elle est renseignée.
• Item ID Key, Item Name Key, Quantity Key, Price Key : les clés lues dans chaque item pour alimenter id, name, quantity et amount. Par défaut, item_id, item_name, quantity et price, c’est-à-dire le schéma GA4.
• Content Type Key : optionnel, la clé lue pour content_type, par exemple item_category.
• Default Content Type : la valeur envoyée lorsque aucune clé n’est définie ou que l’item n’en a pas. product par défaut.

Les clés acceptent la notation pointée, par exemple product.sku, ce qui permet d’utiliser la balise avec un dataLayer dont les produits ne suivent pas le schéma GA4, sans passer par une variable de transformation. Le prix de chaque item est lu dans l’unité principale puis converti en unité mineure avec la devise de l’événement.

User Data

Lorsque la case Read user data from the dataLayer est cochée (par défaut), la balise lit l’objet user_data du dataLayer. Elle accepte aussi bien le format GA4 imbriqué (user_data.address.first_name) qu’un format aplati (user_data.first_name), et reconnaît plusieurs alias de clés. Voir la table des clés lues.

Les champs Email Address, Phone Number, External ID, First Name et Last Name permettent de renseigner une valeur manuellement. Les champs Country, City, Region et Postal Code sont transmis en clair, comme le prévoit OpenAI.

Pensez à pousser les numéros de téléphone avec l’indicatif international (+353 1 555 0123). Un numéro national perd son zéro initial lors de la normalisation et ne correspondra pas au même utilisateur saisi avec l’indicatif.

Event ID Deduplication

Si vous envoyez le même événement à la fois côté navigateur (via cette balise) et côté serveur (via l’API de conversions d’OpenAI), OpenAI risque de compter deux fois la même conversion. Pour l’éviter, on transmet un Event ID identique dans les deux envois : OpenAI conserve le premier événement reçu pour un même Pixel ID, nom d’événement et Event ID, et ignore le doublon.

Renseignez le champ Event ID avec une variable qui génère un identifiant unique et stable pour un même événement, par exemple la variable Event Id de mbaersch disponible dans la galerie GTM Web. Lorsque le champ est vide, aucun Event ID n’est envoyé.

Transmettez la même variable dans le paramètre event_id de vos balises GA4 envoyées au conteneur serveur : la balise OpenAI CAPI d’Addingwell by Didomi réutilise automatiquement ce paramètre comme identifiant d’événement, et OpenAI peut alors dédupliquer les deux envois.

Pixel Options

• Opt Out This Event From User-Level Personalization : envoie opt_out: true avec l’événement, pour l’exclure de la personnalisation au niveau utilisateur.
• Enable SDK Debug Mode : active le mode debug du SDK, qui journalise son activité dans la console du navigateur avec le préfixe [oaiq]. Pratique pendant vos tests, à désactiver en production.

Déclencher la balise

La façon de déclencher la balise dépend du format de votre dataLayer : une seule balise en mode Inherit From dataLayer s’il respecte le standard GA4, une balise par événement en mode Override sinon.

Méthode 1 : avec un dataLayer au format standard GA4

Si votre dataLayer respecte le standard GA4, une seule balise suffit. Renseignez votre Pixel ID, laissez Inherit From dataLayer sélectionné et les deux cases de lecture du dataLayer cochées.

Déclenchez ensuite la balise sur l’ensemble des événements que vous souhaitez envoyer à OpenAI, sans oublier les pages vues. Dans cet exemple, je la déclenche sur gtm.init (déclencheur Initialization - All Pages), view_item, add_to_cart, begin_checkout, purchase et generate_lead.

Méthode 2 : avec un dataLayer custom

Si votre dataLayer est custom, créez une balise par événement OpenAI en mode Override, et faites vous-même la correspondance entre vos événements dataLayer et les événements OpenAI.

Exemple avec un événement dataLayer custom AddToCart

dataLayer.push({
  event: "AddToCart",
  cart: {
    currency: "EUR",
    total: 30.03,
    products: [
      {
        sku: "SKU_12345",
        title: "Stan and Friends Tee",
        category: "Apparel",
        unit_price: 10.01,
        qty: 3
      }
    ]
  },
  user_data: {
    email: "[email protected]",
    phone: "+353 1 555 0123",
    first_name: "Jane",
    last_name: "Doe"
  }
});

Configurez la balise ainsi :

Gérer le consentement

La balise n’appelle jamais la commande oaiq("consent", ...) du pixel : c’est votre déclencheur GTM qui décide si elle se déclenche, en fonction du choix exprimé par le visiteur dans votre CMP (plateforme de gestion du consentement).

Le pixel OpenAI est un vendor publicitaire. Conditionnez donc le déclenchement de la balise à l’acceptation du vendor OpenAI dans votre CMP ou, si votre CMP ne gère pas ce vendor, à l’acceptation de la catégorie de finalités qui le représente : Targeting, Advertising, Performance, ou par exemple la catégorie C0004 (Targeting Cookies) avec OneTrust.

Quelle que soit votre CMP, la logique est la même :

• Une variable GTM qui retourne granted lorsque le vendor OpenAI ou sa catégorie est accepté, denied sinon.
• Un déclencheur pour la page vue, branché sur l’événement que votre CMP pousse dans le dataLayer lorsque le consentement est connu ou mis à jour, avec la condition variable égale à granted. Il remplace le déclencheur Initialization - All Pages de la méthode 1, de façon à ne pas perdre la page vue lorsque le visiteur accepte après le chargement de la page.
• La même condition ajoutée à vos déclencheurs d’événements dataLayer (add_to_cart, purchase, generate_lead…).

Voici comment procéder avec Axeptio, Didomi et OneTrust. Adaptez la même logique à votre CMP.

Pour vérifier, ouvrez la preview GTM sur une page de votre site avant d’avoir fait votre choix dans la bannière : la balise ne doit pas apparaître dans les balises déclenchées et aucune requête vers bzr.openai.com ne doit partir. Acceptez ensuite le vendor OpenAI ou sa catégorie : la balise doit se déclencher sur l’événement de votre CMP et la requête events apparaître dans l’onglet Network.

Si votre site utilise déjà la commande de consentement du pixel OpenAI, elle reste entièrement sous votre contrôle : la balise ne la modifie pas.

Vérifier sa configuration

Avant de publier, vérifiez que les événements partent correctement. Trois outils sont utiles : la preview GTM, l’onglet Network du navigateur et l’Event Stream d’Ads Manager.

Preview GTM

Cliquez sur Preview en haut à droite de GTM et naviguez sur votre site. Pour chaque événement dataLayer concerné, la balise doit apparaître avec le statut Succeeded.

Ouvrez ensuite l’onglet Console de la preview. La balise y journalise chaque envoi avec le préfixe OpenAI Measurement Pixel, en indiquant le nom de l’événement, les Pixel ID ciblés, les données de l’événement et l’objet utilisateur haché. C’est le moyen le plus rapide de vérifier que le montant a bien été converti et que les identifiants ont bien été hachés.

Onglet Network

Dans les outils de développement du navigateur, filtrez les requêtes sur bzr. Vous verrez trois requêtes : le chargement du SDK oaiq.min.js, la configuration de votre pixel (un fichier JSON nommé d’après votre Pixel ID) et la requête events qui porte vos conversions. Le SDK regroupe les événements proches dans le temps et les envoie en POST vers /v1/sdk/events. Les événements openai::sdk_init et oai::diagnostic qui accompagnent les vôtres sont émis par le SDK lui-même, c’est normal. Le corps de la requête contient vos événements, l’identifiant de clic oppref s’il est présent, et un objet user avec deux blocs possibles :

• in : les identifiants que vous avez transmis via la balise (em pour l’email, ph pour le téléphone, fn et ln pour le prénom et le nom, eid pour l’identifiant externe).
• fm, ht ou js : les identifiants détectés automatiquement par le pixel dans vos formulaires, votre HTML ou vos scripts, lorsque la correspondance avancée automatique est activée sur votre pixel.

Si le même email apparaît dans in et dans un formulaire de la page, le SDK ne l’envoie qu’une fois : sa disparition du bloc fm est le signe que le hachage de la balise est identique à celui du pixel.

Event Stream dans Ads Manager

Dans OpenAI Ads Manager, la section Conversions propose un onglet Event Stream qui liste les derniers événements reçus par votre pixel. C’est la confirmation finale que vos conversions arrivent bien avec le bon nom, le bon montant et la bonne devise.

Erreurs fréquentes

Tables de correspondance GA4 => OpenAI

Table de correspondance des événements dataLayer

Table de correspondance des paramètres e-commerce

Table des clés user_data

Content Security Policy

Si votre site applique une Content Security Policy, autorisez https://bzrcdn.openai.com dans script-src et connect-src, ainsi que https://bzr.openai.com dans connect-src et img-src. Sans cela, le SDK ne se chargera pas ou ne pourra pas envoyer les événements.

Conclusion

La balise OpenAI Ads Measurement Pixel by DMS vous permet d’installer le pixel des publicités ChatGPT sans écrire une ligne de code : elle exploite votre dataLayer GA4 existant, respecte les formats attendus par OpenAI pour les montants et les identifiants, et prépare la déduplication avec l’API de conversions. Le code source est disponible sur GitHub sous licence Apache 2.0 : n’hésitez pas à ouvrir une issue si vous rencontrez un cas non couvert.

FAQ - Pixel OpenAI Ads