> 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**: Campos personalizados calculados estão disponíveis apenas em algumas edições do produto. [Entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true&) para atualizar seu programa de defensores e obter acesso.

Os campos calculados permitem que você acompanhe os eventos à medida que eles chegam, configure um cálculo usando campos de evento e armazene os dados resultantes no perfil de um participante. Depois que o campo calculado for configurado, seu valor será atualizado dinamicamente conforme você enviar eventos do impact.com que atendam aos seus critérios.

Este guia mostrará o processo básico para configurar um campo calculado, incluindo um exemplo no final. Para mais detalhes sobre como os campos calculados funcionam e quais tipos de cálculos são possíveis, consulte [Campos Calculados Explicados](/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] → Fontes de dados → Campos**.
2. Selecione **Criar campo calculado**.
3. Preencha os campos:
   * **Nome**
   * **Evento**
   * **Cálculo**
   * **Campo de evento** (se aplicável ao seu cálculo)
4. Opcionalmente, aplique uma **Janela de acompanhamento** se você quiser realizar um cálculo de soma ou contagem de forma contínua. O fuso horário da sua conta 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 você quiser incluir apenas eventos nos cálculos. Para obter detalhes sobre os tipos de janela e quando usá-los, consulte [Janelas de Acompanhamento para Campos Calculados](/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 móvel, então pode definir um valor máximo a ser contado para cada unidade do seu intervalo (por exemplo, cada dia em um intervalo de 60 dias).
6. No *Filtros* campo, adicione um **Período ativo** se você quiser definir uma data de início e de fim 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 você quiser que apenas eventos que atendam a critérios específicos sejam incluídos no cálculo.
   * Os filtros podem se aplicar a características do evento (por exemplo, valor da receita de uma determinada compra) ou a características do usuário (por exemplo, a contagem do número de vezes que um participante faz uma compra acima de US$ 100)
8. **Revisar** suas seleções e decida se você quer [preencher retroativamente os valores](/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.
   * Selecione o ![](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 você quiser preencher os cálculos retroativamente.
9. Selecione **Salvar** para que suas alterações sejam salvas.

#### Exemplo

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

<details>

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

Veja como o cálculo pode ser configurado:

1. Na **Cálculo**, complete o **Nome** campo.
2. Insira os seguintes valores para os campos de evento e cálculo:
   * **Evento**: Compra
   * **Cálculo**: Contagem
     * Isso configurará o cálculo para contar quantas vezes o impact.com recebe eventos de compra que atendem aos seus critérios.
3. Aplique uma **Janela de acompanhamento**. Isso fará com que o cálculo seja reiniciado a cada mês.
   * Selecione **Janela fixa**.
   * Selecione um **1 mês de calendário** duração da janela.
4. Adicionar **Filtros** para especificar que você quer contar apenas os eventos de compra com valor de US$ 50 ou mais:

   * 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 os `events.fields.revenue` campo.
   * Altere o tipo de operador para **maior ou igual a**.
   * Enter `50` como o valor da variável de 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, o impact.com recomenda usar a menor denominação utilizada na configuração do seu banco de dados. Se você 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. Revisar e **Salvar**.

</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.