Paramètres d'URL de ChatGPT Ads : UTM, macros dynamiques et oppref

Que sont les paramètres d'URL dans ChatGPT Ads ?

Les paramètres d'URL sont les paires clé et valeur placées après le point d'interrogation dans l'adresse d'une page de destination. Dans ChatGPT Ads, ils transportent deux choses différentes, qu'il vaut mieux distinguer dès le premier jour.

Le premier type est à vous : les balises UTM et tout autre paramètre de requête que vous définissez. OpenAI indique que les paramètres de tracking statiques comme les UTM sont conservés sur les clics d'annonces et peuvent servir, dans vos outils d'analyse existants, à comprendre le trafic issu de ChatGPT Ads.

Le second type est à OpenAI : une référence de clic appelée oppref, ajoutée à la fin de l'URL de la page de destination. Elle existe pour qu'OpenAI puisse relier une conversion ultérieure au clic sur l'annonce.

Il vous faut les deux. Les UTM et les ID alimentent vos propres rapports. La référence de clic alimente la colonne Conversions de l'Ads Manager et fournit aux campagnes de conversion le signal sur lequel elles optimisent.

Quelles macros dynamiques ChatGPT Ads prend-il en charge ?

Quatre. Une macro est un espace réservé que l'Ads Manager remplace par une valeur réelle quand l'annonce est diffusée. OpenAI liste ces macros prises en charge pour les paramètres de requête de la page de destination :

OpenAI indique que l'Ads Manager remplit automatiquement les macros prises en charge au moment de la diffusion. La valeur est donc résolue quand l'annonce est servie, pas quand vous enregistrez le réglage.

À notre avis, {ad_group_id} est celle que la plupart des annonceurs sous-utilisent. Dans ce canal, le groupe d'annonces porte les context hints, l'enchère et les réglages d'audience : un ID de groupe d'annonces sur un lead vous dit donc quel thème d'intention l'a produit.

Un autre espace réservé apparaît dans la documentation développeur d'OpenAI. La page Campaign Management montre un modèle qui se termine par click_id={oppref}, ce qui recopie la référence de clic dans un nom de paramètre de votre choix. La liste des macros du centre d'aide ne l'inclut pas : considérez-le comme une option documentée côté API et testez-le avant de vous y fier.

Comment ajouter des paramètres UTM à ChatGPT Ads ?

Il existe trois méthodes documentées. Choisissez-en une comme standard et réservez les autres aux exceptions.

Dans l'Ads Manager. Les étapes d'OpenAI sont les suivantes :

1. Ouvrez la page Campaigns, Ad groups ou Ads.
2. Ouvrez le menu à trois points d'une ligne et choisissez Edit campaign, Edit ad group ou Edit ad.
3. Dans la fenêtre de modification, repérez Landing page query parameters.
4. Ajoutez les paramètres que vous voulez voir ajoutés aux URL des pages de destination, puis enregistrez.

Directement dans l'URL de destination. Les conseils créatifs d'OpenAI précisent que vous pouvez ajouter des paramètres de tracking directement aux URL de destination et inclure vos propres paramètres UTM pour chaque création. Cela convient aux annonceurs qui balisent chaque annonce à la main.

Par l'Ads API. Le champ est landing_page_configuration.query_string_template, et OpenAI indique qu'il peut être ajouté au niveau de la campagne, du groupe d'annonces ou de l'annonce. L'exemple de campagne de la documentation développeur utilise ce modèle :

utm_source=openai&utm_medium=paid&utm_campaign={campaign_id}&utm_content={ad_id}

Notez que le modèle n'est qu'une chaîne de requête. Il n'a ni point d'interrogation initial ni domaine, car il est ajouté à la page de destination vers laquelle chaque annonce pointe déjà.

À quoi doit ressembler un modèle de tracking ?

Un bon modèle a une moitié fixe, lisible par des humains, et une moitié dynamique, sur laquelle les machines peuvent faire des jointures. C'est notre recommandation, pas une exigence d'OpenAI.

La consigne de Google pour Analytics : quand vous ajoutez des paramètres à une URL, utilisez toujours utm_source, utm_medium et utm_campaign. Google décrit utm_content comme le paramètre qui sert à différencier les créations, et recommande un utm_source unique pour chaque plateforme distincte. Quel que soit le nom de source choisi, choisissez-le une fois pour toutes. L'exemple d'OpenAI utilise openai. Beaucoup d'annonceurs préfèrent chatgpt. Les deux conviennent, tant que toutes les campagnes utilisent le même.

Si vous voulez aussi le groupe d'annonces, ajoutez un paramètre à vous, par exemple oai_adgroup={ad_group_id}. Un préfixe comme oai_ évite que vos clés entrent en collision avec les paramètres d'une autre plateforme sur une page de destination partagée. Là encore, c'est notre convention, pas une règle documentée.

Quelques habitudes gardent un modèle en état de marche :

• Écrivez les macros exactement comme elles sont documentées, en minuscules, avec des tirets bas et des accolades simples.
• Placez les macros dans les valeurs. Dans tous les exemples documentés, la macro est à droite du signe égal.
• N'y mettez aucune donnée personnelle. Les URL finissent dans les journaux, les outils d'analyse et l'historique des navigateurs.
• Modifiez le modèle de façon délibérée. Une clé modifiée coupe votre historique en deux lignes.

Quel niveau l'emporte quand des paramètres se contredisent ?

Le réglage le plus précis l'emporte. Le centre d'aide d'OpenAI donne cette hiérarchie :

1. URL de l'annonce
2. Annonce
3. Groupe d'annonces
4. Campagne

Si un paramètre figure déjà dans l'URL de l'annonce, les réglages de la campagne, du groupe d'annonces ou de l'annonce ne l'écrasent pas.

La documentation développeur ajoute deux détails. D'abord, les paramètres des différents niveaux se cumulent : un modèle de campagne et un ajout au niveau de l'annonce atteignent tous deux la page de destination. La priorité ne joue que pour un paramètre en double. Ensuite, l'ordre de l'API va un cran plus loin : URL de destination existante, annonce, groupe d'annonces, campagne, puis compte publicitaire.

En pratique, définissez un seul modèle au niveau de la campagne, avec des macros. Chaque groupe d'annonces et chaque annonce en dessous en hérite, et les nouvelles annonces sont balisées sans que personne ait à y penser. Ne dérogez plus bas que si une annonce exige vraiment une autre valeur.

La règle a un effet de bord à connaître. Si quelqu'un a collé il y a des mois un utm_campaign écrit à la main dans l'URL de destination d'une annonce, votre nouveau modèle de campagne ne le remplacera pas. Quand un rapport affiche une annonce avec une valeur de campagne étrange, vérifiez d'abord l'URL de l'annonce.

Qu'est-ce qu'oppref et en quoi diffère-t-il d'un UTM ?

oppref est la référence de clic d'OpenAI. OpenAI indique qu'elle est ajoutée à la fin de l'URL de la page de destination, et en donne le format www.openai.com?oppref=gAAAAAb123. La documentation développeur la qualifie d'identifiant respectueux de la vie privée, et la référence de la Conversions API la décrit comme un identifiant d'attribution opaque, fourni par OpenAI, que vous transmettez sous la forme de la chaîne d'origine, sans modification.

Son sort dépend de la façon dont vous envoyez les conversions :

Le pixel demande une durée de vie du cookie de 30 jours après l'avoir écrit. Chaque fois que le pixel capte un oppref non vide dans une URL, il remet l'expiration à 30 jours. Lire le cookie stocké lors d'une visite sans le paramètre ne la prolonge pas. OpenAI note que les restrictions des navigateurs ou la suppression des cookies peuvent raccourcir ces durées, et qu'un appel à oaiq("consent", false) supprime le cookie.

OpenAI précise aussi que l'expiration du cookie est distincte des fenêtres d'attribution des conversions. La durée de vie du cookie ne décrit que le stockage dans le navigateur. Les fenêtres de reporting se choisissent dans l'Ads Manager, où la fenêtre post-clic peut être de 7, 14 ou 30 jours. Pour ce volet, voir reporting et confidentialité.

La configuration complète du pixel et du serveur est traitée dans le suivi des conversions.

Pourquoi des paramètres disparaissent-ils entre le clic et la page ?

Presque toujours parce que quelque chose, entre l'annonce et la page finale, réécrit l'URL. OpenAI demande aux annonceurs de conserver oppref à travers les redirections et la navigation sur la page de destination, et ses conseils sur la qualité des événements recommandent de tester le parcours complet, y compris les liens de tracking, les redirections, le paiement et tout passage de relais entre le navigateur et le serveur.

D'après notre expérience, voici les causes habituelles :

• Une redirection d'un domaine ou d'un chemin vers un autre, qui fait tomber la chaîne de requête.
• Un raccourcisseur de liens ou une redirection de tracking placés devant la page de destination.
• Un bandeau cookies ou un script qui recharge la page sur une URL nettoyée.
• Un outil de pages de destination ou une application monopage qui réécrit l'URL à la première navigation.
• Un formulaire sur une seconde page qui n'a jamais vu les paramètres d'origine.

Les mêmes défauts suppriment vos UTM et vos ID, pas seulement la référence de clic. Un seul test couvre donc les deux : cliquez sur une annonce en ligne, suivez chaque saut et lisez la barre d'adresse sur la page finale.

La page d'OpenAI sur la qualité des événements ajoute un avertissement pour les configurations côté serveur : ne réutilisez pas les informations de clic d'une autre personne et ne les remplacez pas par une valeur par défaut. Une référence manquante doit rester manquante.

Quand la référence est perdue, l'advanced matching automatique peut aider. OpenAI le décrit comme un moyen de relier les conversions de votre site à vos annonces quand un identifiant de clic n'est pas disponible. C'est un repli, pas un substitut.

Ne jugez pas les macros sur un aperçu. OpenAI indique que les macros sont remplies au moment de la diffusion et qu'un aperçu d'annonce montre l'apparence. À nos yeux, la seule vérification fiable est un vrai clic sur une annonce en diffusion. Si l'annonce ne diffuse pas encore, voir pourquoi les annonces ChatGPT ne diffusent pas.

Comment lire les paramètres dans Google Analytics ?

Les paramètres UTM ne demandent aucune configuration. Google indique que, lorsqu'un utilisateur clique sur un lien, les paramètres d'URL sont envoyés à Analytics et que leurs valeurs sont visibles dans le rapport Traffic acquisition.

Les clés personnalisées, comme un paramètre de groupe d'annonces, demandent plus de travail. Google décrit la séquence valable pour toute donnée personnalisée :

1. Ajoutez un paramètre d'événement ou une propriété utilisateur au code de votre site.
2. Un utilisateur visite le site et la donnée personnalisée est envoyée à Google Analytics.
3. Créez une dimension personnalisée pour pouvoir analyser la donnée.
4. Après 24 à 48 heures, vous pouvez commencer à exploiter la dimension personnalisée dans vos rapports.

La limite documentée par Google pour une propriété standard est de 50 dimensions personnalisées de portée événement et de 25 de portée utilisateur. Trois ou quatre dimensions d'ID y tiennent sans peine, mais elles ne sont pas gratuites : n'enregistrez que celles que vous exploiterez.

Une étape vient de nous, pas de Google : stockez les valeurs à l'arrivée. Un paramètre qui n'existe que sur la page de destination a disparu quand le visiteur convertit trois pages plus loin. Enregistrez-le dans un stockage first-party à l'arrivée du visiteur, dans le respect de vos règles de consentement, et relisez-le quand la conversion se déclenche.

Pourquoi les clics de l'Ads Manager ne correspondent-ils pas aux sessions de l'outil d'analyse ?

Parce qu'ils ne mesurent pas la même chose. OpenAI explique que les clics mesurent des interactions avec l'annonce, tandis que les sessions d'un outil d'analyse dépendent du chargement de la page, des redirections, des réglages de consentement, des blocages du navigateur, du traitement des UTM, des fenêtres d'attribution et des réglages de fuseau horaire.

Pour comparer équitablement, OpenAI conseille de prendre la même période et le même fuseau horaire, puis d'utiliser des exports CSV pour vérifier l'activité par campagne et par annonce.

Le moment compte aussi. OpenAI indique que les impressions, les clics et le CTR se rafraîchissent en général toutes les 15 minutes environ, que les statistiques de dépenses ont un retard d'environ 7 à 8 heures, et que les conversions attribuées peuvent mettre 24 à 48 heures à apparaître. Comparer les chiffres du jour entre deux outils donnera rarement le même résultat.

Un écart n'indique pas forcément une erreur. Cette phrase est d'OpenAI, tirée de sa page sur la mesure des conversions.

Comment transmettre les ID de campagne et d'annonce à un CRM ?

Captez-les au niveau du formulaire. En génération de leads, la valeur du balisage apparaît après l'envoi du formulaire, car le chiffre d'affaires vit dans le CRM et non dans l'Ads Manager.

1. Lisez les paramètres à l'arrivée du visiteur et stockez-les.
2. Ajoutez à chaque formulaire des champs masqués pour les valeurs de campagne, de groupe d'annonces et d'annonce.
3. Associez ces champs à des propriétés de la fiche du lead.
4. Vérifiez que les valeurs survivent quand un lead devient une affaire ou une opportunité.

Avec {campaign_id}, {ad_group_id} et {ad_id} sur chaque lead, vous voyez quel groupe d'annonces a produit les leads devenus clients, et pas seulement quelle annonce a produit des clics.

Les macros renvoient des ID, pas des noms. Les macros documentées sont toutes des ID, et OpenAI ne liste aucune macro pour le nom d'une campagne ou d'un groupe d'annonces. Tenez une table de correspondance entre ID et nom, et ajoutez-y une ligne à chaque création de campagne ou de groupe d'annonces. Les endpoints de reporting de l'Ads API acceptent campaign_id comme champ : un utilisateur de l'API peut donc reconstruire la table à partir d'un rapport.

Les ID ont un vrai avantage sur les libellés. Un nom peut être modifié à tout moment, alors que l'ID reste le même : les anciennes et les nouvelles lignes se rejoignent toujours.

C'est aussi la base pour renvoyer les leads qualifiés à OpenAI sous forme d'événements de conversion, sujet traité dans les campagnes de conversion.

Les paramètres d'URL fonctionnent-ils avec les flux de produits et les partenaires de mesure ?

Oui, avec quelques particularités documentées.

Campagnes de flux de produits. Dans une campagne de flux, le produit sélectionné fournit l'URL de destination. OpenAI indique que, pour ajouter des paramètres de tracking aux URL des produits, vous utilisez landing_page_configuration sur la campagne, le groupe d'annonces ou l'annonce. Par ailleurs, les bonnes pratiques commerce d'OpenAI suggèrent d'ajouter des paramètres d'attribution du flux au champ url du produit, avec utm_medium=feed comme exemple, et de garder des paramètres de tracking internes cohérents d'un instantané à l'autre. Plus de détails dans notre guide du flux de produits.

Partenaires de mesure. Les instructions d'OpenAI pour les partenaires mentionnent le balisage des URL à trois endroits :

Si vous utilisez l'un de ces outils, ses paramètres passent en premier et votre propre modèle ne doit pas écraser ses clés. Voir les partenaires de mesure.

Questions fréquentes sur les paramètres d'URL de ChatGPT Ads

Quels paramètres d'URL dynamiques ChatGPT Ads prend-il en charge ?

Le centre d'aide d'OpenAI liste quatre macros prises en charge : {campaign_id}, {ad_group_id}, {ad_id} et {ad_account_id}. L'Ads Manager les remplit automatiquement au moment de la diffusion. Vous pouvez les mélanger à votre propre texte fixe.

Où se trouve le réglage dans l'Ads Manager ?

Ouvrez le menu à trois points sur la page Campaigns, Ad groups ou Ads, choisissez l'option Edit correspondante et utilisez le champ nommé Landing page query parameters.

Un modèle au niveau de la campagne écrasera-t-il les UTM déjà présents dans l'URL de mon annonce ?

Non. OpenAI indique que si un paramètre est déjà défini au niveau de l'URL de l'annonce, les réglages de la campagne, du groupe d'annonces ou de l'annonce ne l'écrasent pas.

Puis-je voir le nom de la campagne à la place de l'ID ?

Pas par une macro. Les quatre macros documentées renvoient des ID. Écrivez un libellé lisible en texte fixe dans le modèle, ou tenez une table de correspondance entre ID et nom.

oppref est-il un paramètre UTM ?

Non. C'est la référence de clic d'OpenAI, ajoutée automatiquement, qui identifie le clic pour la mesure des conversions. Les UTM sont des libellés que vous choisissez pour vos propres outils d'analyse. OpenAI vous demande de conserver oppref à travers les redirections et la navigation sur la page de destination.

Combien de temps le pixel garde-t-il oppref en mémoire ?

La documentation développeur d'OpenAI donne au cookie __oppref une expiration de 30 jours après son écriture par le pixel, et note que les restrictions des navigateurs ou la suppression des cookies peuvent la raccourcir.

Dois-je envoyer oppref avec les événements côté serveur ?

Oui, quand il est disponible. OpenAI indique que la Conversions API ne capte pas oppref à votre place : vous captez donc la valeur vous-même et vous la transmettez telle quelle avec l'événement serveur.

Puis-je mettre des informations client dans un paramètre d'URL ?

Ne le faites pas. La documentation de l'image tag d'OpenAI demande de ne placer ni données personnelles, ni secrets, ni ID de session, ni identifiants de client, ni identifiants de commande dans un paramètre de requête. Nous appliquons la même règle aux URL des pages de destination.

Pourquoi mon rapport affiche-t-il le texte de la macro à la place d'un nombre ?

OpenAI ne documente pas ce cas. D'après notre expérience, les causes sont une macro mal orthographiée, une macro qui ne fait pas partie des quatre prises en charge, ou une URL copiée depuis un aperçu et non depuis une annonce diffusée. Vérifiez avec un vrai clic avant de modifier quoi que ce soit.

Ai-je encore besoin du suivi des conversions si j'utilise des UTM ?

Oui. Les UTM n'informent que vos propres outils. La colonne Conversions de l'Ads Manager et la diffusion optimisée pour la conversion dépendent des événements envoyés par le pixel ou par la Conversions API. Commencez par le suivi des conversions, et consultez le glossaire pour tout terme employé ici.