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

# Spiegazione dei campi personalizzati per Advocate

Puoi utilizzare *i campi personalizzati* per inviare a impact.com informazioni aggiuntive sui partecipanti al tuo programma di referral. Queste informazioni possono essere utilizzate nelle [regole del programma](https://help.impact.com/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 partecipanti in base ai valori dei campi personalizzati.

I tipi di campi personalizzati che puoi inviare sono flessibili. Ad esempio, potresti voler includere informazioni relative a:

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

Puoi inviare i campi personalizzati a impact.com quando carichi un file di importazione utenti oppure tramite UTT, API, SDK o un altro metodo di integrazione.

#### Caratteristiche dei campi

I campi personalizzati che invii devono rispettare alcuni requisiti relativi ai nomi e ai valori.

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

* Massimo 64 caratteri.
* Sono accettati solo caratteri alfanumerici, trattini e trattini bassi (le lettere non devono avere accenti).
* Distinzione tra maiuscole e minuscole, ad esempio `customFieldName` è considerato distinto da `customfieldname`.
  {% endtab %}

{% tab title="Valori" %}

* Supporta `string`, `number`, `Boolean`, e `null types`.
* Valore massimo di una stringa: 1024 caratteri.
* Le date devono essere formattate come timestamp UNIX in millisecondi.
* È possibile aggiungere o aggiornare al massimo 100 campi per richiesta.
* Impostare un campo personalizzato per un utente su `null` rimuove il campo per quell'utente.
  {% endtab %}
  {% endtabs %}

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

Puoi includere campi personalizzati ogni volta che crei, aggiorni o esegui un upsert degli utenti, indipendentemente dal metodo usato per inviare i dati.

{% tabs %}
{% tab title="Importazioni da file" %}
Puoi includere campi personalizzati quando importi nuovi utenti o aggiorni in blocco quelli esistenti. Consulta [Importare in blocco i partecipanti Advocate](https://help.impact.com/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 trovi due file di esempio che puoi usare come riferimento per l'importazione.

* Importazioni di dati utente: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* Importazioni di dati degli eventi: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
  {% endtab %}

{% tab title="API e SDK" %}
I campi personalizzati possono essere inclusi quando utilizzi impact.com [metodi GraphQL](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/graphql-api) oppure [endpoint dell’API REST](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/advocate-rest-api) che creano, aggiornano o inseriscono utenti. Possono essere inclusi anche quando si usa [UTT](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/advocate-installation-scripts) o le nostre [opzioni per dispositivi mobili](https://integrations.impact.com/integration-guides/for-brands/advocate/mobile-options-for-advocate/mobile-options-for-advocate-programs) per creare, aggiornare o inserire utenti dall’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 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/custom-fields-for-advocate-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.
