> 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/insights/analytics/settings/chatgpt-ads-manager.md).

# Administrador de anuncios de ChatGPT

Conecta tu cuenta de anuncios de ChatGPT a un Brand Kit para informes de rendimiento y herramientas de gestión de anuncios habilitadas.

Conecta tu cuenta de ChatGPT Ads para que AirOps pueda sincronizar la estructura de sus campañas y el rendimiento diario en **Insights → Ads → Performance**. Conectar y sincronizar una cuenta no modifica sus campañas. Los administradores del espacio de trabajo pueden usar **Owned Ads** para crear y gestionar recursos publicitarios. Las herramientas de Playbook y Workflow habilitadas por separado también pueden usar la conexión.

## Requisitos previos

* Un espacio de trabajo de **AirOps** con acceso a Insights y Ads
* Acceso a [ChatGPT Ads Manager](https://ads.openai.com) con permiso para crear claves de API
* Un **Brand Kit** al que asociar la cuenta publicitaria

Los anuncios observados en **Ad Library** y **Market** no requieren esta conexión. Sus datos provienen de las respuestas de ChatGPT que AirOps recopila para tus prompts monitorizados.

## Cómo configurarlo

### 1. Crea una clave de API en ChatGPT Ads Manager

1. Inicia sesión en [ChatGPT Ads Manager](https://ads.openai.com).
2. Ve a **Settings**.
3. Crea una clave de API para la cuenta publicitaria que quieras conectar.
4. Copia la clave y guárdala como si fuera una contraseña.

{% hint style="warning" %}
Genera la clave de API en **ChatGPT Ads Manager → Settings** para la cuenta publicitaria que quieras conectar. Las claves generadas en la **plataforma para desarrolladores de OpenAI** no autentican el acceso a la Ads API. Cada clave está vinculada a una sola cuenta publicitaria, así que genera una clave distinta para cada cuenta que quieras conectar.
{% endhint %}

### 2. Añade la integración a tu espacio de trabajo

1. En AirOps, ve a **Account → Integrations**.
2. Añade una integración y elige **OpenAI Ads**.
3. Pega la clave en **API Key**y guarda los cambios.

<figure><img src="https://3036434873-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>Añade la clave de API de ChatGPT Ads Manager como integración de OpenAI Ads.</p></figcaption></figure>

La integración pertenece a tu espacio de trabajo y sus Brand Kits pueden seleccionarla. Guardar la clave por sí solo no completa Performance; después, asóciala a un Brand Kit.

### 3. Asocia la cuenta a un Brand Kit

1. Selecciona el Brand Kit y abre **Insights → Settings → General**.
2. Busca **Connected Integrations** y abre el selector de **OpenAI Ads** .
3. Selecciona la integración que creaste.

<figure><img src="https://3036434873-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>Asocia la cuenta publicitaria a un kit de marca.</p></figcaption></figure>

AirOps busca la cuenta publicitaria, registra su ID y moneda, e inicia la sincronización inicial. Si la API de anuncios rechaza la clave, **Integraciones conectadas** muestra el error para que puedas corregir la clave y volver a seleccionarla.

Si el equipo de AirOps te ha proporcionado una cuenta publicitaria gestionada por AirOps para el kit de marca, confirma con ellos qué cuenta debes usar antes de añadir otra conexión.

### 4. Confirma la conexión

Abre **Estadísticas → Anuncios → Rendimiento**. El panel distingue entre una cuenta que espera su primera sincronización y otra que ya se sincronizó, pero no tiene campañas ni actividad de entrega.

| Estado                                   | Qué hacer                                                                                                                          |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **No conectada**                         | Comprueba que hayas asociado la integración a este kit de marca, en lugar de limitarte a guardarla en el espacio de trabajo.       |
| **Sincronizando**                        | Espera a que se complete la primera sincronización. Si el estado persiste, comprueba la conexión en **Integraciones conectadas**.  |
| **Sin campañas**                         | Crea una campaña en ChatGPT Ads Manager o, si está habilitado, a través de AirOps.                                                 |
| **Las campañas aún no se han publicado** | Revisa el estado de la campaña y los anuncios, su aprobación, programación y entrega en la cuenta publicitaria.                    |
| **Rendimiento disponible**               | Selecciona el intervalo de fechas y usa los filtros de campaña, grupo de anuncios, anuncio o región para consultar los resultados. |

## Qué sincroniza AirOps

| Datos                                   | Detalles                                                                                                                                               |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Campañas, grupos de anuncios y anuncios | Jerarquía de la cuenta, nombres, estado, estado de revisión, contenido creativo y campos compatibles de presupuesto, puja, segmentación y programación |
| Rendimiento diario                      | Impresiones, clics e inversión por anuncio y día                                                                                                       |
| Desgloses                               | Impresiones, clics e inversión diarios por país y dispositivo                                                                                          |

AirOps actualiza los datos a diario. La plataforma publicitaria puede revisar las cifras recientes, por lo que los totales recientes pueden cambiar después de una sincronización posterior. AirOps reemplaza las cifras de cada día por los valores más recientes.

## Acceso de gestión

Los informes de rendimiento y la gestión de anuncios tienen disponibilidades distintas. Una conexión para informes no habilita automáticamente **Owned Ads** ni las acciones de escritura en Playbooks y Workflows. Ponte en contacto con tu equipo de AirOps para consultar el acceso a [Owned Ads](https://docs.airops.com/docs/es/insights/ads/owned-ads.md), [las herramientas de Ads Playbook](https://docs.airops.com/docs/es/acciones/playbooks/tools/ads.md)o a [OpenAI Ads Workflow Steps](https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/openai-ads.md).

Cuando están habilitadas, estas acciones pueden modificar la cuenta publicitaria conectada. Comprueba la cuenta de destino, el presupuesto y el estado de los recursos antes de crear o activar anuncios.

## Ejemplo

Para generar informes sobre una campaña existente, añade la clave de API de su cuenta en **Cuenta → Integraciones**, asocia esa integración al kit de marca de la campaña y abre **Estadísticas → Anuncios → Rendimiento**. Después de la sincronización, selecciona la campaña y el intervalo de fechas para consultar la inversión, las impresiones y los clics.

## Solución de problemas

**La integración aparece como fallida.** Comprueba que la clave provenga de ChatGPT Ads Manager y que no se haya revocado. Actualízala y vuelve a seleccionar la integración.

**Una prueba de conexión indica que la cuenta requiere revisión.** La clave puede ser válida aunque la cuenta publicitaria todavía no haya completado la revisión del proveedor. Resuelve los requisitos de revisión de la cuenta en el Administrador de anuncios de ChatGPT.

**Las cifras no coinciden con las del Administrador de anuncios de ChatGPT.** Compara la misma cuenta, el mismo intervalo de fechas y los mismos filtros. Las cifras recientes pueden diferir hasta que la siguiente sincronización incorpore las revisiones de la plataforma.

**La biblioteca de anuncios está vacía después de conectarla.** La biblioteca de anuncios utiliza respuestas observadas, no los datos de entrega de tu cuenta publicitaria. Comprueba el kit de marca seleccionado, las indicaciones de ChatGPT que sigues, las fechas y los filtros. Usa Rendimiento para consultar la cuenta conectada.


---

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