> 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/calculated-fields-explained.md).
# Campos calculados explicados
**Limitado**: Campos personalizados calculados 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 advocacy e obter acesso.
Por meio de [campos personalizados](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md), você pode enviar à impact.com uma ampla gama de informações adicionais sobre os participantes do seu programa Advocate 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 ficam visíveis no perfil do participante. Depois que o campo calculado é configurado, seu valor será atualizado dinamicamente à medida que você enviar eventos do seu programa Advocate 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 um período de um mês. Então, 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 referenciá-los assim que começar a configurar as regras do seu programa.
Campos calculados padrão
| Campo calculado | Descrição |
| ------------------ | ------------------------------------------------------------------------------------- |
| lastSeenDate | Registra a última vez em que o usuário foi inserido ou atualizado 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. |
#### 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.
* Especifique uma janela recorrente [janela de acompanhamento](/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) para seus cálculos de soma e contagem. As janelas de acompanhamento podem ser janelas fixas (por exemplo, um único mês ou ano do calendário) ou janelas móveis (por exemplo, os últimos 90 dias).
* Defina restrições adicionais para quando o cálculo é executado adicionando um filtro ou escrevendo uma expressão JSONata. Essas opções são discutidas em mais detalhes em nosso artigo [Configurando um campo calculado](/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).
{% hint style="info" %}
**Observação:** Se o seu campo calculado tiver um período ativo ou uma janela de acompanhamento, os valores não serão atualizados após o término do período de cálculo. Se o seu campo calculado tiver um período ativo (ou uma janela de acompanhamento, apenas para cálculos de soma/contagem), os valores não serão mais atualizados após o término do período de cálculo. No entanto, os valores permanecerão visíveis no perfil de cada participante.
{% endhint %}
Campos calculados criados pelo cliente
Há vários tipos de cálculos que você pode usar ao criar um campo calculado.
| Cálculo | Descrição | Exemplo |
| ------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Soma | Calcule a soma dos `{fieldname}` campo de `{eventkey}` eventos | Some todas as compras que um amigo indicado fizer nos primeiros 30 dias após o cadastro. Conceda recompensas em níveis ao defensor do cliente com base no valor gasto. |
| Contagem | Conte o número de `{eventkey}` eventos | Recompense os participantes quando tiverem feito mais de 10 compras. |
| Primeira vez visto (data) | Calcule o carimbo de data e hora do primeiro `{eventkey}` evento | Recompense os participantes se eles tiverem começado a fazer compras antes de uma determinada data. |
| Última vez visto (data) | Calcule o carimbo de data e hora do último `{eventkey}` evento | Recompense os participantes se a última compra deles tiver ocorrido nos últimos 5 dias. |
| Primeiro valor | Calcule o valor do `{fieldname}` campo do primeiro evento {eventkey} | Recompense os participantes quando fizerem uma primeira compra de alto valor. |
| Último valor | Calcule o valor do `{fieldname}` campo do evento mais recente `{eventkey}` evento | Recompense os participantes quando o último pagamento deles for de pelo menos um determinado valor. |
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET 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?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.