> 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/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.md).
# Spiegazione dei campi calcolati
**Limitato**: I campi personalizzati calcolati sono disponibili solo per alcune edizioni del prodotto. [Contatta l'assistenza](https://app.impact.com/support/portal.ihtml?createTicket=true&) per aggiornare il tuo programma advocate e ottenere l'accesso.
Tramite [campi personalizzati](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md), puoi inviare a impact.com un'ampia gamma di informazioni aggiuntive sui partecipanti Advocate oltre alle informazioni di base necessarie per eseguire il tuo programma di referral.
I campi calcolati ricevono dati utente ed eventi e i valori vengono calcolati, memorizzati e resi visibili nel profilo del partecipante. Una volta configurato il campo calcolato, il suo valore si aggiornerà dinamicamente man mano che invii gli eventi del tuo programma Advocate che soddisfano i tuoi criteri.
{% hint style="info" %}
**Esempio:** Un campo calcolato può essere configurato per contare quante volte un partecipante effettua un acquisto di almeno $100 in una finestra di un mese. Quindi, puoi configurare il tuo programma per assegnare premi speciali ai partecipanti che effettuano almeno 3 di questi acquisti da $100 in un mese.
{% endhint %}
#### Campi calcolati predefiniti
Per impostazione predefinita, ti vengono forniti quattro campi calcolati. Puoi farvi riferimento non appena inizi a configurare le regole del tuo programma.
Campi calcolati predefiniti
| Campo calcolato | Descrizione |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| lastSeenDate | Tiene traccia dell'ultima volta in cui l'utente è stato inserito/aggiornato in Advocate. |
| firstPurchaseDate | Tiene traccia della prima data in cui abbiamo ricevuto un evento di acquisto per questo partecipante. |
| lastPurchaseDate | Tiene traccia della data dell'evento di acquisto più recente del partecipante. |
| totalPurchaseCount | Tiene traccia del numero totale di eventi di acquisto per questo partecipante. |
#### Campi calcolati creati dal cliente
Puoi creare i tuoi campi calcolati, andando oltre quelli predefiniti forniti. Quando configuri un campo calcolato, puoi:
* Aggiungere una data di inizio e una data di fine se desideri che il calcolo venga eseguito per un periodo limitato (ad es. dal 1° gennaio al 17 febbraio). Questo intervallo di tempo impostato è chiamato periodo attivo.
* Specificare una ricorrenza [finestra di tracciamento](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md) per i calcoli di somma e conteggio. Le finestre di monitoraggio possono essere finestre fisse (ad es. un singolo mese o anno solare) oppure finestre scorrevoli (ad es. gli ultimi 90 giorni).
* Imposta vincoli aggiuntivi per stabilire quando eseguire il calcolo aggiungendo un filtro o scrivendo un'espressione JSONata. Queste opzioni sono trattate in modo più dettagliato nel nostro articolo [Configurazione di un campo calcolato](/brand/it/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" %}
**Nota:** Se il tuo campo calcolato ha un periodo attivo o una finestra di monitoraggio, i valori non verranno aggiornati dopo la fine del periodo di calcolo. Se il tuo campo calcolato ha un periodo attivo (o una finestra di monitoraggio, solo per i calcoli di somma/conteggio), i valori non verranno ulteriormente aggiornati dopo la fine del periodo di calcolo. Tuttavia, i valori rimarranno visibili nel profilo di ciascun partecipante.
{% endhint %}
Campi calcolati creati dal cliente
Esistono diversi tipi di calcoli che puoi utilizzare quando crei un campo calcolato.
| Calcolo | Descrizione | Esempio |
| ------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somma | Calcola la somma del `{fieldname}` campo di `{eventkey}` eventi | Somma tutti gli acquisti effettuati da un amico segnalato entro i primi 30 giorni dalla registrazione. Assegna premi a livelli all'advocate del cliente in base all'importo speso. |
| Conteggio | Conta il numero di `{eventkey}` eventi | Premia i partecipanti quando hanno effettuato più di 10 acquisti. |
| Primo rilevamento (data) | Calcola il timestamp del primo `{eventkey}` evento | Premia i partecipanti se hanno iniziato a effettuare acquisti prima di una certa data. |
| Ultimo rilevamento (data) | Calcola il timestamp dell'ultimo `{eventkey}` evento | Premia i partecipanti se il loro ultimo acquisto è avvenuto entro 5 giorni. |
| Primo valore | Calcola il valore del `{fieldname}` campo dal primo evento {eventkey} | Premia i partecipanti quando effettuano il loro primo acquisto di importo elevato. |
| Ultimo valore | Calcola il valore del `{fieldname}` campo dall'evento più recente `{eventkey}` evento | Premia i partecipanti quando il loro ultimo pagamento è stato almeno di un certo importo. |
---
# 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/it/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 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.