> 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/custom-fields-for-advocate-explained.md).

# Campi personalizzati per Advocate spiegati

Puoi usare *campi personalizzati* per inviare a impact.com ulteriori dati sui partecipanti al tuo programma di referral. Queste informazioni possono essere utilizzate nelle tue [regole del programma](/brand/it/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) per determinare quando vengono attivati obiettivi e azioni. Puoi anche segmentare i tuoi partecipanti in base ai valori dei campi personalizzati.

I tipi di campi personalizzati che invii sono flessibili. Ad esempio, potresti voler includere informazioni sul partecipante riguardo a:

* Data di nascita
* Lingua
* Posizione
* Tipo di abbonamento
* Stato dell'iscrizione

I campi personalizzati possono essere inviati a impact.com quando carichi un file di importazione utenti o tramite UTT, API, SDK o un altro metodo di integrazione.

#### Caratteristiche dei campi

Tutti i campi personalizzati che invii devono soddisfare alcuni requisiti per i nomi dei campi e i valori.

{% tabs %}
{% tab title="Nomi" %}

* Fino a 64 caratteri.
* Sono accettati solo caratteri alfanumerici, trattini e underscore (le lettere devono essere prive di accenti).
* Sensibile alle maiuscole/minuscole, ad esempio, `customFieldName` è considerato diverso da `customfieldname`.
  {% endtab %}

{% tab title="Valori" %}

* Supporta `stringa`, `numero`, `Booleano`, e `tipi null`.
* Valore stringa massimo di 1024 caratteri.
* Le date devono essere formattate come timestamp UNIX in millisecondi.
* È possibile aggiungere/aggiornare un massimo di 100 campi per richiesta.
* Impostare un campo personalizzato per un utente su `null` rimuoverà il campo per quell'utente.
  {% endtab %}
  {% endtabs %}

#### Invia informazioni sui campi personalizzati a impact.com

Puoi includere campi personalizzati ogni volta che crei, aggiorni o esegui upsert degli utenti, indipendentemente dal metodo con cui invii i dati.

{% tabs %}
{% tab title="Importazioni di file" %}
Puoi includere campi personalizzati quando importi nuovi utenti o aggiorni in blocco utenti esistenti. Fai riferimento a [Importa i partecipanti Advocate in blocco](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md) per le istruzioni.

Di seguito sono riportati due file di esempio che puoi usare come guida per la tua importazione.

* Importazioni dei dati utente: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c)
* Importazioni dei dati evento: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](/files/9dd6b56c8e6674cad6e2bac8013a48849cd2f09c)
  {% endtab %}

{% tab title="API e SDK" %}
I campi personalizzati possono essere inclusi quando si utilizzano i [metodi GraphQL](https://integrations.impact.com/impact-brand/docs/graphql-reference) o [endpoint REST API](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) di impact.com che creano, aggiornano o eseguono upsert degli utenti. Possono anche essere inclusi quando si usano [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) o le nostre [opzioni mobile](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) per creare, aggiornare o eseguire upsert degli utenti all'interno della tua applicazione.
{% endtab %}
{% endtabs %}


---

# 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/custom-fields-for-advocate-explained.md?ask=<question>&goal=<endgoal>
```

`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.