Importa in blocco i partecipanti di Advocate
Advocate accetta importazioni inviate in .csv o .jsonl formati di file. Ti preghiamo di consultare il nostro file CSV di importazione di esempio e file JSONL di importazione di esempio per visualizzare la struttura file richiesta per la tua importazione.
Nota: Consigliamo che ogni importazione non superi 500.000 voci.
Importa i partecipanti in blocco
Dal menu di navigazione a sinistra, seleziona
[Engage] → Partecipanti.
Seleziona Importa utenti.
Sotto Tipo di importazione, seleziona Utenti.
Aggiungi il tuo file di importazione selezionando Seleziona file.
[Facoltativo] Per aggiungere o rimuovere i partecipanti importati da uno specifico segmento utente, seleziona il segmento dall'elenco a discesa.
Nota: Questa selezione si applica a tutti i partecipanti inclusi in questo file di importazione.
Seleziona Avvia importazione.
Al termine dell'importazione, viene inviata un'email di conferma. Le importazioni possono richiedere fino a 30 minuti, a seconda della coda e della dimensione del file.
tabella Campi
Le importazioni massicce di utenti supportano sia i campi standard sia i campi personalizzati nel file caricato. I campi distinguono tra maiuscole e minuscole.
I campi standard vengono analizzati con la stessa convalida della nostra chiamata API Open Endpoint User Upsert:
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.
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 correttamente.
locale
stringa
La localizzazione del partecipante, utilizzata per l'internazionalizzazione. La localizzazione deve avere il formato language_COUNTRY in cui il codice della lingua deve essere in minuscolo e il codice del paese deve essere in maiuscolo. Il separatore deve essere un trattino basso.
countryCode
stringa
La localizzazione del partecipante, utilizzata per l'internazionalizzazione. Il codice paese dell'utente (ad es. CA).
referredBy.code
stringa
Il codice 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, 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. Utilizzato per la conformità W-9 sul tuo tenant, se configurato.
customFields.{fieldName}
stringa
Usa questa struttura per includere un campo personalizzato a tua scelta.
I campi utente personalizzati consentono dati unici per i tuoi partecipanti. Puoi impostare gli obiettivi del tuo programma in modo che vengano attivati in base alle informazioni contenute 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 si converta quando customFields.subscriptionPaid è uguale a sì.
Aggiungi campi personalizzati all'intestazione della colonna in questo formato: customFields.yourCustomFieldName.
Nota: I campi personalizzati non possono accettare valori array o oggetto.
Risultati
Ti notificheremo via email quando l'importazione sarà completata. Puoi scaricare i risultati dell'importazione dalla pagina [Engage] → Reporting → Importazioni ed esportazioni all'interno del tuo programma Advocate.
Avviso: I link per il download scadranno dopo 30 giorni.
Se l'importazione viene completata con successo, verrà generato e inviato via email un file con le informazioni del partecipante. Le informazioni incluse in questi risultati sono le stesse presenti nel nostro report dei dettagli dell'utente.
Se durante l'importazione vengono riscontrati errori, verrà generato un file aggiuntivo. Questo file degli errori include voci per ogni errore verificatosi, inclusi il numero di riga del record (dal file di importazione iniziale) che non è riuscito e tutti gli eventuali messaggi di errore associati.
2
Questa richiesta richiede un id valido 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à. Ti preghiamo di contattare il nostro team di supporto se hai bisogno di ulteriore assistenza.
Ultimo aggiornamento
È stato utile?

