> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md).

# Explicação sobre janelas de rastreamento para campos calculados

{% hint style="info" %}
**Observação**: confira nosso artigo sobre [campos calculados](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md) para entender o que são e quando são úteis. Se você precisa de ajuda para configurar uma janela de acompanhamento para seu campo calculado, consulte [Como configurar um campo calculado](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/set-up-a-calculated-field.md).
{% endhint %}

Uma janela de acompanhamento permite adicionar elementos baseados em tempo aos campos calculados. Você pode adicionar janelas de acompanhamento a qualquer campo calculado que use um cálculo de soma ou contagem.

Incluir uma janela de acompanhamento em um campo calculado é útil se você quiser permitir que seus participantes acumulem um valor periodicamente (como o valor de compras) e, em seguida, recompensá-los com base nesse valor. Os dados de eventos só serão calculados durante a janela selecionada. Com o passar do tempo e a atualização da janela, os dados anteriores não serão considerados.

Você pode usar o valor do campo para configurar regras do programa que incentivem seus participantes a alinhar suas ações aos seus objetivos de:

* **Recência**: incentive participantes inativos a voltar a interagir ou fazer uma nova compra.
* **Frequência**: incentive seus clientes mais frequentes a continuar interagindo com seu programa e usando seus serviços.
* **Valor monetário**: recompense quem gasta mais ao atingir um determinado valor mínimo em compras.

Ao configurar um campo calculado, você pode escolher entre dois tipos de janelas de acompanhamento:

{% tabs %}
{% tab title="Janelas de acompanhamento fixas" %}
As janelas fixas permitem acompanhar um valor durante um dia, uma semana, um mês ou um ano do calendário. A janela começa no início do intervalo e se encerra no fim dele. Os horários de início e término dependem das configurações de fuso horário da sua conta impact.com.

Quando você cria um campo calculado com uma janela fixa, a contagem começa no momento em que o campo é criado. Ela não espera o início do próximo intervalo completo e, por padrão, não calcula retroativamente os valores desde o início do intervalo atual que você não contabilizou.

<details>

<summary>Exemplo</summary>

Você quer configurar uma regra do programa que conceda uma recompensa especial aos participantes que gastarem mais de um determinado valor por mês. Para isso, você precisará de um campo calculado que some o valor das compras em uma janela fixa de 1 mês. Depois de configurado, os eventos de compra serão adicionados do primeiro dia do mês, à meia-noite, até as 23h59 do último dia do mês.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-0e7df8d9fa2b2b8cc3f1b333ce601aacde2f0b6f%2Ffce9f5404d15d0c5692cb3e89ff28b1305dd4baf8572e51e71766b633cc75c09.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>
{% endtab %}

{% tab title="Janelas de acompanhamento móveis" %}
As janelas móveis permitem medir um valor ao longo de um intervalo personalizado de até 90 dias, semanas, meses ou anos. Ao contrário das janelas fixas, as janelas móveis não dependem de intervalos individuais predefinidos do calendário. Você pode definir uma janela de 10 dias, 5 semanas, 3 meses, 2 anos e assim por diante.

Cada intervalo contém uma **unidade** de tempo. O campo calculado será atualizado à medida que cada unidade passar e recebermos novos eventos que atendam aos seus critérios.

| Exemplo de intervalo | Unidade de tempo                          | Seu campo será atualizado… |
| -------------------- | ----------------------------------------- | -------------------------- |
| 10 dias              | 1 dia (das 0h às 23h59)                   | A cada dia que passar      |
| 5 semanas            | 1 semana (de domingo a sábado)            | A cada semana que passar   |
| 3 meses              | 1 mês (do primeiro ao último dia do mês)  | A cada mês que passar      |
| 2 anos               | 1 ano (de 1º de janeiro a 31 de dezembro) | A cada ano que passar      |

As janelas móveis permitem definir um valor máximo a ser somado ou contado para cada unidade da sua janela de acompanhamento, por exemplo, para cada dia da sua janela de 90 dias ou para cada semana da sua janela de 12 semanas. Isso não define um valor máximo para o intervalo inteiro, apenas para cada unidade.

Independentemente do intervalo, consideramos que cada unidade começa às 0h (meia-noite) e termina às 23h59. Usamos as configurações de fuso horário da sua conta impact.com para determinar esses horários.

<details>

<summary>Exemplo</summary>

Você quer permitir que os participantes acumulem pontos com base no valor gasto ao longo de 90 dias. A cada dia que passa e recebemos novos dados de eventos correspondentes, o valor do campo calculado é atualizado para refletir o valor gasto nos 90 dias anteriores.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-947333eb074b672e6904336b45f10753b2fc0bb9%2Ffc0d585ccace147e93200605e9af49924c8bb0ea43d5104d735aabdde9f87751.png?alt=media" alt=""><figcaption></figcaption></figure></div>

</details>
{% endtab %}
{% endtabs %}


---

# 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://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.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.
