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

# Gestor de Anúncios do ChatGPT

Conecte a sua conta de anúncios do ChatGPT a um Brand Kit para relatórios de desempenho e ferramentas de gestão de anúncios ativadas.

Ligue a sua conta do ChatGPT Ads para que a AirOps possa sincronizar a estrutura das suas campanhas e o desempenho diário para **Insights → Anúncios → Desempenho**. Ligar e sincronizar uma conta não altera as respetivas campanhas. Quando ativado separadamente, **Anúncios próprios**, os Playbooks e os Workflows podem usar a ligação para criar e gerir recursos de anúncios.

## Pré-requisitos

* Uma **AirOps** espaço de trabalho com acesso a Insights e Ads
* Acesso a [Gestor de Anúncios do ChatGPT](https://ads.openai.com) com permissão para criar chaves de API
* Uma **Brand Kit** para associar a conta de anúncios a

Anúncios observados em **Biblioteca de anúncios** como no **Market** não requerem esta ligação. Os respetivos dados vêm das respostas do ChatGPT que a AirOps recolhe para os seus prompts monitorizados.

## Como Configurar

### 1. Crie uma chave de API no ChatGPT Ads Manager

1. Inicie sessão em [Gestor de Anúncios do ChatGPT](https://ads.openai.com).
2. Vá para **Definições**.
3. Crie uma chave de API para a conta de anúncios que pretende ligar.
4. Copie a chave e trate-a como uma palavra-passe.

{% hint style="warning" %}
Gere a chave no ChatGPT Ads Manager. Uma chave de API padrão da plataforma OpenAI, como uma chave que comece por `sk-`, não autentica na API de anúncios. Cada chave corresponde a uma única conta de anúncios, por isso crie uma chave por conta que queira ligar.
{% endhint %}

### 2. Adicione a integração ao seu espaço de trabalho

1. Na AirOps, vá para **Conta → Integrações**.
2. Adicione uma integração e escolha **OpenAI Ads**.
3. Cole a chave em **Chave da API**, e depois guarde.

A integração pertence ao seu espaço de trabalho e pode ser selecionada pelos respetivos Brand Kits. Guardar apenas a chave não preenche o Desempenho; associe-a primeiro a um Brand Kit.

### 3. Associe a conta a um Brand Kit

1. Selecione o Brand Kit e depois abra **Insights → Definições → Geral**.
2. Encontre **Integrações ligadas** e abra o **OpenAI Ads** seletor.
3. Selecione a integração que criou.

A AirOps pesquisa a conta de anúncios, regista o respetivo ID de conta e moeda, e inicia a sincronização inicial. Se a API de anúncios rejeitar a chave, **Integrações ligadas** mostra a falha para que possa corrigir a chave e selecioná-la novamente.

Se a sua equipa da AirOps tiver provisionado uma conta de anúncios gerida pela AirOps para o Brand Kit, confirme com ela qual a conta que deve usar antes de adicionar outra ligação.

### 4. Confirme a ligação

Abrir **Insights → Anúncios → Desempenho**. O painel distingue uma conta à espera da sua primeira sincronização de uma que já sincronizou mas não tem campanhas ou ainda não tem entrega.

| Estado                                      | O que fazer                                                                                                                     |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Não ligada**                              | Verifique se associou a integração a este Brand Kit, em vez de a guardar apenas no espaço de trabalho.                          |
| **A sincronizar**                           | Aguarde até que a primeira sincronização seja concluída. Se o estado persistir, verifique a ligação em **Integrações ligadas**. |
| **Sem campanhas**                           | Crie uma campanha no ChatGPT Ads Manager ou, quando ativado, através da AirOps.                                                 |
| **As campanhas ainda não foram veiculadas** | Revise o estado da campanha e do anúncio, a aprovação, o agendamento e a entrega na conta de anúncios.                          |
| **Desempenho disponível**                   | Selecione o intervalo de datas e use filtros de campanha, grupo de anúncios, anúncio ou região para inspecionar os resultados.  |

## O que a AirOps sincroniza

| Dados                                    | Detalhe                                                                                                                            |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Campanhas, grupos de anúncios e anúncios | Hierarquia da conta, nomes, estado, estado de revisão, criativo e campos suportados de orçamento, lance, segmentação e agendamento |
| Desempenho diário                        | Impressões, cliques e gastos por anúncio por dia                                                                                   |
| Detalhes                                 | Impressões, cliques e gastos diários por país e por dispositivo                                                                    |

A AirOps atualiza os dados diariamente. A plataforma de anúncios pode rever valores recentes, pelo que os totais recentes podem alterar-se após uma sincronização posterior. A AirOps substitui os valores de cada dia pelos valores mais recentes.

## Acesso de gestão

A elaboração de relatórios de desempenho e a gestão de anúncios têm disponibilidade separada. Uma ligação de relatórios não ativa automaticamente **Anúncios próprios** nem ações de escrita nos Playbooks e Workflows. Contacte a sua equipa da AirOps sobre o acesso a [Anúncios próprios](/docs/pt/insights/ads/owned-ads.md), [ferramentas do Ads Playbook](/docs/pt/acoes/playbooks/tools/ads.md), ou [Passos do fluxo de trabalho do OpenAI Ads](/docs/pt/acoes/workflow-concepts/workflow-steps/openai-ads.md).

Quando ativadas, estas ações podem alterar a conta de anúncios ligada. Verifique a conta de destino, o orçamento e o estado do recurso antes de criar ou ativar anúncios.

## Exemplo

Para reportar uma campanha existente, adicione a chave de API da respetiva conta em **Conta → Integrações**, associe essa integração ao Brand Kit da campanha e abra **Insights → Anúncios → Desempenho**. Após a sincronização, selecione a campanha e o intervalo de datas para rever gastos, impressões e cliques.

## Resolução de problemas

**A integração aparece como falhada.** Verifique se a chave vem do ChatGPT Ads Manager e não foi revogada. Atualize-a e depois selecione novamente a integração.

**Um teste de ligação indica que a conta precisa de revisão.** A chave pode ser válida embora a conta de anúncios ainda não tenha concluído a revisão do fornecedor. Resolva os requisitos de revisão da conta no ChatGPT Ads Manager.

**Os números diferem do ChatGPT Ads Manager.** Compare a mesma conta, intervalo de datas e filtros. Os valores recentes podem diferir até que a próxima sincronização incorpore as revisões da plataforma.

**A Biblioteca de Anúncios está vazia após a ligação.** A Biblioteca de Anúncios usa respostas observadas, não os dados de entrega da sua conta de anúncios. Verifique o Brand Kit selecionado, os prompts do ChatGPT monitorizados, as datas e os filtros. Use Desempenho para inspecionar a conta ligada.


---

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