# Spiegazione dei campi personalizzati per Advocate

Puoi usare *campi personalizzati* per inviare a impact.com informazioni aggiuntive sui partecipanti al tuo programma di referral. Queste informazioni possono essere utilizzate nel tuo [regole del programma](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/getting-started-with-advocate/advocate-program-rules-explained) 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 su:

* Compleanno
* Lingua
* Posizione
* Tipo di abbonamento
* Stato di 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 del campo

Qualsiasi campo personalizzato che invii deve soddisfare alcuni requisiti per nomi e valori dei campi.

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

* Fino a 64 caratteri.
* Sono accettati solo caratteri alfanumerici, trattini e underscore (le lettere devono essere non accentate).
* Case sensitive, ad esempio, `customFieldName` viene trattato come distinto da `customfieldname`.
  {% endtab %}

{% tab title="Valori" %}

* Supporta `stringa`, `numero`, `Booleano`, e `tipi null`.
* Valore massimo della stringa di 1024 caratteri.
* Le date devono essere formattate come timestamp UNIX in millisecondi.
* Massimo 100 campi possono essere aggiunti/aggiornati per richiesta.
* Impostare un campo personalizzato per un utente su `null` rimuoverà 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 effettui 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 utenti esistenti in blocco. Consulta [Importa partecipanti advocate in blocco](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk) per le istruzioni.

Di seguito sono riportati due file di esempio che puoi utilizzare per guidare la tua 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 evento: [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 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) che creano, aggiornano o eseguono upsert degli utenti. Possono essere inclusi anche quando si utilizza [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 dall'interno della tua applicazione.
{% endtab %}
{% endtabs %}