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

# OpenAI Ads

Crea, edita y archiva recursos de anuncios de OpenAI con los pasos de flujo de trabajo habilitados.

Los pasos de OpenAI Ads permiten que un Workflow cree y gestione campañas publicitarias de ChatGPT, grupos de anuncios y anuncios. Encadena Steps para construir la jerarquía de la cuenta y subir imágenes creativas antes de crear anuncios.

{% hint style="info" %}
Las acciones de Workflow de OpenAI Ads requieren la habilitación independiente del espacio de trabajo y una cuenta de ChatGPT Ads conectada. Ponte en contacto con tu equipo de AirOps si la integración no está disponible en el selector de Steps.
{% endhint %}

## Cómo configurarlo

1. Añade un **OpenAI Ads** Añade un Step a tu Workflow y elige una acción.
2. Selecciona la autenticación de OpenAI Ads. Usa una clave creada en [Gestor de anuncios de ChatGPT](https://docs.airops.com/docs/es/insights/analytics/settings/chatgpt-ads-manager.md).
3. Prueba la conexión. Una clave válida puede requerir aún una revisión de la cuenta antes de que la cuenta esté lista para anunciar.
4. Selecciona un recurso padre existente o, para una acción de creación, referencia el padre creado por un Step anterior.
5. Configura las entradas de la acción. Elige **Pausado** al preparar recursos para revisión antes de la entrega.
6. Ejecuta el Workflow e inspecciona los detalles del recurso devuelto y el estado de revisión del anuncio.

<figure><img src="https://3036434873-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>Crea recursos de anuncios como Pausados para poder revisarlos primero.</p></figcaption></figure>

## Acciones y parámetros

| Acción                         | Entradas principales                                                                                                                                |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Crear campaña**              | Nombre, estado explícito, objetivo, tipo y cantidad de presupuesto, y cualquier configuración de programación o segmentación                        |
| **Editar campaña**             | Selección de campaña y los campos a actualizar                                                                                                      |
| **Archivar campaña**           | Selección de campaña                                                                                                                                |
| **Crear grupo de anuncios**    | Campaña existente o ID/referencia de campaña, nombre del grupo, puja máxima, estado y sugerencias de contexto                                       |
| **Editar grupo de anuncios**   | Selecciones de campaña y grupo de anuncios, además de los campos a actualizar                                                                       |
| **Archivar grupo de anuncios** | Selecciones de campaña y grupo de anuncios                                                                                                          |
| **Subir imagen del anuncio**   | URL pública que apunta directamente a una imagen                                                                                                    |
| **Crear anuncio**              | Grupo de anuncios existente o ID/referencia de grupo de anuncios, nombre, estado, título, texto, URL de destino e ID de archivo de la imagen subida |
| **Editar anuncio**             | Selecciones de campaña, grupo de anuncios y anuncio, además de los campos a actualizar                                                              |
| **Archivar anuncio**           | Selecciones de campaña, grupo de anuncios y anuncio                                                                                                 |

Introduce los importes del presupuesto y de la puja en la moneda de la cuenta publicitaria. Usa las entradas de fecha y hora para especificar la programación y la zona horaria. Las sugerencias de contexto pueden ser líneas separadas o un array JSON de un Step anterior.

**Subir imagen del anuncio** devuelve un `file_id`. Pasa ese valor a **Crear anuncio** para la creatividad de la tarjeta de chat. Las acciones de crear, editar y archivar devuelven la respuesta del proveedor; las respuestas de anuncios incluyen `review_status`.

### Volver a ejecutar Steps de creación

Volver a ejecutar el mismo Step de creación en el mismo Workflow reutiliza su campaña, grupo de anuncios o anuncio originales, incluso si cambias las entradas. Usa un **Editar** Step para actualizar un recurso existente. Usa un Step de creación o Workflow diferente cuando tengas la intención de crear un recurso separado.

Un Step de carga de imágenes puede devolver un nuevo `file_id` en una nueva ejecución. Eso no hace que el siguiente Step de creación cree un segundo anuncio.

{% hint style="warning" %}
Estos Steps escriben en tu cuenta publicitaria conectada. Los recursos activos pueden publicar anuncios y gastar presupuesto. El archivado es irreversible. Usa estados pausados explícitos y un proceso de revisión al construir un Workflow de creación.
{% endhint %}

## Ejemplo

Construye un Workflow con estos Steps:

1. **Crear campaña** con el objetivo y el presupuesto deseados, con estado **Pausado**.
2. **Crear grupo de anuncios** usando el ID de campaña devuelto por el primer Step, también **Pausado**.
3. **Subir imagen del anuncio** usando una URL pública para tu creatividad aprobada.
4. **Crear anuncio** usando el ID del grupo de anuncios y la imagen subida `file_id`, con el texto y la URL de destino aprobados y estado **Pausado**.
5. Revisa los recursos y la creatividad devueltos antes de activarlos a través de una superficie de gestión habilitada.


---

# 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/es/acciones/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.
