# Campos Calculados Explicados

**Limitado**: Campos personalizados calculados estão disponíveis apenas para 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.

Por meio de [campos personalizados](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md), você pode enviar ao impact.com uma ampla variedade de informações adicionais sobre seus participantes Advogados além do básico necessário para executar seu programa de indicação.

Os campos calculados recebem dados do usuário e do evento, e os valores são calculados, armazenados e se tornam visíveis no perfil do participante. Depois que o campo calculado é configurado, seu valor será atualizado dinamicamente à medida que você enviar eventos do programa Advogado que atendam aos seus critérios.

{% hint style="info" %}
**Exemplo:** Um campo calculado pode ser configurado para contar quantas vezes um participante faz uma compra de pelo menos US$ 100 em uma janela de um mês. Em seguida, você pode configurar seu programa para conceder recompensas especiais aos participantes que fizerem pelo menos 3 dessas compras de US$ 100 em um mês.
{% endhint %}

#### Campos calculados padrão

Por padrão, você recebe quatro campos calculados. Você pode fazer referência a eles assim que começar a configurar as regras do seu programa.

<details>

<summary>Campos calculados padrão</summary>

| Campo calculado    | Descrição                                                                             |
| ------------------ | ------------------------------------------------------------------------------------- |
| lastSeenDate       | Registra a última vez em que o usuário foi upserted no Advocate.                      |
| firstPurchaseDate  | Registra a primeira data em que recebemos um evento de compra para este participante. |
| lastPurchaseDate   | Registra a data do evento de compra mais recente do participante.                     |
| totalPurchaseCount | Registra o número total de eventos de compra para este participante.                  |

</details>

#### Campos calculados criados pelo cliente

Você pode criar seus próprios campos calculados que vão além dos padrões fornecidos. Ao configurar um campo calculado, você pode:

* Adicionar uma data de início e uma data de término se quiser que o cálculo seja executado por um período limitado (por exemplo, de 1º de janeiro a 17 de fevereiro). Esse período de tempo definido é chamado de período ativo.
* Especificar uma janela recorrente [janela de rastreamento](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md) para os cálculos de soma e contagem. As janelas de rastreamento podem ser janelas fixas (por exemplo, um mês ou ano civil específico) ou janelas deslizantes (por exemplo, os últimos 90 dias).
* Definir restrições adicionais para quando o cálculo é realizado adicionando um filtro ou escrevendo uma expressão JSONata. Essas opções são discutidas em mais detalhes no nosso artigo [Configurando um Campo Calculado](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/set-up-a-calculated-field.md).

{% hint style="info" %}
**Observação:** Se o seu campo calculado tiver um período ativo ou uma janela de rastreamento, os valores não serão atualizados após o fim do período de cálculo. Se o seu campo calculado tiver um período ativo (ou uma janela de rastreamento, apenas para cálculos de soma/contagem), os valores não serão mais atualizados após o fim do período de cálculo. No entanto, os valores permanecerão visíveis no perfil de cada participante.
{% endhint %}

<details>

<summary>Campos calculados criados pelo cliente</summary>

Há vários tipos de cálculos que você pode usar ao criar um campo calculado.

| Cálculo               | Descrição                                                                          | Exemplo                                                                                                                                                           |
| --------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Soma                  | Calcular a soma do `{fieldname}` campo de `{eventkey}` eventos                     | Some todas as compras que um amigo indicado faz nos primeiros 30 dias após o cadastro. Conceda recompensas em níveis ao cliente advogado com base no valor gasto. |
| Contagem              | Contar o número de `{eventkey}` eventos                                            | Recompense os participantes quando tiverem feito mais de 10 compras.                                                                                              |
| Primeiro Visto (Data) | Calcular o timestamp do primeiro `{eventkey}` evento                               | Recompense os participantes se eles tiverem começado a fazer compras antes de uma determinada data.                                                               |
| Último Visto (Data)   | Calcular o timestamp do último `{eventkey}` evento                                 | Recompense os participantes se a última compra deles tiver ocorrido nos últimos 5 dias.                                                                           |
| Primeiro Valor        | Calcular o valor do `{fieldname}` campo do primeiro evento {eventkey}              | Recompense os participantes quando fizerem uma grande primeira compra.                                                                                            |
| Último Valor          | Calcular o valor do `{fieldname}` campo do evento mais recente `{eventkey}` evento | Recompense os participantes quando o último pagamento deles tiver sido de pelo menos um determinado valor.                                                        |

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
