À quoi sert la Conversions API et comment fonctionne-t-elle ?

La Conversions API permet d’envoyer des événements de conversion directement depuis le serveur de votre boutique vers OpenAI. Contrairement au Pixel, qui envoie des événements depuis le navigateur du visiteur, elle transmet les événements côté serveur.

Elle est particulièrement utile pour mesurer des actions confirmées par votre boutique, comme une commande validée. Elle peut également compléter le Pixel lorsque les conditions de navigation, le consentement ou les bloqueurs empêchent l’envoi d’un événement depuis le navigateur.

Le rôle de la Conversions API

La Conversions API transmet à OpenAI les événements de conversion associés à votre boutique. OpenAI peut ensuite les comparer aux événements configurés pour vos campagnes et à la fenêtre d’attribution applicable.

Un événement peut être comptabilisé comme conversion lorsqu’il est reçu depuis une source de données associée à votre compte publicitaire, correspond à une conversion configurée pour la campagne et peut être rapproché d’une interaction publicitaire éligible.

La Conversions API ne garantit pas l’attribution de chaque commande à une publicité. Elle améliore cependant la fiabilité de la mesure en permettant l’envoi d’événements directement depuis le serveur.

Configurer la Conversions API dans le module

Pour utiliser la Conversions API, créez d’abord une clé dédiée dans OpenAI Ads Manager pour la source de données concernée. Renseignez ensuite cette clé et le Pixel ID correspondant dans la configuration du module, puis activez l’envoi d’événements côté serveur.

La clé Conversions API est liée à une source de données. Utilisez donc une clé et un Pixel ID associés au même compte publicitaire et à la même source de données Web.

Pour savoir où récupérer cette clé, consultez notre FAQ Où trouver la clé Conversions API et comment est-elle utilisée ?.

Utiliser le Pixel et la Conversions API ensemble

Le Pixel et la Conversions API peuvent être utilisés ensemble. Cette configuration permet de combiner les événements observés dans le navigateur avec les événements confirmés par le serveur de votre boutique.

Lorsqu’une 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, le même nom d’événement et le même identifiant d’événement. OpenAI peut ainsi reconnaître qu’il s’agit de la même action et éviter de la comptabiliser deux fois.

Référence de clic et correspondance des clients

Lorsqu’elle est disponible, la référence de clic OpenAI, nommée oppref, peut être transmise avec les événements côté serveur afin d’améliorer leur attribution. Cette référence est ajoutée à l’URL de destination après un clic sur une publicité ChatGPT.

La correspondance des clients peut également améliorer le rapprochement d’un événement avec une interaction publicitaire lorsque la référence de clic n’est pas disponible. Dans le module, cette option utilise uniquement des empreintes SHA-256 autorisées, et non les coordonnées en clair.

Consultez notre FAQ Comment fonctionne la correspondance des clients et quelles données sont utilisées ? pour en savoir plus.

Consentement et tests

Envoyez uniquement les événements et les données de correspondance que vous êtes autorisé à transmettre. Le consentement requis doit être pris en compte avant l’envoi des données de conversion.

Avant d’activer définitivement la mesure, vous pouvez utiliser le mode Validation pour contrôler les nouveaux événements sans les enregistrer comme conversions réelles. Le mode Debug permet quant à lui d’afficher l’activité du SDK dans la console du navigateur, mais les événements envoyés restent réels.

Consultez nos FAQ À quoi sert le mode Validation et quand faut-il le désactiver ? et À quoi sert le mode Debug et quand dois-je l’utiliser ? pour préparer vos tests.

Pour plus de détails, consultez la documentation officielle de la Conversions API OpenAI Ads et la documentation Conversion Measurement.