> 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/content-updates/track-content-update.md).

# Rastrear atualização de conteúdo

Acompanhe publicações de páginas e atualizações de conteúdo de refresh para Insights de AEO e SEO

## O que é a etapa Track Content Update?

A etapa Track Content Update registra atualizações de conteúdo no nível da página, como quando uma página é publicada ou atualizada, diretamente do seu fluxo de trabalho. Essas atualizações de conteúdo alimentam [Atualizações de conteúdo](/docs/pt/insights/onsite/content-updates.md), dando visibilidade à sua atividade de publicação de conteúdo em todas as páginas rastreadas pelos seus kits de marca.

{% hint style="info" %}
Algumas etapas nativas de integração com CMS (WordPress, Webflow, Shopify, Ghost) capturam automaticamente as atualizações de conteúdo da página. Para essas integrações, você não precisa adicionar uma etapa Track Content Update. Veja [Atualizações de conteúdo](/docs/pt/insights/onsite/content-updates.md) para a lista completa.
{% endhint %}

### Quando usar a etapa Track Content Update

Quando seus fluxos de trabalho criam ou atualizam o conteúdo de páginas da web usando uma etapa Code, uma etapa Call API ou qualquer outra abordagem de CMS não nativa, a AirOps não tem uma forma integrada de detectar que uma página foi publicada ou atualizada. A etapa Track Content Update fecha essa lacuna ao permitir que você registre explicitamente essas atualizações de conteúdo como parte do seu fluxo de trabalho.

Use-a quando você:

* **Enviar conteúdo por meio de uma etapa Code ou de uma chamada de API** para um CMS que não tenha uma integração nativa com a AirOps
* **Publicar novas páginas** por meio de um fluxo de trabalho e quiser que o Insights comece a rastrear essa página imediatamente
* **Atualizar conteúdo existente** e quiser registrar quando a atualização aconteceu para medir seu impacto no desempenho de SEO e AEO

***

## Como Configurar

### Digite

Selecione o tipo de atualização de conteúdo que deseja registrar:

* **Página Publicada** - use isto quando uma nova página estiver sendo criada e publicada pela primeira vez
* **Página Atualizada** - use isto quando uma página existente estiver sendo atualizada com conteúdo novo ou revisado

### URL

Insira a URL completa da página que está sendo publicada ou atualizada. Este campo oferece suporte a [modelação Liquid](/docs/pt/acoes/workflow-concepts/liquid-template.md), para que você possa referenciar saídas de etapas anteriores.

Por exemplo, se uma etapa anterior retornar a URL da página publicada:

```
{{ publish_step.output.url }}
```

**Requisitos da URL:**

* Deve ser uma URL completa (por exemplo, `https://example.com/blog/my-post`)
* O domínio da URL deve corresponder a um [Brand Kit](/docs/pt/contexto/brand-kit.md) domínio no seu workspace. A etapa resolve automaticamente os kits de marca correspondentes a partir da URL e registra uma atualização de conteúdo para cada um que corresponda.

### Atributos personalizados

Adicione até 20 pares de chave-valor de metadados personalizados à atualização de conteúdo. Tanto as chaves quanto os valores oferecem suporte a [modelação Liquid](/docs/pt/acoes/workflow-concepts/liquid-template.md).

Os atributos personalizados aparecem junto com os metadados do sistema na [Atualizações de conteúdo](/docs/pt/insights/onsite/content-updates.md) tabela e na visualização detalhada da página. Use-os para marcar atualizações de conteúdo com contexto adicional, por exemplo, o nome do fluxo de trabalho, o autor do conteúdo ou o status do CMS.

### Falha suave

Quando ativado (padrão), o fluxo de trabalho continua mesmo que esta etapa falhe. Isso evita que uma falha de rastreamento interrompa seu fluxo de publicação de conteúdo.

***

## Saída

A etapa Track Content Update gera as atualizações de conteúdo que registrou — uma entrada por kit de marca correspondente — junto com os atributos personalizados aplicados:

```json
{
  "events": [
    {
      "id": 12345,
      "brand_kit_id": 678,
      "brand_kit_name": "Example (US)"
    }
  ],
  "custom_attributes": {
    "author": "jane"
  }
}
```

Quando a URL da página corresponder a mais de um kit de marca, `events` contém uma entrada para cada um. Faça referência a um registro específico a jusante com Liquid, por exemplo `{{ track_step.output.events[0].id }}`.

***

## Exemplo de uso

Um padrão comum é combinar a etapa Track Content Update com uma etapa Code ou Call API que publica conteúdo:

1. **Prompt LLM** - gerar ou atualizar o conteúdo do artigo
2. **Passo de Código** - chamar a API do seu CMS para publicar o conteúdo no seu site
3. **Rastrear atualização de conteúdo** - registrar a publicação para que o Insights possa rastrear a página

Dessa forma, toda vez que seu fluxo de trabalho publicar conteúdo por meio de uma integração personalizada, a atualização de conteúdo será registrada e refletida no seu painel do Insights.


---

# 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/content-updates/track-content-update.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.
