> 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/set-up-a-calculated-field.md).

# Configurar um campo calculado

**Limitado**: os campos calculados personalizados estão disponíveis apenas em determinadas edições do produto. [Entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) para fazer upgrade do seu programa de defensores e obter acesso.

Os campos calculados permitem acompanhar os eventos à medida que eles chegam, configurar um cálculo usando campos de evento e armazenar os dados resultantes no perfil de um participante. Depois de configurado, o valor do campo calculado é atualizado dinamicamente conforme você envia eventos do impact.com que atendem aos seus critérios.

Este guia apresenta o processo básico para configurar um campo calculado, incluindo um exemplo ao final. Para saber mais sobre como os campos calculados funcionam e quais tipos de cálculos são possíveis, consulte [Entenda os 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).

#### Configurar um campo calculado

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Data Sources → Fields**.
2. Selecione **Create calculated field**.
3. Preencha os campos:
   * **Nome**
   * **Evento**
   * **Cálculo**
   * **Campo do evento** (se aplicável ao seu cálculo)
4. Opcionalmente, aplique uma **janela de acompanhamento** se quiser realizar um cálculo de soma ou contagem em uma janela contínua. O fuso horário da sua conta do impact.com será aplicado à janela de acompanhamento.
   * ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar]** se quiser incluir apenas eventos nos cálculos. Para saber mais sobre os tipos de janela e quando usá-los, consulte [Janelas de acompanhamento para 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/tracking-windows-for-calculated-fields-explained.md)
5. Se você aplicou uma janela deslizante, pode definir um valor máximo a ser contado para cada unidade do intervalo (por exemplo, cada dia em um intervalo de 60 dias).
6. No campo *Filtros* , adicione um **Período ativo** se quiser definir uma data de início e uma data de término para o cálculo.
7. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **Filtros adicionais** se quiser incluir no cálculo apenas eventos que atendam a critérios específicos.
   * Os filtros podem ser aplicados às características do evento (por exemplo, o valor da receita de uma determinada compra) ou às características do usuário (por exemplo, a contagem de quantas vezes um participante faz uma compra acima de US$ 100).
8. **Revise** suas seleções e decida se deseja [preencher retroativamente os valores](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/edit-a-calculated-field.md) para todos os participantes.
   * Marque a ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[Caixa marcada]** se quiser preencher os cálculos retroativamente.
9. Selecione **Salvar** para salvar suas alterações.

#### Exemplo

* Você tem um programa de indicações e quer recompensar os participantes que fazem compras de valor alto com frequência pouco depois de serem indicados. Você determina que, no seu programa, isso significa qualquer participante que faça pelo menos 3 compras de US$ 50 ou mais no mês seguinte ao início da indicação. Um campo calculado pode ajudar a identificar quais participantes atingem esse limite e servir de base para uma regra do programa que concede uma recompensa a esses participantes.

<details>

<summary>Instruções de configuração</summary>

Veja como configurar o cálculo:

1. Em **Cálculo**, preencha **Nome** campo.
2. Insira os valores a seguir para os campos de evento e cálculo:
   * **Evento**: Compra
   * **Cálculo**: Contagem
     * Isso configurará o cálculo para contar quantas vezes a impact.com recebe eventos de compra que atendem aos seus critérios.
3. Aplique uma **janela de rastreamento**. Isso fará com que o cálculo seja reiniciado todos os meses.
   * Selecione **Janela fixa**.
   * Selecione uma duração de janela de **1 mês calendário** .
4. Adicione **filtros** para especificar que você quer contar apenas os eventos de compra com valor igual ou superior a US$ 50:

   * Selecione **Adicionar regra**.
   * Para a primeira condição ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu suspenso]**, selecione o campo `events.fields.revenue` .
   * Altere o tipo de operador para **maior ou igual a**.
   * Insira `50` como valor da variável string.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Observação:</strong> As expressões JSONata aceitam apenas números inteiros. Ao usar moeda, a impact.com recomenda usar a menor unidade monetária utilizada na configuração do seu banco de dados. Se não tiver certeza, <a href="http://saasquatch-support@impact.com">entre em contato com nossa equipe de suporte</a> para obter ajuda.</p></div>
5. Revise e **salve**.

</details>


---

# 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/set-up-a-calculated-field.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.
