Où trouver la clé Conversions API et comment est-elle utilisée ?

La clé Conversions API est une clé secrète qui autorise l’envoi d’événements de conversion depuis le serveur de votre boutique vers OpenAI. Elle est nécessaire lorsque vous activez la Conversions API dans le module ChatGPT Ads.

Elle ne doit pas être confondue avec le Pixel ID : le Pixel ID identifie votre source de données Web, tandis que la clé Conversions API authentifie les envois côté serveur associés à cette source.

Créer et récupérer la clé dans OpenAI Ads Manager

Connectez-vous à OpenAI Ads Manager, puis ouvrez la section « Conversions ». Sélectionnez la source de données Web associée à votre boutique et créez une clé Conversions API pour cette source.

Copiez la clé lorsqu’elle est affichée et conservez-la dans un emplacement sûr. Elle permet au module d’envoyer des événements au nom de votre source de données.

Renseigner la clé dans le module

Dans la configuration du module ChatGPT Ads, renseignez la clé Conversions API dans le champ prévu à cet effet. Vérifiez également que le Pixel ID configuré dans le module correspond à la même source de données Web dans OpenAI Ads Manager.

Après avoir enregistré la configuration, le module peut utiliser cette clé pour transmettre les événements côté serveur, par exemple lorsqu’une commande est validée, selon les options activées dans votre configuration.

À quoi sert la clé ?

La clé permet à OpenAI de vérifier que les événements envoyés par le module sont autorisés pour la source de données concernée. Elle est utilisée pour les appels côté serveur de la Conversions API, et non pour l’affichage du Pixel dans le navigateur du visiteur.

Les événements envoyés avec cette clé peuvent contenir les informations nécessaires à la mesure d’une conversion, telles que le type d’événement, sa date, son identifiant, le montant et la devise lorsque ces données sont applicables.

Lorsque la même conversion est envoyée à la fois par le Pixel et par la Conversions API, les deux envois doivent utiliser le même Pixel ID et le même identifiant d’événement. OpenAI peut ainsi dédupliquer l’action et éviter qu’elle soit comptabilisée deux fois.

Protéger la clé Conversions API

Traitez cette clé comme une information confidentielle. Ne l’ajoutez pas dans le code de votre thème, dans une page publique, dans un script exécuté dans le navigateur ou dans une capture d’écran partagée.

Si vous pensez que la clé a été divulguée, créez une nouvelle clé dans OpenAI Ads Manager, remplacez l’ancienne dans la configuration du module et désactivez ou révoquez la clé compromise selon les options disponibles dans votre compte.

Vérifier l’envoi des événements

Après avoir configuré la clé, utilisez le mode Validation uniquement pour vérifier que les nouveaux événements sont acceptés sans les enregistrer comme conversions réelles. Désactivez ce mode après avoir contrôlé votre configuration.

Consultez notre FAQ À quoi sert le mode Validation et quand faut-il le désactiver ?. Pour comprendre le rôle de la Conversions API, consultez également notre FAQ À quoi sert la Conversions API et comment fonctionne-t-elle ?.

Vous trouverez des informations complémentaires dans la documentation officielle de la Conversions API OpenAI Ads et dans la documentation Conversion Setup.