> 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/campaigns/action.md).

# Ação

Conclua o trabalho Campaign aceite e mantenha-o ligado à Medição.

A Ação é o espaço de trabalho da Campanha onde as oportunidades aceites se tornam linhas de trabalho. Funciona como uma [Grelha](https://docs.airops.com/docs/pt/acoes/grids.md), para que a sua equipa possa adicionar campos, executar [Playbooks](https://docs.airops.com/docs/pt/acoes/playbooks.md) quanto no [Workflows](https://docs.airops.com/docs/pt/acoes/workflow-concepts.md), rever resultados, acompanhar a publicação e gerir o trabalho ligado à Campanha.

Utilize **Ação** depois de a sua equipa aceitar oportunidades. O objetivo é manter o trabalho ligado à Campanha, em vez de o transferir para um processo separado onde o impacto é mais difícil de medir.

## Como funciona a Ação

1. Aceite oportunidades de **Oportunidades**.
2. Abrir **Ação** na Campanha.
3. Abra uma célula de Ação para ver o briefing aprovado, a página de destino e o contexto incluído.
4. Edite o briefing na célula de Ação se a instrução deva mudar após a aceitação.
5. Adicione os Playbooks ou Workflows de que a sua equipa precisa para criar, atualizar, rever ou publicar o trabalho.
6. Adicione os campos de publicação, propriedade e passagem de responsabilidade conforme necessário.
7. Execute o trabalho a partir das linhas de Ação aceites.

Cada oportunidade aceite cria uma linha de Ação. A linha é o registo duradouro da ação aprovada, não apenas uma página ou célula de prompt.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-ee72211d0b2710c143a18257d83a51d96454d504%2Fcampaign-action-01-rows.png?alt=media" alt="Campaign Action tab with target pages in the Opportunity column, Content Refresh run statuses, Refreshed Article drafts, owners, and published URLs"><figcaption><p>Cada oportunidade aceite torna-se uma linha de Ação que pode executar e acompanhar.</p></figcaption></figure>

## Reutilize uma configuração de Ação

Para campanhas de atualização de páginas e criação de páginas, use **Iniciar com modelo** para aplicar a Grelha de Ação predefinida para o tipo de ação da Campanha. A Campanha tem de estar ativa, tem de ter permissão para a atualizar e tem de haver um modelo predefinido publicado disponível. Os modelos só se aplicam quando a Grelha não tem colunas de ação; as linhas de oportunidades aceites não impedem a aplicação de um.

Também pode importar uma configuração de Ação de outra Campanha ou de uma Grelha autónoma através de **Configurar ações**. A importação transporta as colunas, as entradas e as referências de Playbook ou Workflow, sem copiar as linhas de origem.

Se o destino já tiver colunas de ação, reveja a confirmação de substituição. A importação substitui essas colunas e os respetivos resultados. Preserva as linhas de oportunidades aceites, a coluna de item de Ação do sistema e a coluna Track Event existente e o histórico de Medição. Cancele para manter a configuração atual. Se as dependências não puderem ser mapeadas com segurança, a importação falha sem alterar a configuração.

## O que contém uma linha de Ação

| Parte                    | Use-o para                                                                                                                                                                         |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Célula de Ação**       | O briefing aprovado, a página de destino e o contexto de apoio transferidos da oportunidade.                                                                                       |
| **Colunas de Playbook**  | Tarefas de conteúdo repetíveis, como briefs de atualização, atualizações de conteúdo ou etapas de revisão. Veja [Playbooks](https://docs.airops.com/docs/pt/acoes/playbooks.md).   |
| **Colunas de Workflow**  | Processos de workflow de nível inferior ligados à ação aceite. Veja [Workflows](https://docs.airops.com/docs/pt/acoes/workflow-concepts.md).                                       |
| **Campos de publicação** | Detalhes do CMS, URLs e notas de passagem de responsabilidade. Veja [Publicar no CMS a partir da Grelha](https://docs.airops.com/docs/pt/acoes/grids/publish-to-cms-from-grid.md). |

## Mapear valores da Ação para Entradas

Quando selecionar uma coluna de Ação como uma Entrada de Playbook ou Workflow, use o seletor secundário para escolher o valor a passar:

* **Item de Ação completo:** Passe o objeto completo. O seletor usa o nome da coluna de Ação para esta opção, que continua a ser o predefinido para mapeamentos existentes.
* **Página de destino → URL** ou **Página de destino → ID:** Passe o URL ou o ID da página. Estes resolvem para `nulo` quando a Ação não tem página de destino.
* **Justificação:** Passe o briefing editável.
* **Contextos:** Passe as páginas de apoio ou prompts.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-101fbef79b505c3c9eae9f6a9a056a100d07e75f%2Fcampaign-action-02-input-mapping.png?alt=media" alt="Configure Playbook panel with page_url mapped to the Opportunity column and its value list open: Opportunity, Target page URL and ID, Rationale, and Contexts"><figcaption><p>Escolha qual valor da Oportunidade passar para cada Entrada.</p></figcaption></figure>

A AirOps guarda a sua seleção com o mapeamento da coluna.

## Estrutura JSON da Ação

Quando passa o Item de Ação completo, o objeto contém estes campos:

| Campo                   | Estrutura        | Finalidade                                                                          |
| ----------------------- | ---------------- | ----------------------------------------------------------------------------------- |
| `action_item_id`        | Inteiro          | O ID do registo de Ação.                                                            |
| `source_opportunity_id` | Inteiro          | A Oportunidade que criou a Ação.                                                    |
| `justificativa`         | String           | O briefing editável para o trabalho.                                                |
| `target_page`           | Objeto ou `nulo` | A página a ser atualizada. Ela é `nulo` para uma Ação de criação de página.         |
| `contexts`              | Matriz           | Todas as páginas de apoio ou prompts transferidos quando a oportunidade foi aceite. |

A `target_page` o objeto inclui `web_page_id`, `url`, e `brand_kit_id`.

Cada item em `contexts` inclui:

* `id`: O ID do contexto.
* `justificativa`: Por que o contexto dá suporte à Ação.
* `posição`: A ordem do contexto.
* `recurso`: A página ou prompt de suporte.

Um recurso de prompt inclui seu `tipo`, `id`, texto do prompt, tópico e tags. Um recurso de página inclui sua `tipo`, `id`, URL da página, pasta e tópicos.

O tipo de ação da Campanha, como `page_refresh` ou `page_creation`, é configurado na Campanha. Não está incluído na carga útil de execução da Ação atual.

## Acompanhar atualizações de conteúdo

Use o recurso **passo Rastrear atualização de conteúdo** etapa no Playbook ou Workflow que publica ou atualiza a página. Workflows mais antigos podem referir-se a esta etapa como **Track Event**.

A etapa regista uma atualização de conteúdo na AirOps para que a Medição possa mostrar quando o trabalho aconteceu juntamente com o desempenho da página. Não ativa o separador Medição. A Medição está disponível antes de existirem linhas de Ação ou eventos acompanhados.

### Configure a etapa

1. Adicione **passo Rastrear atualização de conteúdo** depois da etapa que publica ou atualiza a página.
2. Escolha o tipo de evento:
   * **Página publicada** para uma nova página.
   * **Página atualizada** para uma página existente.
3. Passe o URL público final da página.
4. Use o URL da linha de Ação ou o resultado da publicação para que o evento corresponda à página que mudou.
5. Execute a etapa apenas depois de o conteúdo estar online.

O URL tem de ser o URL canónico da página. Não inclua uma barra final nem parâmetros de consulta. A AirOps usa o domínio do URL para associar o evento a um Brand Kit.

### Certifique-se de que a Medição consegue usar o evento

* Use o URL da página em produção, não um URL de pré-visualização, de staging ou do editor do CMS.
* Utilize **Página atualizada** quando atualizar uma página existente e **Página publicada** quando criar uma nova página.
* Mantenha o URL acompanhado consistente com o URL da página na linha de Ação.
* Confirme que o domínio pertence ao Brand Kit da Campanha.
* Verifique as alterações de conteúdo da página na Medição após a execução do workflow.

Os eventos de Acompanhamento de Atualização de Conteúdo ajudam-no a comparar o desempenho da página antes e depois do trabalho. Não substituem a linha de Ação, o âmbito da página nem os dados ligados do Google Search Console e do Google Analytics.

## Boa configuração de Ação

Uma boa **Ação** configuração corresponde ao objetivo da Campanha. Adicione as colunas de que a sua equipa precisa para concluir o trabalho, mas evite transformar **Ação** num rastreador geral de projetos.

Para uma Campanha de atualização de páginas, **Ação** pode incluir um Playbook de atualização, campos de CMS e detalhes de publicação. Para uma Campanha de criação de páginas, **Ação** pode incluir um Playbook de briefing, campos de fontes de apoio e notas de publicação.

Mantenha o briefing da Ação suficientemente específico para que um Playbook ou Workflow o possa utilizar. Se a instrução ainda for demasiado abrangente, edite-a na célula de Ação antes de executar o trabalho.

## Exemplos

### Campanha de atualização de páginas

Utilize **Ação** para atualizar páginas aceites da Campanha:

1. Abra a célula de Ação e confirme a página de destino e o briefing.
2. Adicione o Playbook ou Workflow que elabora recomendações de atualização.
3. Adicione campos de publicação para a passagem para o CMS ou para o URL de publicação.
4. Adicione campos de propriedade para o colega responsável pelo trabalho.
5. Acompanhe cada página através da revisão e publicação.

### Campanha de criação de páginas

Utilize **Ação** para criar conteúdo que dê suporte aos prompts aceites:

1. Abra a célula de Ação e confirme os prompts incluídos.
2. Adicione o Playbook ou Workflow que transforma o briefing num rascunho de página.
3. Adicione campos para fontes de apoio e notas de publicação.
4. Acompanhe se cada ação aceite foi publicada.

## Use uma ligação de página Markdown numa coluna Track Event

Numa **Track Event** configuração de coluna de uma Grelha de Ação, **Coluna de Página** pode referenciar uma coluna Markdown, incluindo uma saída de Workflow apresentada como Markdown. A célula tem de conter um URL de uma página ou uma ligação Markdown, como `[Página publicada](https://example.com/article)`.

Uma célula que contenha texto do artigo ou várias ligações não pode identificar uma única página a acompanhar. A AirOps apresenta **a célula Markdown deve conter um único URL ou ligação de página** para que possa corrigir a célula de origem.


---

# 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/campaigns/action.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.
