Importa partecipanti Advocate in blocco

Advocate accetta importazioni inviate in .csv o .jsonl formati di file. Fai riferimento al nostro file di importazione CSV di esempio e file di importazione JSONL di esempio per visualizzare la struttura del file richiesta per la tua importazione.

Nota: Consigliamo che ogni importazione non superi le 500.000 voci.

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. [Facoltativo] Per aggiungere o rimuovere i partecipanti importati da un segmento utente specifico, seleziona il segmento dall'elenco a discesa.

Nota: Questa selezione si applica a tutti i partecipanti inclusi in questo file di importazione.

1. Seleziona Avvia importazione.

Al termine dell'importazione, viene inviata un'e-mail di conferma. Le importazioni possono richiedere fino a 30 minuti, a seconda della coda e delle dimensioni del file.

Campi

Le importazioni utenti in blocco supportano sia i campi standard sia i campi personalizzati nel file di caricamento. I campi fanno distinzione tra maiuscole e minuscole.

Campi standard

I campi standard vengono analizzati con la stessa convalida della nostra chiamata API User Upsert di Open Endpoint:

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 e-mail 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 per consentire la modifica corretta dello stato.
locale	stringa	La località del partecipante, usata per l'internazionalizzazione. La località deve avere il 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 località del partecipante, usata per l'internazionalizzazione. 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 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	Utilizzato facoltativamente in widget, e-mail 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 nel tuo tenant, se configurato.
customFields.{fieldName}	stringa	Usa questa struttura per includere un campo personalizzato a tua scelta.

Campi personalizzati

I campi utente personalizzati consentono dati unici per i tuoi partecipanti. Puoi impostare gli obiettivi del tuo programma in modo che si attivino in base alle informazioni presenti in un campo utente personalizzato.

Esempio: Premia i partecipanti quando rinnovano l'abbonamento. Per prima cosa, includi il campo personalizzato customFields.subscriptionPaid con il valore sì. Quindi, imposta l'obiettivo in modo che converta quando customFields.subscriptionPaid è uguale a sì.

Aggiungi i campi personalizzati all'intestazione della colonna in questo formato: customFields.yourCustomFieldName.

Nota: I campi personalizzati non possono accettare valori di tipo array o oggetto.

Risultati

Ti notifichiamo via e-mail quando l'importazione è completa. Puoi scaricare i risultati dell'importazione dalla [Engage] → Reporting → Importazioni ed esportazioni pagina all'interno del tuo programma Advocate.

Avviso: I link per il download scadranno dopo 30 giorni.

Caricamento riuscito

Se l'importazione viene completata con successo, verrà generato e inviato via e-mail un file con le informazioni dei partecipanti. Le informazioni incluse in questi risultati sono le stesse presenti nel nostro report dettagliato degli utenti.

Errori

Se durante l'importazione si verificano errori, verrà generato un file aggiuntivo. Questo file degli errori include le voci per ciascun errore verificatosi, incluso il numero di riga del record (dal file di importazione iniziale) che non è stato elaborato, e tutti i messaggi di errore associati.

numeroRecord	messaggio	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 interrotto e non potrà essere ripristinata. Contatta il nostro team di Supporto se hai bisogno di ulteriore assistenza.