> 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 in 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 i [campi personalizzati](https://help.impact.com/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 al tuo programma Advocate, oltre a quelle di base necessarie per gestire il programma di referral.

I campi calcolati ricevono dati su utenti ed eventi; i relativi valori vengono calcolati, memorizzati e resi visibili sul profilo del partecipante. Una volta configurato il campo calcolato, il suo valore si aggiornerà dinamicamente man mano che invii al tuo programma Advocate eventi che soddisfano i criteri specificati.

{% hint style="info" %}
**Esempio:** Un campo calcolato può essere configurato per contare quante volte un partecipante effettua un acquisto di almeno 100 $ nell'arco di un mese. Puoi quindi configurare il programma in modo che assegni premi speciali ai partecipanti che effettuano almeno 3 di questi acquisti da 100 $ in un mese.
{% endhint %}

#### Campi calcolati predefiniti

Per impostazione predefinita, sono disponibili quattro campi calcolati. Puoi usarli come riferimento non appena inizi a configurare le regole del programma.

<details>

<summary>Campi calcolati predefiniti</summary>

| Campo calcolato    | Descrizione                                                                                           |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| lastSeenDate       | Tiene traccia dell'ultima volta in cui l'utente è stato creato o aggiornato in Advocate.              |
| firstPurchaseDate  | Tiene traccia della prima data in cui è stato 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.                        |

</details>

#### Campi calcolati creati dal cliente

Puoi creare campi calcolati personalizzati, oltre a quelli predefiniti. 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 esempio, dal 1° gennaio al 17 febbraio). Questo intervallo di tempo è chiamato periodo attivo.
* Specificare una [finestra di monitoraggio](https://help.impact.com/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) ricorrente per i calcoli di somma e conteggio. Le finestre di monitoraggio possono essere fisse (ad esempio, un singolo mese o anno solare) o mobili (ad esempio, gli ultimi 90 giorni).
* Definire ulteriori vincoli per l'esecuzione del calcolo aggiungendo un filtro o scrivendo un'espressione JSONata. Queste opzioni sono illustrate più dettagliatamente nel nostro articolo [Configurazione di un campo calcolato](https://help.impact.com/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 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 campo calcolato ha un periodo attivo (o una finestra di monitoraggio, solo per i calcoli di somma o conteggio), i valori non verranno più aggiornati dopo la fine del periodo di calcolo. Tuttavia, i valori rimarranno visibili sul profilo di ogni partecipante.
{% endhint %}

<details>

<summary>Campi calcolati creati dal cliente</summary>

Quando crei un campo calcolato, puoi utilizzare diversi tipi di calcolo.

| Calcolo                       | Descrizione                                                                                | Esempio                                                                                                                                                                   |
| ----------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somma                         | Calcola la somma dei valori del campo `{fieldname}` per gli eventi `{eventkey}` registrati | Somma tutti gli acquisti effettuati da un amico invitato nei primi 30 giorni dopo l'iscrizione. Assegna premi a livelli al cliente sostenitore in base all'importo speso. |
| Conteggio                     | Conta il numero di eventi `{eventkey}` registrati                                          | Premia i partecipanti quando hanno effettuato più di 10 acquisti.                                                                                                         |
| Prima rilevazione (data)      | Calcola la data e l'ora del primo evento `{eventkey}` registrato                           | Premia i partecipanti se hanno iniziato a effettuare acquisti prima di una certa data.                                                                                    |
| Ultima visualizzazione (data) | Calcola il timestamp dell'ultimo `{eventkey}` evento                                       | Premia i partecipanti se hanno effettuato l'ultimo acquisto negli ultimi 5 giorni.                                                                                        |
| Primo valore                  | Calcola il valore del `{fieldname}` campo del primo evento {eventkey}                      | Premia i partecipanti quando effettuano un primo acquisto di importo elevato.                                                                                             |
| Ultimo valore                 | Calcola il valore del `{fieldname}` campo dell'evento più recente `{eventkey}` evento      | Premia i partecipanti quando l'ultimo pagamento raggiunge almeno un determinato importo.                                                                                  |

</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/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/calculated-fields-explained.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.
