ChatGPT Ads

Ce que ça fait

ChatGPT Ads (OpenAI Ads) est une régie publicitaire : DURUM.ai y lit vos campagnes, vos ad groups, vos ads et surtout votre spend quotidien par ad, pour les afficher à côté de vos autres régies et calculer vos coûts par lead, par booking et par vente.

La connexion se fait avec une clé API. Dès la connexion, DURUM.ai importe les 30 derniers jours de spend, puis synchronise chaque heure les 3 derniers jours.

ChatGPT Ads n'envoie pas de webhooks : cette intégration ne crée aucun événement (lead, booking, vente). Elle alimente le spend et la structure de vos campagnes.

Avant de commencer

• Un compte publicitaire OpenAI Ads Manager (ads.openai.com) avec accès à l'onglet Settings.
• La clé API est liée à un seul compte publicitaire : une connexion par compte publicitaire, un compte publicitaire par compte client DURUM.ai.
• Pour l'attribution des leads à ChatGPT Ads, vos URL de destination doivent porter le paramètre utm_source=chatgpt (les valeurs openai, oai, chatgpt_ads et openai_ads sont aussi reconnues).

Connexion étape par étape

1. Connectez-vous à OpenAI Ads Manager (ads.openai.com).
2. Allez dans l'onglet Settings, section API keys.
3. Cliquez sur Create key. La clé est liée à votre compte publicitaire. Copiez-la.
4. Dans DURUM.ai, allez dans Paramètres puis Intégrations, et cliquez sur Connecter sur la carte ChatGPT Ads (catégorie Publicité).
5. Dans le champ Clé API OpenAI Ads, collez la clé (elle commence par sk-ads-).
6. Cliquez sur Connecter. DURUM.ai vérifie la clé en lisant votre compte publicitaire (nom, devise, fuseau horaire, statut de revue), l'enregistre chiffrée, puis importe les 30 derniers jours de spend.
7. Le message « ChatGPT Ads connecté » confirme la connexion.

Il n'y a qu'un seul champ à remplir : aucun identifiant de compte à saisir, la clé désigne le compte.

Vérifier que ça marche

1. Sur la carte ChatGPT Ads, vérifiez que le statut est actif et que la date de dernière synchro est renseignée.
2. Ouvrez la section Publicités de DURUM.ai : vos campagnes ChatGPT Ads et leur spend des 30 derniers jours doivent apparaître.
3. Le lendemain, vérifiez que le spend de la veille est présent : la synchro horaire l'a mis à jour.

Événements captés

ChatGPT Ads n'expose aucun webhook : aucun événement n'est capté. Voici ce que la synchro lit.

Côté ChatGPT Ads	Ce que DURUM.ai enregistre	Ce qu'il alimente
Compte publicitaire	Identifiant, nom, devise, fuseau horaire, statut de revue	Carte de l'intégration, devise du spend
Campagnes, ad groups, ads	Identifiants et noms, pour rattacher chaque ligne de spend à sa campagne et à son ad group	Section Publicités
Insights quotidiens au niveau ad	Par ad et par jour : spend, impressions, clicks, cpm, cpc, ctr	Spend, coûts par lead, par booking et par vente
Lead, booking ou vente	aucun	Ces événements viennent de vos autres connexions (CRM, formulaires, paiements) et sont rattachés à ChatGPT Ads par utm_source=chatgpt.

Détails utiles :

• Fenêtre de synchro : import initial de 30 jours à la connexion, puis chaque heure les 3 derniers jours. Une journée en cours est mise à jour à chaque passage.
• Portée : ChatGPT Ads ne fournit pas de portée (reach). DURUM.ai l'enregistre à 0.
• CTR : recalculé par DURUM.ai à partir des clics et des impressions, exprimé en pourcentage comme pour les autres régies.
• Devise : celle du compte publicitaire.

Dépannage

Problème	Solution
« Clé API invalide ou révoquée »	Vérifiez la clé dans OpenAI Ads Manager, onglet Settings, section API keys. Au besoin, créez une nouvelle clé et reconnectez.
« La clé est acceptée mais aucun compte publicitaire n'y est rattaché »	La clé n'est pas liée à un compte publicitaire. Créez-la depuis le compte publicitaire concerné.
« Trop de tentatives »	Attendez 1 minute et réessayez.
« Impossible de joindre l'API OpenAI Ads »	Problème temporaire côté OpenAI. Réessayez dans quelques minutes.
La carte affiche une erreur de synchro	La clé a probablement été révoquée dans OpenAI Ads Manager. Créez une nouvelle clé et reconnectez : la synchro horaire reprend d'elle-même.
Spend du jour incomplet	Normal : la synchro passe chaque heure et met à jour la journée en cours.
Leads non attribués à ChatGPT Ads	Ajoutez utm_source=chatgpt aux URL de destination de vos ads.
Import initial en échec, connexion active	La connexion est conservée. La synchro horaire reprend les 3 derniers jours ; l'historique de 30 jours peut être relancé en déconnectant puis reconnectant.

FAQ

La clé donne-t-elle accès à mon compte ChatGPT ?

Non. Elle ne donne accès qu'à votre compte publicitaire ChatGPT Ads. Elle est chiffrée et n'est jamais affichée dans DURUM.ai.

La clé expire-t-elle ?

Non. Elle reste valable tant que vous ne la révoquez pas dans OpenAI Ads Manager.

J'ai plusieurs comptes publicitaires ChatGPT Ads ?

Une clé désigne un seul compte publicitaire, et DURUM.ai garde une connexion ChatGPT Ads par compte client. Utilisez un compte client DURUM.ai par compte publicitaire.

Comment renvoyer mes conversions à ChatGPT Ads ?

C'est une connexion distincte, côté conversions, qui utilise le Pixel ID de l'onglet Conversions d'OpenAI Ads Manager. Elle n'est pas couverte par cette page.

Pourquoi mes montants ChatGPT Ads diffèrent-ils légèrement d'OpenAI Ads Manager ?

DURUM.ai recalcule le CTR à partir des clics et des impressions et enregistre la portée à 0. Le spend, les impressions et les clics sont ceux fournis par l'API, jour par jour tels qu'elle les renvoie.

---