> 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/actions/workflow-concepts/workflow-steps/openai-ads.md).

# Publicités OpenAI

Créez, modifiez et archivez des ressources publicitaires OpenAI avec les étapes de workflow activées.

Les étapes OpenAI Ads permettent à un workflow de créer et de gérer des campagnes publicitaires ChatGPT, des groupes d'annonces et des annonces. Enchaînez les étapes pour construire la hiérarchie du compte et téléverser des images créatives avant de créer des annonces.

{% hint style="info" %}
Les actions de workflow OpenAI Ads nécessitent une activation distincte de l'espace de travail et un compte ChatGPT Ads connecté. Contactez votre équipe AirOps si l'intégration n'est pas disponible dans le sélecteur d'étapes.
{% endhint %}

## Comment configurer

1. Ajoutez **OpenAI Ads** Ajoutez une étape à votre workflow et choisissez une action.
2. Sélectionnez l'authentification OpenAI Ads. Utilisez une clé créée dans [ChatGPT Ads Manager](https://docs.airops.com/docs/fr/insights/analytics/settings/chatgpt-ads-manager.md).
3. Testez la connexion. Une clé valide peut néanmoins nécessiter un examen du compte avant que celui-ci soit prêt à diffuser des annonces.
4. Sélectionnez une ressource parente existante ou, pour une action de création, faites référence au parent créé par une étape précédente.
5. Configurez les entrées de l'action. Choisissez **En pause** lors de la préparation des ressources pour examen avant diffusion.
6. Exécutez le workflow et inspectez les détails de la ressource renvoyée ainsi que l'état d'examen de l'annonce.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9ff2439b819ed119039867ffe808d8f04f368476%2Fopenai-ads-01-create-campaign.png?alt=media" alt="OpenAI Ads step set to Create Campaign with a SpaceOps authentication, budget, and Paused status"><figcaption><p>Créez les ressources publicitaires en état En pause afin de pouvoir les examiner d'abord.</p></figcaption></figure>

## Actions et paramètres

| Action                              | Entrées principales                                                                                                                             |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Créer une campagne**              | Nom, statut explicite, objectif, type et montant du budget, ainsi que tous les paramètres de planification ou de ciblage                        |
| **Modifier la campagne**            | Sélection de la campagne et champs à mettre à jour                                                                                              |
| **Archiver la campagne**            | Sélection de la campagne                                                                                                                        |
| **Créer un groupe d'annonces**      | Campagne existante ou ID/référence de campagne, nom du groupe, enchère maximale, statut et indices de contexte                                  |
| **Modifier le groupe d'annonces**   | Sélections de la campagne et du groupe d'annonces, ainsi que les champs à mettre à jour                                                         |
| **Archiver le groupe d'annonces**   | Sélections de la campagne et du groupe d'annonces                                                                                               |
| **Téléverser l'image de l'annonce** | URL publique pointant directement vers une image                                                                                                |
| **Créer une annonce**               | Groupe d'annonces existant ou ID/référence de groupe d'annonces, nom, statut, titre, texte, URL de destination et File ID de l'image téléversée |
| **Modifier l'annonce**              | Sélections de la campagne, du groupe d'annonces et de l'annonce, ainsi que les champs à mettre à jour                                           |
| **Archiver l'annonce**              | Sélections de la campagne, du groupe d'annonces et de l'annonce                                                                                 |

Saisissez les montants du budget et des enchères dans la devise du compte publicitaire. Utilisez les entrées de date et d'heure pour préciser la planification et le fuseau horaire. Les indices de contexte peuvent être des lignes séparées ou un tableau JSON provenant d'une étape précédente.

**Téléverser l'image de l'annonce** renvoie un `file_id`. Transmettez cette valeur à **Créer une annonce** pour le visuel de la carte de discussion. Les actions de création, de modification et d'archivage renvoient la réponse du fournisseur ; les réponses des annonces incluent `review_status`.

### Relancer les étapes de création

Relancer la même étape de création dans le même workflow réutilise sa campagne, son groupe d'annonces ou son annonce d'origine, même si vous modifiez les entrées. Utilisez une **Modifier** étape pour mettre à jour une ressource existante. Utilisez une autre étape de création ou un autre workflow lorsque vous souhaitez créer une ressource distincte.

Une étape de téléversement d'image peut renvoyer un nouveau `file_id` lors d'une nouvelle exécution. Cela n'entraîne pas la création d'une deuxième annonce par l'étape de création suivante.

{% hint style="warning" %}
Ces étapes écrivent dans votre compte publicitaire connecté. Les ressources actives peuvent diffuser des annonces et dépenser le budget. L'archivage est irréversible. Utilisez des statuts explicites En pause et un processus de validation lors de la création d'un workflow de création.
{% endhint %}

## Exemple

Construisez un workflow avec ces étapes :

1. **Créer une campagne** avec l'objectif et le budget souhaités, avec le statut **En pause**.
2. **Créer un groupe d'annonces** en utilisant l'ID de campagne renvoyé par la première étape, également **En pause**.
3. **Téléverser l'image de l'annonce** en utilisant une URL publique pour votre créatif approuvé.
4. **Créer une annonce** en utilisant l'ID du groupe d'annonces et l'image téléversée `file_id`, avec le texte et l'URL de destination approuvés, et le statut **En pause**.
5. Examinez les ressources et le créatif renvoyés avant de les activer via une interface de gestion activée.


---

# 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/actions/workflow-concepts/workflow-steps/openai-ads.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.
