Aggiunta di contatti directory
Informazioni sull’aggiunta di contatti della directory
La scheda Contatti directory contiene tutti i contatti aggiunti alla directory della tua organizzazione. Qualsiasi contatto aggiunto a una lista di invio viene aggiunto automaticamente a questa directory, ma puoi anche aggiungere persone direttamente alla directory utilizzando il pulsante Aggiungi contatti della directory.
Progetti che possono utilizzare i contatti della directory XM
Puoi utilizzare la directory XM per creare elenchi di contatti e inviare inviti per diversi tipi di progetti Qualtrics. Tuttavia, non tutti i tipi di progetto Qualtrics sono compatibili con la Directory XM.
La directory XM può essere utilizzata per inviare quanto segue:
Tuttavia, i dati di contatto della directory XM sono completamente separati dalle informazioni sul dipendente/partecipante salvate nella directory dei dipendenti. Ciò significa che i dati modificati in una directory non influenzeranno mai l’altra. La Directory XM non può essere utilizzata per distribuire progetti Employee Experience (EX), tra cui Engagement, Pulse, 360 e altro.
Campi di contatto disponibili
Che tu stia caricando un CSV o un TSV di contatti o li stia digitando manualmente, ci sono alcune informazioni che devi includere per i tuoi contatti.
- Nome: nome del contatto.
- Cognome: il cognome del contatto.
- E-mail: l’indirizzo e-mail del contatto. Si consiglia di unire i duplicati da questo campo.
- ExternalDataReference: informazioni aggiuntive sul contatto. Questo viene utilizzato più spesso per memorizzare dati come nel caso dell’ID di un dipendente o di uno studente. Può essere utilizzato per accedere agli autenticatori e configurare il modo in cui la directory unisce i duplicati.
- Dati incorporati: i dati incorporati sono campi aggiuntivi contenenti qualsiasi campo desideri. Questi non devono necessariamente seguire una determinata regola di attribuzione nomi. Nella schermata precedente, Reparto, Città e Paese sono tutti dati incorporati.
Qtip: i nomi dei dati integrati hanno un massimo di 200 caratteri. I valori devono avere un massimo di 1024 caratteri ciascuno.Avviso: in precedenza tutti i campi dati incorporati facevano distinzione tra maiuscole e minuscole. Per la stragrande maggioranza degli utenti, i dati incorporati non fanno più distinzione tra maiuscole e minuscole, il che significa che “test” e “test” verranno trattati come lo stesso campo. Tuttavia, come procedura consigliata, si consiglia comunque di fare attenzione all’uso di maiuscole e minuscole, poiché esiste una piccola parte di account in cui questa modifica non è stata apportata.Attenzione: non utilizzare Punti come campo dati incorporati perché è un campo riservato nella directory XM. Inoltre, non utilizzare nessuno degli altri campi predefiniti di Qualtrics.
- Lingua: una colonna facoltativa che identifica la lingua del contatto utilizzando i codici lingua.
- Telefono: colonna facoltativa che identifica il numero di telefono del contatto. Consulta la pagina di supporto Distribuzioni SMS per i formati di numero di telefono accettati.
Dati data e ora
Se i dati incorporati sono stati salvati in un formato data, è possibile utilizzare un filtro per cercare date future o date verificatesi di recente. Per cercare in base alla data, il campo data deve essere nel formato ISO-8601, con le ore in UTC. (ad es. AAAA-MM-GGT-HH:mm:ss+ZZZZ. Per ulteriori informazioni su questi simboli, consultare la pagina di supporto Sintassi formato data).
Carica un file
- Fai clic su Aggiungi contatti directory.
- Fare clic su Carica un file.
- In Excel, creare un documento con i campi richiesti e salvarlo come CSV o TSV. In alternativa, fare clic su Scarica un modello di esempio, compilare le colonne appropriate, aggiungere eventuali dati incorporati desiderati e salvare il file.
- Quando il file è pronto, trascinarlo e rilasciarlo nello spazio disponibile oppure fare clic su Seleziona un file e selezionare il file dalla cartella.
- Fare clic su Successivo.
- Rivedere le condizioni di importazione del contatto. Tutte le regole a livello di directory per unire i contatti duplicati verranno visualizzate qui. Queste regole sono configurate nelle impostazioni della directory e si applicheranno ai contatti nel file.
Qtip: l’accesso alla scheda Impostazioni directory richiede l’autorizzazione di gestione directory. Parla con il tuo amministratore del brand se sei interessato ad accedere a questa impostazione. - Esaminare i campi nel file per assicurarsi che le informazioni siano corrette. Se un campo non è stato riconosciuto correttamente, fai clic sul nome del campo per visualizzare un menu a discesa delle opzioni e seleziona il campo corretto.
Qtip: se i dati non sono formattati correttamente nell’anteprima (ad esempio, raggruppati anziché divisi in colonne), i dati potrebbero non essere separati (o “delimitati”) correttamente. Per risolvere il problema, selezionare il link blu Mostra opzioni e scegliere un Delimitatore e/o un Inclusione diversi.Qtip: se un contatto viene caricato con un campo incorporato vuoto che ha già un valore archiviato in quel campo, il campo non verrà sovrascritto e il valore corrente verrà mantenuto.
- Fai clic su Carica il file per caricare i contatti nella tua directory.
Risoluzione dei problemi relativi alle importazioni di file
Con Qualtrics è facile controllare lo stato delle importazioni dei tuoi contatti e correggere eventuali errori che si sono verificati. Viene fornito un file riga per riga di ciascun contatto e le informazioni che indicano se è stato importato correttamente. Questo funge da riferimento in modo che se i contatti non vengono importati, è possibile identificare il problema, correggere il file e riprovare.
Per ottenere uno stato dettagliato dell’importazione:
- Dopo aver caricato il tuo file, fai clic sull’icona del toolbox nell’angolo in alto a destra della scheda Contatti directory.
Qtip: se importi i contatti in una specifica lista di invio, puoi fare clic sulla casella degli strumenti anche dall’interno della lista di invio. - Fare clic su Visualizza dettagli importazione.
- Rivedere il riepilogo dell’importazione. Questo includerà il numero di contatti creati, il numero di contatti aggiornati e il numero di contatti che non è stato possibile importare. Inoltre, all’importazione verrà assegnato un ID avanzamento, utile per avere a disposizione se è necessario contattare il supporto Qualtrics.
- Per scaricare il file del rapporto errori, fare clic su Scaricare un report.
Suggerimento Q: a seconda delle dimensioni del caricamento, la generazione del rapporto potrebbe richiedere alcuni minuti. - Aprire il file in un editor di fogli elettronici nel computer e rivedere il file per eventuali contatti non riusciti. La colonna più utile per identificare i contatti non riusciti è la colonna ImportStatus. Di seguito sono riportate ulteriori informazioni su ogni colonna.
Campi report errori
Di seguito è riportata la descrizione di ciascun campo del report errori:
- SourceIndexId: l’ID di indice o di riga del contatto nel file di importazione.
- E-mail: l’indirizzo e-mail associato al contatto.
- ContactId: l’ID del contatto nella directory.
- ImportStatus: lo stato di importazione del contatto. I valori includono: Aggiunto, Aggiornato e Non riuscito.
- ImportStatusCode: il codice stato per l’importazione. Consultare la sezione successiva per un elenco di codici e relativi significati.
- ID transazione: se applicabile, l’ID transazione del contatto caricato o aggiornato.
Consiglio Q: è possibile configurare transazioni quando si utilizza un’automazione di importazione contatti o quando si aggiungono contatti tramite API.
- TransactionStatus: se applicabile, lo stato della transazione. I valori includono: Aggiunto, Aggiornato e Non riuscito.
- TransactionStatusCode: il codice di stato per la transazione. Consultare la sezione successiva per un elenco di codici e relativi significati.
- ContactListContactId: se si aggiungono contatti a una lista di invio o si crea una nuova lista, l’ID del contatto nella lista di invio specifica.
- ContactListContactStatus: se si aggiungono contatti a una lista di invio o si crea una nuova lista, lo stato dell’aggiunta o dell’aggiornamento. I valori includono: Aggiunto, Aggiornato e Non riuscito.
- ContactListContactStatusCode: codice stato del contatto nella lista di invio. Consultare la sezione successiva per un elenco di codici e relativi significati.
Codici stato
Di seguito è riportato un elenco dei possibili codici stato e relative descrizioni.
Qtip: se si contatta il supporto per assistenza, il file di risoluzione dei problemi è utile.
Codice stato | Descrizione |
0 | Si è verificato un errore sconosciuto; contatta Qualtrics per assistenza. |
1 | Si è verificato un errore sconosciuto; contatta Qualtrics per assistenza. |
10 | Il nome del contatto è vuoto o non valido; inserire un nome valido. |
11 | Il cognome del contatto è vuoto o non valido; inserisci un cognome valido. |
12 | Il valore del contatto per ExternalDataReference è vuoto o non valido; inserire un valore ExternalDataReference valido. |
13 | Il numero di telefono del contatto è vuoto o non valido; inserisci un numero di telefono valido. |
14 | L’indirizzo e-mail del contatto non è valido; inserisci un indirizzo e-mail valido. |
15 | Contatto non valido perché la chiave del campo dati incorporati supera i 200 caratteri. |
16 | Contatto non valido perché il valore del campo dati incorporato supera i 1024 caratteri. |
18 | Il contatto ha un ContactID che esiste in una directory diversa da quella in cui si sta importando; cancellare il valore. |
19 | Lingua del contatto non valida; inserire un codice lingua che contenga meno di 20 caratteri. |
40 | Il contatto è stato creato correttamente. |
41 | Il contatto è stato aggiornato correttamente. |
42 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
43 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
44 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
45 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
46 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
47 | Il contatto non è stato creato; contattare Qualtrics per assistenza. |
60 | Il contatto è stato aggiunto correttamente alla lista di invio. |
61 | Il contatto è stato aggiornato correttamente nella lista di invio. |
62 | Il contatto non è stato aggiunto alla lista di invio; contattare Qualtrics per assistenza. |
63 | Il contatto non è stato aggiunto alla lista perché la creazione del contatto non è riuscita |
70 | La transazione è stata creata correttamente. |
71 | Importazione della transazione non riuscita: nessun contatto valido associato alla transazione; fornire informazioni di contatto valide. |
72 | La transazione non è stata creata; contattare Qualtrics per assistenza. |
73 | La creazione della transazione non è riuscita perché ContactId o ContactListContactId non sono stati trovati nella directory; inserire un ContactId e un ContactListContactId validi. |
74 | Creazione della transazione non riuscita a causa di TransactionDate mancante; inserire una data transazione valida. |
75 | Si è verificato un errore sconosciuto; contatta Qualtrics per assistenza. |
76 | Transazione non valida perché la chiave del campo dati di movimento supera i 200 caratteri. |
77 | Transazione non valida perché il valore del campo dati della transazione supera i 1024 caratteri. |
78 | La transazione non è stata creata perché la creazione del contatto associato non è riuscita; contattare Qualtrics per assistenza. |
Risoluzione dei problemi relativi ad altri errori
- Il file ha uno o più campi che superano il limite di caratteri. Rivedere i limiti di caratteri riportati di seguito:
- Lingua: 20
- Nome: 100
- Cognome: 100
- Indirizzo e-mail: 254
- Numero di telefono: 20
- Riferimento esterno: 100
- Campo dati incorporati: 200
- Valore dei dati incorporati: 1.024
Inserimento manuale
- Fai clic su Aggiungi contatti directory.
- Selezionare Inserimento manuale.
- Rivedere le condizioni di importazione del contatto. Tutte le regole a livello di directory per unire i contatti duplicati verranno visualizzate qui. Queste regole sono configurate nelle impostazioni della directory e si applicheranno ai contatti inseriti.
- Compilare i campi disponibili. È possibile digitare o copiare e incollare le informazioni di contatto.
- Fare clic sul segno più (+) per aggiungere una colonna supplementare per i dati incorporati. Ricordatevi, questi possono essere quello che volete.
- Fare clic su Avanti per caricare i contatti.
Aggiunta di contatti da intercettazioni digitali
Puoi aggiungere automaticamente i contatti alla tua Directory XM da qualsiasi intercettazione digitale che tu abbia creato. Maggiori informazioni su come impostare la creazione automatica di contatti nei progetti feedback website / app sono disponibili sulla pagina di supporto Integrazione Directory XM con Digital Intercepts.