> 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/workflow-concepts/workflow-steps/openai-ads.md). # OpenAI Ads Crie, edite e arquive recursos de anúncios da OpenAI com os Workflow Steps ativados. Os passos do OpenAI Ads permitem que um Workflow crie e gestione campanhas, grupos de anúncios e anúncios do ChatGPT. Encadeie Steps para construir a hierarquia da conta e carregar imagens criativas antes de criar anúncios. {% hint style="info" %} As ações do Workflow do OpenAI Ads exigem ativação separada do workspace e uma conta do ChatGPT Ads ligada. Contacte a sua equipa da AirOps se a integração não estiver disponível no seletor de Steps. {% endhint %} ## Como Configurar 1. Adicione um **OpenAI Ads** Adicione um Step ao seu Workflow e escolha uma ação. 2. Selecione a autenticação do OpenAI Ads. Use uma chave criada em [Gestor de Anúncios do ChatGPT](/docs/pt/insights/analytics/settings/chatgpt-ads-manager.md). 3. Teste a ligação. Uma chave válida ainda pode exigir revisão da conta antes de a conta estar pronta para anunciar. 4. Selecione um recurso pai existente ou, para uma ação de criação, faça referência ao pai criado por um Step anterior. 5. Configure as entradas da ação. Escolha **Em pausa** ao preparar recursos para revisão antes da entrega. 6. Execute o Workflow e inspecione os detalhes do recurso devolvido e o estado de revisão do anúncio. ## Ações e parâmetros | Ação | Entradas principais | | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | **Criar Campanha** | Nome, estado explícito, objetivo, tipo e montante do orçamento, e quaisquer definições de agendamento ou segmentação | | **Editar campanha** | Seleção da campanha e os campos a atualizar | | **Arquivar campanha** | Seleção da campanha | | **Criar grupo de anúncios** | Campanha existente ou ID/referência da campanha, nome do grupo, lance máximo, estado e pistas de contexto | | **Editar grupo de anúncios** | Seleções de campanha e de grupo de anúncios, além dos campos a atualizar | | **Arquivar grupo de anúncios** | Seleções de campanha e de grupo de anúncios | | **Carregar imagem do anúncio** | URL pública que aponta diretamente para uma imagem | | **Criar anúncio** | Grupo de anúncios existente ou ID/referência do grupo de anúncios, nome, estado, título, texto, URL de destino e ID do ficheiro da imagem carregada | | **Editar anúncio** | Seleções de campanha, grupo de anúncios e anúncio, além dos campos a atualizar | | **Arquivar anúncio** | Seleções de campanha, grupo de anúncios e anúncio | Introduza os valores do orçamento e do lance na moeda da conta de anúncios. Use os campos de data e hora para especificar o agendamento e o fuso horário. As pistas de contexto podem ser linhas separadas ou uma matriz JSON de um Step anterior. **Carregar imagem do anúncio** devolve um `file_id`. Passe esse valor para **Criar anúncio** para a criativa do cartão de chat. As ações de criar, editar e arquivar devolvem a resposta do fornecedor; as respostas de anúncio incluem `estado_de_revisão`. ### Reexecutar Steps de criação Reexecutar o mesmo Step de criação no mesmo Workflow reutiliza a campanha, o grupo de anúncios ou o anúncio originais, mesmo que altere as entradas. Use um **Editar** Step para atualizar um recurso existente. Use um Step de criação diferente ou outro Workflow quando pretender criar um recurso separado. Um Step de carregamento de imagem pode devolver um novo `file_id` numa nova execução. Isso não faz com que o Step de criação seguinte crie um segundo anúncio. {% hint style="warning" %} Estes Steps gravam na sua conta de anúncios ligada. Os recursos ativos podem veicular anúncios e gastar orçamento. Arquivar é irreversível. Use estados explícitos de pausa e um processo de revisão ao construir um Workflow de criação. {% endhint %} ## Exemplo Construa um Workflow com estes Steps: 1. **Criar Campanha** com o objetivo e orçamento desejados, com o estado **Em pausa**. 2. **Criar grupo de anúncios** usando o ID da campanha devolvido pelo primeiro Step, também **Em pausa**. 3. **Carregar imagem do anúncio** usando uma URL pública para a sua criativa aprovada. 4. **Criar anúncio** usando o ID do grupo de anúncios e o `file_id`, com texto aprovado e URL de destino e estado **Em pausa**. 5. Revise os recursos e a criativa devolvidos antes de os ativar através de uma superfície de gestão ativada. --- # 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/workflow-concepts/workflow-steps/openai-ads.md?ask=&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.