> 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 o AirOps possa sincronizar a estrutura das campanhas e o desempenho diário com **Insights → Ads → Performance**. Ligar e sincronizar uma conta não altera as campanhas. Os administradores do espaço de trabalho podem usar **Owned Ads** para criar e gerir recursos de anúncios. As ferramentas Playbook e Workflow, quando ativadas separadamente, também podem usar a ligação.

## Pré-requisitos

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

Os anúncios observados em **Ad Library** e **Market** não requerem esta ligação. Os respetivos dados provêm das respostas do ChatGPT que o AirOps recolhe para os seus prompts monitorizados.

## Como configurar

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

1. Inicie sessão em [ChatGPT Ads Manager](https://ads.openai.com).
2. Aceda a **Settings**.
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 de API em **ChatGPT Ads Manager → Settings** para a conta de anúncios que pretende ligar. As chaves geradas na **plataforma de programadores da OpenAI** não autenticam na API Ads. Cada chave corresponde a uma única conta de anúncios; por isso, gere uma chave separada para cada conta que pretenda ligar.
{% endhint %}

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

1. No AirOps, aceda a **Account → Integrations**.
2. Adicione uma integração e escolha **OpenAI Ads**.
3. Cole a chave em **API Key**e, em seguida, guarde.

<figure><img src="https://31915162-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>Adicione a chave de API do ChatGPT Ads Manager como uma integração OpenAI Ads.</p></figcaption></figure>

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 a secção Performance; associe-a a um Brand Kit em seguida.

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

1. Selecione o Brand Kit e, em seguida, abra **Insights → Settings → General**.
2. Localize **Connected Integrations** e abra o seletor **OpenAI Ads** .
3. Selecione a integração que criou.

<figure><img src="https://31915162-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>Associe a conta de anúncios a um Brand Kit.</p></figcaption></figure>

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

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

### 4. Confirme a ligação

Abra **Insights → Ads → Performance**. O painel distingue uma conta que aguarda a primeira sincronização de uma conta que já foi sincronizada, mas ainda não tem campanhas ou não teve veiculação.

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

## O que a AirOps sincroniza

| Dados                                    | Detalhes                                                                                                                                           |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Campanhas, grupos de anúncios e anúncios | Hierarquia da conta, nomes, estado, estado da análise, elementos criativos e campos compatíveis de orçamento, licitação, segmentação e programação |
| Desempenho diário                        | Impressões, cliques e gastos por anúncio e por dia                                                                                                 |
| Discriminações                           | 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 os valores recentes, pelo que os totais recentes podem mudar após uma sincronização posterior. A AirOps substitui os valores de cada dia pelos valores mais recentes.

## Acesso à gestão

A disponibilidade de relatórios de desempenho e de gestão de anúncios é independente. Uma ligação para relatórios não ativa automaticamente **Owned Ads** nem as ações de escrita em Playbooks e Workflows. Contacte a sua equipa da AirOps para saber como obter acesso às [Owned Ads](https://docs.airops.com/docs/pt/insights/ads/owned-ads.md), [ferramentas do Ads Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/tools/ads.md), ou às [etapas do fluxo de trabalho do OpenAI Ads](https://docs.airops.com/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 dos recursos antes de criar ou ativar anúncios.

## Exemplo

Para criar relatórios sobre uma campanha existente, adicione a chave de API da respetiva conta em **Account → Integrations**, associe essa integração ao Brand Kit da campanha e abra **Insights → Ads → Performance**. Após a sincronização, selecione a campanha e o intervalo de datas para consultar os gastos, as impressões e os cliques.

## Resolução de problemas

**A integração aparece como falhada.** Verifique se a chave é do ChatGPT Ads Manager e se não foi revogada. Atualize-a e, em seguida, volte a selecionar a integração.

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

**Os números são diferentes dos apresentados no Gestor de anúncios do ChatGPT.** Compare a mesma conta, o mesmo intervalo de datas e os mesmos filtros. Os valores recentes podem ser diferentes até à sincronização seguinte, quando forem incorporadas as revisões da plataforma.

**A Biblioteca de anúncios está vazia após a ligação.** A Biblioteca de anúncios utiliza respostas observadas, não os dados de veiculação da sua conta de anúncios. Verifique o Kit de marca selecionado, os prompts do ChatGPT monitorizados, as datas e os filtros. Utilize 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.
