> 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/import-advocate-participants-in-bulk.md).
# Importa partecipanti Advocate in blocco
Advocate accetta importazioni inviate in `.csv` o `.jsonl` formati di file. Si prega di fare riferimento al nostro [file CSV di esempio per l'importazione](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) e [file JSONL di esempio 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:** Consigliamo che ogni importazione non superi le 500.000 voci.
{% endhint %}
#### Importa i 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 utente specifico, seleziona il segmento dall'elenco 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 delle dimensioni del file.
#### Campi
Le importazioni di utenti in blocco supportano sia i campi standard sia i campi personalizzati nel file caricato. **I campi sono sensibili alle maiuscole e minuscole.**
{% tabs %}
{% tab title="Campi standard" %}
I campi standard vengono analizzati con la stessa convalida della nostra [Chiamata API Open Endpoint User Upsert](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):
| Campo | Tipo | Descrizione |
| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Obbligatorio) | stringa | L'identificativo univoco dell'account a cui appartiene questo partecipante. |
| id (Obbligatorio) | stringa | L'identificativo 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 usato da impact.com per determinare se un partecipante può essere referenziato.
Nota: Il flag deve essere scritto con solo una r affinché lo stato possa essere modificato correttamente.
|
| locale | stringa | La localizzazione del partecipante, usata per [Internazionalizzazione](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). La localizzazione deve essere nel formato `lingua_PAESE` dove il codice della lingua deve essere in minuscolo e il codice del paese in maiuscolo. Il separatore deve essere un trattino basso. |
| countryCode | stringa | La localizzazione del partecipante, usata per [Internazionalizzazione](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Il codice paese dell'utente (ad es. CA). |
| referredBy.code | stringa | Il codice di referral del customer advocate che ha segnalato questo partecipante. |
| referralCodes.{programId} | stringa | Il codice referral personalizzato per questo partecipante da condividere per il programma specificato (generato automaticamente se non incluso). |
| sharelinks.{programId} | stringa | Il link di condivisione personalizzato 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 | Usato facoltativamente in widget, email e temi. Se fornisci un URL assoluto dell'immagine del profilo, la dimensione minima dell'immagine è 80 px x 80 px. |
| dateUsTaxFormSubmitted | intero | La data in cui il modulo fiscale W-9 di un partecipante è stato contrassegnato come raccolto. Usato per la conformità W-9 nel tuo tenant, se configurata. |
| customFields.{fieldName} | stringa | Usa questa struttura per includere un campo personalizzato a tua scelta. |
| {% endtab %} | | |
{% tab title="Campi personalizzati" %}
[Campi utente personalizzati](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) consentono dati unici per i tuoi partecipanti. Puoi impostare gli obiettivi del tuo programma in modo che si attivino in base alle informazioni in un campo utente personalizzato.
{% hint style="info" %}
**Esempio**: Ricompensa i partecipanti quando rinnovano l'iscrizione al loro abbonamento. Per prima cosa, includi il campo personalizzato `customFields.subscriptionPaid` con il valore di **sì**. Quindi, imposta l'obiettivo in modo che si converta quando `customFields.subscriptionPaid` è uguale a **sì**.
{% endhint %}
Aggiungi i campi personalizzati all'intestazione della colonna in questo formato: `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Nota:** I campi personalizzati non possono accettare valori di array o oggetto.
{% endhint %}
{% endtab %}
{% endtabs %}
**Risultati**
Ti avvisiamo via email quando la tua importazione è completa. Puoi scaricare i risultati dell'importazione dalla  **\[Engage] → Reportistica → Importazioni ed esportazioni** pagina nel tuo programma Advocate.
{% hint style="warning" %}
**Attenzione:** I link di download scadranno dopo 30 giorni.
{% endhint %}
{% tabs %}
{% tab title="Caricamento riuscito" %}
Se l'importazione viene completata correttamente, verrà generato un file con le informazioni del partecipante e ti verrà inviato via email. Le informazioni incluse in questi risultati sono le stesse che si trovano nel nostro [report sui dettagli utente](/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="Errori" %}
Se durante l'importazione si verificano errori, verrà generato un file aggiuntivo. Questo file degli errori include voci per ciascun errore verificatosi, incluso il numero di riga del record (dal file di importazione iniziale) che non è andato a buon fine e qualsiasi messaggio di errore associato.
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | -------------------------------------------------- | ------------ | ---------- |
| 2 | Questa richiesta richiede un id valido e non vuoto | BAD\_REQUEST | 400 |
Nell'improbabile caso in cui si verifichi un errore di sistema e l'importazione venga interrotta, l'importazione apparirà come **interrotta** e non si riprenderà. Contatta il nostro team di supporto se hai bisogno di ulteriore assistenza.
{% 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/import-advocate-participants-in-bulk.md?ask=&goal=
```
`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.