> 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 effettuare l'upgrade del tuo programma di advocacy 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 tuoi partecipanti Advocate oltre alle nozioni 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 diventano 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 criteri.
{% hint style="info" %}
**Esempio:** Un campo calcolato può essere configurato per contare quante volte un partecipante effettua un acquisto di almeno 100 $ in un intervallo 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 | Traccia l'ultima volta in cui l'utente è stato inserito o aggiornato in Advocate. |
| firstPurchaseDate | Traccia la prima data in cui abbiamo ricevuto un evento di acquisto per questo partecipante. |
| lastPurchaseDate | Traccia la data dell'evento di acquisto più recente del partecipante. |
| totalPurchaseCount | Traccia il numero totale di eventi di acquisto per questo partecipante. |
#### Campi calcolati creati dal cliente
Puoi creare i tuoi campi calcolati che vanno oltre quelli predefiniti forniti. Quando configuri un campo calcolato, puoi:
* Aggiungere una data di inizio e una 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 prestabilito è chiamato periodo attivo.
* Specifica una ricorrente [finestra di monitoraggio](/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 tracciamento possono essere finestre fisse (ad es. un singolo mese o anno solare) oppure finestre scorrevoli (ad es. gli ultimi 90 giorni).
* Imposta ulteriori vincoli su quando il calcolo viene eseguito 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 tracciamento, 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 tracciamento, solo per i calcoli di somma/conteggio), i valori non verranno più 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 usare quando crei un campo calcolato.
| Calcolo | Descrizione | Esempio |
| ------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somma | Calcola la somma dei `{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. |
| Conta | 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 del primo evento {eventkey} | Premia i partecipanti quando effettuano il loro primo acquisto di importo elevato. |
| Ultimo valore | Calcola il valore del `{fieldname}` campo dell'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 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/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 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.