> 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 tus campañas y el rendimiento diario en **Insights → Anuncios → Rendimiento**. Conectar y sincronizar una cuenta no cambia sus campañas. Cuando esté habilitado por separado, **Anuncios propios**, Playbooks y Workflows pueden usar la conexión para crear y gestionar recursos publicitarios.

## Prerrequisitos

* Una **AirOps** espacio de trabajo con acceso a Insights y Anuncios
* Acceso a [Administrador de anuncios de ChatGPT](https://ads.openai.com) con permiso para crear claves API
* Una **Brand Kit** para vincular la cuenta publicitaria a

Anuncios observados en **Biblioteca de anuncios** y **Mercado** no requieren esta conexión. Sus datos provienen de las respuestas de ChatGPT que AirOps recopila para tus prompts rastreados.

## Cómo configurar

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

1. Inicia sesión en [Administrador de anuncios de ChatGPT](https://ads.openai.com).
2. Ve a **Configuración**.
3. Crea una clave API para la cuenta publicitaria que deseas conectar.
4. Copia la clave y trátala como una contraseña.

{% hint style="warning" %}
Genera la clave dentro de ChatGPT Ads Manager. Una clave API estándar de la plataforma OpenAI, como una clave que comience `sk-`, no se autentica contra la API de anuncios. Cada clave se asigna a una sola cuenta publicitaria, así que crea una clave por cada cuenta que quieras conectar.
{% endhint %}

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

1. En AirOps, ve a **Cuenta → Integraciones**.
2. Añade una integración y elige **OpenAI Ads**.
3. Pega la clave en **Clave de API**, luego guarda.

La integración pertenece a tu espacio de trabajo y puede seleccionarse mediante sus Brand Kits. Guardar la clave por sí solo no llena Rendimiento; asígnala a un Brand Kit a continuación.

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

1. Selecciona el Brand Kit y luego abre **Insights → Ajustes → General**.
2. Busca **Integraciones conectadas** y abre el **OpenAI Ads** selector.
3. Selecciona la integración que creaste.

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

Si tu equipo de AirOps ha aprovisionado una cuenta publicitaria administrada por AirOps para el Brand Kit, confirma con ellos qué cuenta debes usar antes de añadir otra conexión.

### 4. Confirma la conexión

Abrir **Insights → Anuncios → Rendimiento**. El panel distingue una cuenta que espera su primera sincronización de una que se ha sincronizado pero aún no tiene campañas o aún no tiene entrega.

| Estado                                           | Qué hacer                                                                                                                         |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| **No conectado**                                 | Verifica que hayas adjuntado la integración a este Brand Kit, en lugar de guardarla solo 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, donde esté habilitado, a través de AirOps.                                             |
| **Las campañas aún no han entregado resultados** | Revisa el estado de la campaña y del anuncio, la aprobación, la programación y la entrega en la cuenta publicitaria.              |
| **Rendimiento disponible**                       | Selecciona el rango de fechas y usa los filtros de campaña, grupo de anuncios, anuncio o región para inspeccionar los resultados. |

## Qué sincroniza AirOps

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

AirOps actualiza los datos diariamente. 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 con los valores más recientes.

## Acceso de gestión

Los informes de rendimiento y la gestión de anuncios tienen disponibilidad separada. Una conexión de informes no habilita automáticamente **Anuncios propios** ni las acciones de escritura en Playbooks y Workflows. Contacta a tu equipo de AirOps sobre el acceso a [Anuncios propios](/docs/es/insights/ads/owned-ads.md), [herramientas de Playbook de anuncios](/docs/es/acciones/playbooks/tools/ads.md), o [Pasos de flujo de trabajo de anuncios de OpenAI](/docs/es/acciones/workflow-concepts/workflow-steps/openai-ads.md).

Cuando está habilitado, estas acciones pueden cambiar la cuenta publicitaria conectada. Comprueba la cuenta de destino, el presupuesto y el estado del recurso antes de crear o activar anuncios.

## Ejemplo

Para informar sobre una campaña existente, añade la clave API de su cuenta en **Cuenta → Integraciones**, adjunta esa integración al Brand Kit de la campaña y abre **Insights → Anuncios → Rendimiento**. Después de la sincronización, selecciona la campaña y el rango de fechas para revisar el gasto, 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 haya sido revocada. Actualízala y luego vuelve a seleccionar la integración.

**Una prueba de conexión indica que la cuenta necesita revisión.** La clave puede ser válida aunque la cuenta publicitaria no haya completado la revisión del proveedor. Resuelve los requisitos de revisión de la cuenta en ChatGPT Ads Manager.

**Los números difieren de ChatGPT Ads Manager.** Compara la misma cuenta, rango de fechas y 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 conectar.** La Biblioteca de anuncios usa respuestas observadas, no los datos de entrega de tu cuenta publicitaria. Comprueba el Brand Kit seleccionado, los prompts de ChatGPT rastreados, las fechas y los filtros. Usa Rendimiento para inspeccionar 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.