> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/insights/analytics/settings/chatgpt-ads-manager.md).

# Gestionnaire de publicités ChatGPT

Connectez votre compte publicitaire ChatGPT à un Brand Kit pour le reporting de performance et les outils de gestion des publicités activés.

Connectez votre compte ChatGPT Ads afin qu’AirOps puisse synchroniser la structure de vos campagnes et les performances quotidiennes dans **Insights → Ads → Performance**. La connexion et la synchronisation d’un compte ne modifient pas ses campagnes. Là où elles sont activées séparément, **Owned Ads**, Playbooks et Workflows peuvent utiliser la connexion pour créer et gérer des ressources publicitaires.

## Prérequis

* Une **AirOps** espace de travail avec accès à Insights et Ads
* Accès à [Gestionnaire de publicités ChatGPT](https://ads.openai.com) avec l’autorisation de créer des clés API
* Un **Brand Kit** pour associer le compte publicitaire à

Publicités observées dans **Bibliothèque d'annonces** et **Market** ne nécessitent pas cette connexion. Leurs données proviennent des réponses ChatGPT qu’AirOps collecte pour vos prompts suivis.

## Comment configurer

### 1. Créez une clé API dans ChatGPT Ads Manager

1. Connectez-vous sur [Gestionnaire de publicités ChatGPT](https://ads.openai.com).
2. Allez à **Paramètres**.
3. Créez une clé API pour le compte publicitaire que vous souhaitez connecter.
4. Copiez la clé et traitez-la comme un mot de passe.

{% hint style="warning" %}
Générez la clé dans ChatGPT Ads Manager. Une clé API standard de la plateforme OpenAI, par exemple une clé commençant `sk-`, ne s’authentifie pas auprès de l’API des publicités. Chaque clé correspond à un seul compte publicitaire, alors créez une clé par compte que vous souhaitez connecter.
{% endhint %}

### 2. Ajoutez l’intégration à votre espace de travail

1. Dans AirOps, accédez à **Compte → Intégrations**.
2. Ajoutez une intégration et choisissez **Publicités OpenAI**.
3. Collez la clé dans **Clé API**, puis enregistrez.

L’intégration appartient à votre espace de travail et peut être sélectionnée par ses Brand Kits. L’enregistrement de la clé seule ne renseigne pas Performance ; associez-la ensuite à un Brand Kit.

### 3. Associez le compte à un Brand Kit

1. Sélectionnez le Brand Kit, puis ouvrez **Insights → Paramètres → Général**.
2. Recherchez **Intégrations connectées** et ouvrez le **Publicités OpenAI** sélecteur.
3. Sélectionnez l’intégration que vous avez créée.

AirOps recherche le compte publicitaire, enregistre son ID de compte et sa devise, et lance la synchronisation initiale. Si l’API des publicités rejette la clé, **Intégrations connectées** indique l’échec afin que vous puissiez corriger la clé et la sélectionner à nouveau.

Si votre équipe AirOps a provisionné pour le Brand Kit un compte publicitaire géré par AirOps, confirmez avec elle quel compte vous devez utiliser avant d’ajouter une autre connexion.

### 4. Confirmez la connexion

Ouvrir **Insights → Ads → Performance**. Le tableau de bord distingue un compte en attente de sa première synchronisation d’un compte qui s’est synchronisé mais qui n’a encore ni campagne ni diffusion.

| État                                       | Que faire                                                                                                                          |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Non connecté**                           | Vérifiez que vous avez bien associé l’intégration à ce Brand Kit, et non simplement enregistrée dans l’espace de travail.          |
| **Synchronisation en cours**               | Attendez la fin de la première synchronisation. Si l’état persiste, vérifiez la connexion sous **Intégrations connectées**.        |
| **Aucune campagne**                        | Créez une campagne dans ChatGPT Ads Manager ou, lorsque c’est possible, via AirOps.                                                |
| **Les campagnes n’ont pas encore diffusé** | Vérifiez l’état de la campagne et des annonces, l’approbation, la programmation et la diffusion dans le compte publicitaire.       |
| **Performance disponible**                 | Sélectionnez la plage de dates et utilisez les filtres campagne, groupe d’annonces, annonce ou région pour examiner les résultats. |

## Ce qu’AirOps synchronise

| Données                                   | Détail                                                                                                                                                |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Campagnes, groupes d’annonces et annonces | Hiérarchie du compte, noms, état, statut de révision, création, et champs pris en charge pour le budget, les enchères, le ciblage et la planification |
| Performances quotidiennes                 | Impressions, clics et dépenses par annonce et par jour                                                                                                |
| Répartitions                              | Impressions, clics et dépenses quotidiennes par pays et par appareil                                                                                  |

AirOps actualise les données chaque jour. La plateforme publicitaire peut réviser les chiffres récents, donc les totaux récents peuvent changer après une synchronisation ultérieure. AirOps remplace les chiffres de chaque jour par les valeurs les plus récentes.

## Accès de gestion

Le reporting des performances et la gestion des annonces ont des disponibilités distinctes. Une connexion de reporting n’active pas automatiquement **Owned Ads** ou les actions d’écriture dans Playbooks et Workflows. Contactez votre équipe AirOps pour l’accès aux [Owned Ads](/docs/fr/insights/ads/owned-ads.md), [outils Ads Playbook](/docs/fr/actions/playbooks/tools/ads.md), ou [étapes de workflow OpenAI Ads](/docs/fr/actions/workflow-concepts/workflow-steps/openai-ads.md).

Lorsqu’elles sont activées, ces actions peuvent modifier le compte publicitaire connecté. Vérifiez le compte cible, le budget et l’état des ressources avant de créer ou d’activer des annonces.

## Exemple

Pour établir un reporting sur une campagne existante, ajoutez la clé API de son compte sous **Compte → Intégrations**, associez cette intégration au Brand Kit de la campagne, et ouvrez **Insights → Ads → Performance**. Après la synchronisation, sélectionnez la campagne et la plage de dates pour examiner les dépenses, les impressions et les clics.

## Dépannage

**L’intégration apparaît comme ayant échoué.** Vérifiez que la clé provient de ChatGPT Ads Manager et qu’elle n’a pas été révoquée. Mettez-la à jour, puis sélectionnez à nouveau l’intégration.

**Un test de connexion indique que le compte nécessite une révision.** La clé peut être valide alors que le compte publicitaire n’a pas terminé la revue du fournisseur. Résolvez les exigences de révision du compte dans ChatGPT Ads Manager.

**Les chiffres diffèrent de ChatGPT Ads Manager.** Comparez le même compte, la même plage de dates et les mêmes filtres. Les chiffres récents peuvent différer jusqu’à ce que la prochaine synchronisation intègre les révisions de la plateforme.

**La bibliothèque d’annonces est vide après la connexion.** La bibliothèque d’annonces utilise les réponses observées, pas les données de diffusion de votre compte publicitaire. Vérifiez le Brand Kit sélectionné, les prompts ChatGPT suivis, les dates et les filtres. Utilisez Performance pour examiner le compte connecté.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/insights/analytics/settings/chatgpt-ads-manager.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.