> 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/acoes/playbooks/tools/ads.md).

# Anúncios

Analise o desempenho dos anúncios da OpenAI e crie ou faça a gestão de recursos de anúncios com as ferramentas Playbook ativadas.

Utilize **OpenAI Ads** nos Playbooks para inspecionar o desempenho da conta, preparar briefings de campanhas e recomendar alterações. Quando as ferramentas de escrita estão ativadas, um Playbook também pode criar e gerir campanhas, grupos de anúncios e anúncios.

{% hint style="info" %}
Criar, editar, ativar e arquivar anúncios através de Playbooks requer uma ativação separada. O acesso aos relatórios de desempenho não inclui automaticamente ferramentas de escrita. Contacte a sua equipa AirOps sobre a disponibilidade.
{% endhint %}

## Como Configurar

1. Abra o editor de Playbook.
2. Digite `/` na Secção onde quer trabalhar com anúncios.
3. Selecione **OpenAI Ads**.
4. Selecione ou associe a autenticação OpenAI Ads necessária. Use uma chave de API de [Gestor de Anúncios do ChatGPT](https://docs.airops.com/docs/pt/insights/analytics/settings/chatgpt-ads-manager.md).
5. Especifique a conta ou os recursos, o intervalo de datas e as métricas a analisar. Para ferramentas de escrita ativadas, descreva os recursos e definições exatos a criar ou alterar.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e12541a464f34143e0b69f01e9942a32ce7d29f1%2Ftools-ads-01-openai-ads-tool.png?alt=media" alt="Connect OpenAI Ads dialog with the OpenAI Ads (SpaceOps) account selected, shown when adding the OpenAI Ads Tool to a Playbook"><figcaption><p>Escolha a conta OpenAI Ads quando adicionar a Ferramenta.</p></figcaption></figure>

## Funcionalidades

| Tarefa                       | Comportamento suportado                                                                                          |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Analisar desempenho**      | Obter informações da conta, da campanha, do grupo de anúncios e do anúncio.                                      |
| **Gerir campanhas**          | Criar, inspecionar, editar e arquivar campanhas quando as ferramentas de escrita estiverem ativadas.             |
| **Gerir grupos de anúncios** | Criar grupos numa campanha, inspecionar ou editar as respetivas definições e arquivá-los quando ativado.         |
| **Gerir anúncios**           | Carregar imagens criativas, criar anúncios e inspecionar, editar ou arquivar anúncios existentes quando ativado. |
| **Expandir uma campanha**    | Adicionar grupos de anúncios e variantes de anúncios a uma campanha existente quando ativado.                    |

### Revisão e ativação

As ferramentas de criação de Playbooks criam campanhas, grupos de anúncios e anúncios num estado pausado. O fluxo de ativação pede-lhe para rever os recursos exatos, o orçamento, a segmentação e a criatividade antes de escolher **Ativar agora** ou **Manter em pausa**.

O fluxo de arquivo identifica o recurso exato e oferece **Arquivar** ou **Manter**. Reveja cuidadosamente as edições: alterações a recursos ativos existentes afetam a conta de anúncios ligada.

## Parâmetros

| Tarefa                      | Contexto necessário                                           | Orientação adicional                                                                                                  |
| --------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Analisar**                | Conta ligada                                                  | IDs da campanha, do grupo de anúncios ou do anúncio; intervalo de datas; discriminação diária; métricas para comparar |
| **Criar campanha**          | Nome, objetivo e orçamento                                    | Segmentação, exclusões, agendamento e instruções para manter os recursos em pausa                                     |
| **Criar grupo de anúncios** | Campanha principal, nome e definições de lance                | Sugestões de contexto que descrevem o público ou a situação                                                           |
| **Criar anúncio**           | Grupo de anúncios principal, texto, destino e imagem criativa | Orientação do Brand Kit e as variantes a testar                                                                       |
| **Editar ou arquivar**      | Recurso existente exato                                       | As alterações solicitadas e as instruções de revisão                                                                  |

## Exemplos

### Comparar desempenho

```
Use o OpenAI Ads para comparar o desempenho da campanha nos últimos 30 dias.
Devolva gastos, impressões, cliques e CTR. Identifique quais anúncios merecem uma
revisão criativa e explique a evidência de cada recomendação.
```

### Criar uma campanha em pausa

Para um espaço de trabalho com ferramentas de escrita ativadas:

```
Use o nosso Brand Kit para redigir duas variantes de anúncios do ChatGPT para o nosso projeto de gestão
de software. Crie uma campanha com um orçamento diário de 25 na moeda da conta,
um objetivo de cliques e segmentação para os Estados Unidos. Crie um grupo de anúncios com um
lance máximo de 0,06. Use a imagem aprovada e o URL da página de destino que forneço.
Mantenha a campanha, o grupo de anúncios e os anúncios em pausa. Resuma os recursos criados
e os respetivos IDs para que eu possa revê-los antes da ativação.
```

Para pesquisa de concorrência sem ligação a uma conta de anúncios, use as [ferramentas MCP de Anúncios observadas](broken://pages/99dcadd2a77ecf1c8c89fb37618bd98cb4077a78#aeo-observed-a-ds-and-advertisers). Estas consultam os anúncios que o AirOps observa em respostas monitorizadas do ChatGPT.


---

# 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/acoes/playbooks/tools/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.
