# Spiegazione dei campi calcolati

**Limitato**: I campi personalizzati calcolati sono disponibili solo per alcune edizioni del prodotto. [Contatta il supporto](https://app.impact.com/support/portal.ihtml?createTicket=true&) per aggiornare il tuo programma advocate e ottenere l'accesso.

Tramite [campi personalizzati](/brand/it/che-cosa-vorresti-imparare/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 nozioni di base necessarie per gestire 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 verrà aggiornato 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 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.

<details>

<summary>Campi calcolati predefiniti</summary>

| Campo calcolato    | Descrizione                                                                                           |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| lastSeenDate       | Tiene traccia dell'ultima volta in cui l'utente è stato upserted 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.                        |

</details>

#### 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 impostato si chiama periodo attivo.
* Specificare una finestra ricorrente [finestra di monitoraggio](/brand/it/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participants/custom-and-calculated-fields/tracking-windows-for-calculated-fields-explained.md) per i tuoi calcoli di somma e conteggio. Le finestre di tracciamento possono essere finestre fisse (ad es. un singolo mese o anno solare) o finestre scorrevoli (ad es. ultimi 90 giorni).
* Impostare vincoli aggiuntivi per quando viene eseguito il calcolo aggiungendo un filtro o scrivendo un'espressione JSONata. Queste opzioni sono trattate in maggiore dettaglio nel nostro articolo [Configurazione di un campo calcolato](/brand/it/che-cosa-vorresti-imparare/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 %}

<details>

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

Esistono diversi tipi di calcoli che puoi utilizzare quando crei un campo calcolato.

| Calcolo                       | Descrizione                                                                           | Esempio                                                                                                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Somma                         | Calcola la somma di `{fieldname}` campo da `{eventkey}` eventi                        | Somma tutti gli acquisti effettuati da un amico segnalato entro i primi 30 giorni dopo l'iscrizione. Assegna premi a livelli al customer advocate in base all'importo speso. |
| Conteggio                     | Conta il numero di `{eventkey}` eventi                                                | Premia i partecipanti quando hanno effettuato più di 10 acquisti.                                                                                                            |
| Prima visualizzazione (data)  | Calcola il timestamp del primo `{eventkey}` evento                                    | 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 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 un 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 valore.                                                                                     |

</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/it/che-cosa-vorresti-imparare/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.
