> 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 ses campagnes et leurs performances quotidiennes dans **Insights → Ads → Performance**. La connexion et la synchronisation d’un compte ne modifient pas ses campagnes. Les administrateurs de l’espace de travail peuvent utiliser **Owned Ads** pour créer et gérer des ressources publicitaires. Les outils Playbook et Workflow, activés séparément, peuvent également utiliser cette connexion.

## Prérequis

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

Les publicités observées dans **Ad Library** et **Market** ne nécessitent pas cette connexion. Leurs données proviennent des réponses ChatGPT qu’AirOps collecte pour les prompts que vous suivez.

## Configuration

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

1. Connectez-vous à [ChatGPT Ads Manager](https://ads.openai.com).
2. Accédez à **Settings**.
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é API dans **ChatGPT Ads Manager → Settings** pour le compte publicitaire que vous souhaitez connecter. Les clés générées sur la **plateforme pour développeurs OpenAI** ne permettent pas de s’authentifier auprès de l’API Ads. Chaque clé est associée à un seul compte publicitaire. Générez donc une clé distincte pour chaque compte que vous souhaitez connecter.
{% endhint %}

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

1. Dans AirOps, accédez à **Account → Integrations**.
2. Ajoutez une intégration et choisissez **OpenAI Ads**.
3. Collez la clé dans **API Key**, puis enregistrez.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42e9fb4f37e48ffd261dbbc83c3ebaa3392ce59e%2Fads-manager-01-openai-ads-integration.png?alt=media" alt="Connect OpenAI Ads dialog with an authentication name, a masked API key, an optional expiration date, and Save credentials and Test connection"><figcaption><p>Ajoutez la clé API de ChatGPT Ads Manager comme intégration OpenAI Ads.</p></figcaption></figure>

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

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

1. Sélectionnez le Brand Kit, puis ouvrez **Insights → Settings → General**.
2. Repérez **Connected Integrations** et ouvrez le sélecteur **OpenAI Ads** .
3. Sélectionnez l’intégration que vous avez créée.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4a54e602f71c99012c24994a3444a747a88dd4a5%2Fads-manager-02-attach-to-brand-kit.png?alt=media" alt="Insights Settings Connected Integrations with the OpenAI Ads integration selected"><figcaption><p>Associez le compte publicitaire à un kit de marque.</p></figcaption></figure>

AirOps recherche le compte publicitaire, enregistre son identifiant et sa devise, puis lance la synchronisation initiale. Si l’API publicitaire rejette la clé, **Intégrations connectées** affiche l’échec afin que vous puissiez corriger la clé et sélectionner à nouveau l’intégration.

Si votre équipe AirOps a configuré un compte publicitaire géré par AirOps pour le kit de marque, confirmez avec elle le compte à utiliser avant d’ajouter une autre connexion.

### 4. Confirmer la connexion

Ouvrez **Insights → Ads → Performance**. Le tableau de bord distingue un compte en attente de sa première synchronisation d’un compte déjà synchronisé, mais sans campagne ni diffusion pour le moment.

| État                                             | Que faire                                                                                                                                  |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Non connecté**                                 | Vérifiez que vous avez associé l’intégration à ce kit de marque, et que vous ne l’avez pas seulement enregistrée dans l’espace de travail. |
| **Synchronisation en cours**                     | Attendez la fin de la première synchronisation. Si cet état persiste, vérifiez la connexion dans **Intégrations connectées**.              |
| **Aucune campagne**                              | Créez une campagne dans ChatGPT Ads Manager ou, si cette option est activée, dans AirOps.                                                  |
| **Les campagnes n’ont pas encore été diffusées** | Vérifiez l’état des campagnes et des annonces, leur approbation, leur programmation et leur diffusion dans le compte publicitaire.         |
| **Données de performance disponibles**           | Sélectionnez une période et utilisez les filtres de campagne, de groupe d’annonces, d’annonce ou de région pour examiner les résultats.    |

## Données synchronisées par AirOps

| Données                                   | Détails                                                                                                                                                                             |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Campagnes, groupes d’annonces et annonces | Hiérarchie des comptes, noms, états, états de validation, éléments créatifs, ainsi que les champs pris en charge concernant le budget, les enchères, le ciblage et la programmation |
| Performances quotidiennes                 | Impressions, clics et dépenses par annonce et par jour                                                                                                                              |
| Ventilations                              | Impressions, clics et dépenses quotidiens par pays et par appareil                                                                                                                  |

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

## Accès à la gestion

La disponibilité des rapports de performance est distincte de celle de la gestion des annonces. Une connexion dédiée aux rapports n’active pas automatiquement **Owned Ads** ni les actions d’écriture dans Playbooks et Workflows. Contactez votre équipe AirOps pour connaître les modalités d’accès aux [Owned Ads](https://docs.airops.com/docs/fr/insights/ads/owned-ads.md), [outils Ads Playbook](https://docs.airops.com/docs/fr/actions/playbooks/tools/ads.md), ou aux [étapes de workflow OpenAI Ads](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/openai-ads.md).

Une fois 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 créer un rapport sur une campagne existante, ajoutez la clé API de son compte dans **Account → Integrations**, associez cette intégration au kit de marque de la campagne, puis ouvrez **Insights → Ads → Performance**. Une fois la synchronisation terminée, sélectionnez la campagne et la période pour consulter les dépenses, les impressions et les clics.

## Dépannage

**L’intégration est signalée 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 doit être vérifié.** La clé peut être valide alors que le compte publicitaire n’a pas encore passé l’examen du fournisseur. Répondez aux exigences de vérification du compte dans ChatGPT Ads Manager.

**Les chiffres diffèrent de ceux de ChatGPT Ads Manager.** Comparez le même compte, la même période et les mêmes filtres. Les chiffres récents peuvent différer jusqu’à la prochaine synchronisation, qui intégrera les révisions de la plateforme.

**La bibliothèque publicitaire est vide après la connexion.** La bibliothèque publicitaire s’appuie sur les réponses observées, et non sur les données de diffusion de votre compte publicitaire. Vérifiez le kit de marque sélectionné, les prompts ChatGPT suivis, les dates et les filtres. Consultez 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.
