# Importa in blocco i partecipanti Advocate
Advocate accetta importazioni inviate in `.csv` o `.jsonl` formati di file. Si prega di consultare il nostro [file di esempio CSV per l'importazione](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) e [file di esempio JSONL per l'importazione](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) per visualizzare la struttura del file richiesta per la tua importazione.
{% hint style="info" %}
**Nota:** Si raccomanda che ogni importazione non superi i 500.000 record.
{% endhint %}
#### Importa partecipanti in blocco
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage] → Partecipanti**.
2. Seleziona **Importa utenti**.
3. Sotto *Tipo di importazione*, seleziona **Utenti**.
4. Aggiungi il tuo file di importazione selezionando **Seleziona file**.
5. **\[Opzionale]** Per aggiungere o rimuovere i partecipanti importati da un segmento di utenti specifico, seleziona il segmento dal menu a discesa.
{% hint style="info" %}
**Nota:** Questa selezione si applica a *tutti* i partecipanti inclusi in questo file di importazione.
{% endhint %}
6. Seleziona **Avvia importazione**.
Quando l'importazione è completata, viene inviata un'email di conferma. Le importazioni possono richiedere fino a 30 minuti, a seconda della coda e della dimensione del file.
#### Campi
Gli import di utenti in blocco supportano sia i campi standard che i campi personalizzati nel file di caricamento. **I campi riconoscono le maiuscole e le minuscole.**
{% tabs %}
{% tab title="Campi standard" %}
I campi standard vengono analizzati con la stessa convalida del nostro [chiamata API Open Endpoint User Upsert](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):
| Campo | Tipo | Descrizione |
| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Obbligatorio) | stringa | L'identificatore univoco dell'account a cui appartiene questo partecipante. |
| id (Obbligatorio) | stringa | L'identificatore univoco fornito per questo partecipante. |
| firstName | stringa | Il nome del partecipante. |
| lastName | stringa | Il cognome del partecipante. |
| email | stringa | L'indirizzo email del partecipante. |
| referable | booleano | Flag utilizzato da impact.com per determinare se un partecipante può essere referenziato.
Nota: Il flag deve essere scritto con solo una r perché lo stato venga modificato con successo.
|
| locale | stringa | La localizzazione del partecipante, usata per [Internazionalizzazione](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). La localizzazione deve essere nel formato `lingua_PAese` dove il codice lingua deve essere in minuscolo e il codice paese in maiuscolo. Il separatore deve essere un underscore. |
| countryCode | stringa | La localizzazione del partecipante, usata per [Internazionalizzazione](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). Il codice paese dell'utente (es. CA). |
| referredBy.code | stringa | Il codice di riferimento dell'advocate cliente che ha riferito questo partecipante. |
| referralCodes.{programId} | stringa | Il codice di riferimento vanity per questo partecipante da condividere per il programma specificato (generato automaticamente se non incluso). |
| sharelinks.{programId} | stringa | Il link di condivisione vanity per questo partecipante da condividere per il programma specificato (generato automaticamente se non incluso). |
| dateCreated | stringa | La data in cui questo partecipante è stato creato nel tuo programma Advocate. |
| imageUrl | stringa | Opzionalmente usato in widget, email e temi. Se fornisci un URL assoluto dell'immagine del profilo, la dimensione minima dell'immagine è 80px x 80px. |
| dateUsTaxFormSubmitted | intero | La data in cui il modulo fiscale W-9 di un partecipante è stato contrassegnato come raccolto. Usato per la conformità W-9 sul tuo tenant, se configurato. |
| customFields.{fieldName} | stringa | Usa questa struttura per includere un campo personalizzato a tua scelta. |
| {% endtab %} | | |
{% tab title="Campi personalizzati" %}
[I campi utente personalizzati](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) consentono dati unici per i tuoi partecipanti. Puoi impostare gli obiettivi del tuo programma per attivarsi in base alle informazioni in un campo utente personalizzato.
{% hint style="info" %}
**Esempio**: Premia i partecipanti quando rinnovano l'abbonamento. Per prima cosa, includi il campo personalizzato `customFields.subscriptionPaid` con il valore di **sì**. Quindi, imposta l'obiettivo per convertire quando `customFields.subscriptionPaid` è uguale a **sì**.
{% endhint %}
Aggiungi campi personalizzati all'intestazione della colonna in questo formato: `customFields.nomeDelTuoCampoPersonalizzato`.
{% hint style="info" %}
**Nota:** I campi personalizzati non possono accettare valori di tipo array o oggetto.
{% endhint %}
{% endtab %}
{% endtabs %}
**Risultati**
Ti notifichiamo via email quando la tua importazione è completa. Puoi scaricare i risultati dell'importazione da  **\[Engage] → Reporting → Importazioni & Esportazioni** nella pagina del tuo programma Advocate.
{% hint style="warning" %}
**Avviso:** I link per il download scadranno dopo 30 giorni.
{% endhint %}
{% tabs %}
{% tab title="Caricamento riuscito" %}
Se l'importazione viene completata con successo, verrà generato un file con le informazioni sui partecipanti e inviato via email. Le informazioni incluse in questi risultati sono le stesse presenti nel nostro [report dettagli utenti](https://help.impact.com/brand/it/cosa-vorresti-imparare/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}
{% tab title="Errori" %}
Se si verificano errori durante l'importazione, verrà generato un file aggiuntivo. Questo file di errori include le voci per ogni errore verificatosi, incluso il numero di riga del record (dal file di importazione iniziale) che ha fallito, e i messaggi di errore associati.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | ------------------------------------------------ | ---------------------- | ---------- |
| 2 | Questa richiesta richiede un id valido non vuoto | RICHIESTA\_NON\_VALIDA | 400 |
Nell'improbabile evenienza che si verifichi un errore di sistema e l'importazione venga interrotta, l'importazione apparirà come **annullata** e non verrà recuperata. Contatta il nostro team di Supporto se hai bisogno di ulteriore assistenza.
{% endtab %}
{% endtabs %}