Aggiunta di contatti della Directory
Cosa puoi trovare in questa pagina
Informazioni sull'aggiunta di contatti della directory
La scheda "Contatti" di TheDirectory contiene tutti i contatti aggiunti alla directory della tua organizzazione. Tutti i contatti aggiunti a una lista di invio vengono inseriti automaticamente in questa directory, ma è anche possibile aggiungere persone direttamente alla directory stessa utilizzando il pulsante “Aggiungi contatti ”.
Consiglio Q: i contatti aggiunti alla directory sono visibili a tutti gli utenti dell'organizzazione che hanno accesso alla directory.
Consiglio Q: quando aggiungi nuovi contatti, assicurati di controllare le impostazioni relative all'unione dei duplicati, che saranno visibili nella finestra di importazione. Queste impostazioni determinano il modo in cui i duplicati vengono identificati e combinati; queste impostazioni possono essere modificate dagli amministratori della directory.
Progetti che possono utilizzare i contatti della Directory XM
Consiglio Q: Le funzioni descritte in questa sezione non sono necessariamente incluse in ogni licenza. Se sei interessato a ottenere l'accesso, ti preghiamo di contattare il tuo Account Executive.
È possibile utilizzare Directory XM per creare elenchi di contatti e inviare inviti per diversi tipi di progetti Qualtrics. Tuttavia, non tutti i tipi di progetto di Qualtrics sono compatibili con la Directory XM.
Directory XM può essere utilizzato per inviare quanto segue:
Consiglio Q: è possibile anche inviare messaggi di posta elettronica senza un collegamento al sondaggio.
Tuttavia, i dati di contatto presenti nella Directory XM sono completamente separati dalle informazioni relative ai dipendenti/partecipanti salvate nella Directory degli impiegati. Ciò significa che i dati modificati in una directory non avranno mai effetto sull'altra. Directory XM non può essere utilizzata per distribuire progetti di Employee Experience (EX), tra cui Engagement, Pulse, 360 e altri.
Campi di contatto disponibili
Sia che tu stia caricando un file CSV o TSV contenente i contatti, sia che tu li stia inserendo manualmente, ci sono alcune informazioni che devi assolutamente includere per i tuoi contatti.
Consiglio q: a seconda di come la directory unisce i duplicati, FirstName, LastName, Email e/o ExternalDataReference possono essere campi obbligatori.
- FirstName: il nome del contatto.
- Lastname: il cognome del contatto.
- E-mail: l'indirizzo e-mail del contatto. Si consiglia di eliminare le duplicazioni da questo campo.
- Riferimento dati esterni: 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 usato per accedere agli autenticatori e configurare il modo in cui la directory unisce i duplicati.
Dati integrati: I dati integrati sono campi aggiuntivi contenenti qualsiasi campo desiderato. Questi non devono seguire una particolare convenzione di denominazione. Nella schermata precedente, Dipartimento, Città e Paese sono tutti dati integrati.
Consiglio Q: I nomi dei dati integrati hanno un massimo di 200 caratteri. I valori devono avere un massimo di 1024 caratteri ciascuno.
- Lingua: una colonna facoltativa che identifica la lingua del contatto utilizzando i codici lingua.
- Telefono: una colonna facoltativa che indica il numero di telefono del contatto. Per i formati di numero di telefono accettati, consultare la pagina di supporto delle Distribuzioni SMS.
Consiglio Q: se includi questi campi nel tuo file, i titoli delle colonne devono corrispondere perfettamente a questi nomi, sia per quanto riguarda le maiuscole che gli spazi. L'unica eccezione è che i dati integrati non sono sensibili alle maiuscole e alle minuscole.
Attenzione: Non modificare i valori della colonna ContactID! Questo campo viene utilizzato per identificare i contatti esistenti. Non è possibile utilizzare ContactID per creare nuovi contatti. Può essere utilizzato solo per aggiornare i contatti esistenti.
Dati relativi alla data e all'ora
Se i dati integrati sono stati salvati in un formato data, è possibile utilizzare un filtro per cercare date future o date recenti. Per effettuare una ricerca per data, il campo della data deve essere in formato ISO-8601, con i tempi in UTC. (cioè, AAAA-MM-DDT-HH:mm:ss+ZZZZ . Ulteriori informazioni su questi simboli sono disponibili nella pagina di supporto della sintassi del formato della data ).
Esempio: Supponiamo che la data sia il 31 marzo 2021 alle 9:00:00AM EDT (UTC-4). Questa data in formato ISO-8601 è 2021-03-21T13:00:00.000Z. Si noti come l'ora sia stata convertita da EDT a UTC.
Caricare un file di contatti della Directory
Assicurati di iniziare dalla scheda “Contatti della rubrica ”.
Fai clic su "Aggiungi contatti dalla directory".
Fai clic su "Carica un file".
In Excel, creare un documento con i campi richiesti e salvarlo come CSV o TSV. In alternativa, clicca su "Scarica un campione di modello", compila le colonne appropriate, aggiungi i dati integrati desiderati e salva il file.
Quando il file è pronto, trascinarlo nell'apposito spazio oppure fare clic su Seleziona un file e selezionare il file dalla cartella.
Consiglio Q: lo strumento di caricamento verificherà la presenza di eventuali problemi nel file, in modo che tu possa correggerli prima che il file venga caricato.
Se lo desideri, modifica il delimitatore e le virgolette.
Fare clic su Successivo.
Valutare le regole per il caricamento dei contatti. Qui verranno visualizzate eventuali regole a livello di directory relative all'unione dei contatti duplicati e all'importazione di valori vuoti. Queste regole sono impostate nelle impostazioni della directory e si applicano ai contatti presenti nel file.
Consiglio Q: L' accessibilità alla scheda Impostazioni directory richiede l'autorizzazione Manage Directory. Rivolgetevi al vostro Brand Administrator se siete interessati ad accedere a questa impostazione.
Valutate i campi del vostro file per verificare 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.
CONSIGLIO Q: se i dati non sono formattati correttamente nell'anteprima (ad esempio, se sono raggruppati anziché suddivisi in colonne), è possibile che non siano separati (o “delimitati”) correttamente. Per risolvere il problema, scegli un delimitatore e/o un carattere di racchiudimento diversi.
Consiglio q: se si carica un contatto con un campo incorporato vuoto in cui è già stato memorizzato un valore, il fatto che il campo venga sovrascritto o lasciato invariato dipende dalle impostazioni della directory.
Consiglio Q: Qualtrics segnalerà i campi di importazione simili ai campi dati integrati presenti nella directory, per evitare la creazione di campi duplicati non necessari. I campi vengono contrassegnati in base all'ortografia o al significato. Ad esempio, se il file di importazione include un campo con l'etichetta "Zip", questo verrà contrassegnato come simile a un campo della directory esistente con l'etichetta "Zip Code".
Fai clic su "Carica file " per caricare i contatti nella tua directory.
Consiglio q: Excel interpreta i caratteri non ASCII (ad esempio, 是 o ñ) in un modo unico che rende difficile il caricamento da parte di Qualtrics. Se importi nomi con caratteri speciali, potresti dover salvare le informazioni del tuo elenco di contatti in un'applicazione di elaborazione di testi (ad esempio: Text-edit per Mac, Notepad per PC) prima di caricare il file in Qualtrics. Per ulteriori istruzioni, consulta la sezione “Problemi relativi ai caratteri speciali ” nella nostra pagina “Problemi relativi al caricamento di file CSV/TSV ”.
Risoluzione dei problemi di importazione dei file di contatto
Con Qualtrics è facile controllare lo stato delle importazioni di contatti e correggere eventuali errori. Durante il processo di caricamento, è possibile che venga visualizzato un avviso se il file è impostato in modo errato. Ti verrà fornita una soluzione e ti sarà impedito di caricare il file finché non sarà stato corretto, garantendo così che i dati della tua directory rimangano puliti e accurati.
Esempio: nella schermata qui sotto, il file è stato bloccato perché il riferimento a dati esterni superava i 100 caratteri. Se correggiamo questo errore, potremo caricare nuovamente il nostro file.
Scaricare il rapporto sullo stato di un’importazione
Forniamo un file riga per riga di ogni contatto e informazioni sulla correttezza dell'importazione. Questo serve come riferimento, in modo che se i contatti non vengono importati, si possa identificare il problema, correggere il file e riprovare.
Consiglio Q: se si importano i contatti in una mailing list specifica, è possibile fare clic sulla casella degli strumenti anche dall'interno della mailing list.
Consiglio Q: a seconda delle dimensioni del caricamento, la generazione del rapporto potrebbe richiedere alcuni istanti.
Di seguito viene riportata una descrizione di ciascun campo del rapporto di errore:
- SourceIndexId: L'indice, o ID riga, del contatto nel file di importazione.
- Email: 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 Fallito.
- ImportStatusCode: Il codice di stato dell'importazione. Per la lista dei codici e il loro significato, si veda la sezione Avanti.
TransactionId: Se applicabile, l'ID transazione del caricamento o dell'aggiornamento del contatto.
Consiglio q: è possibile impostare le transazioni quando si utilizza un flusso di lavoro per l'importazione dei contatti o quando si aggiungono contatti tramite API.
- TransactionStatus: Se applicabile, lo stato della transazione. I valori includono: Aggiunto, Aggiornato e Fallito.
- TransactionStatusCode: Codice di stato della transazione. Per la lista dei codici e il loro significato, si veda la sezione Avanti.
- ImportStatusDescription: Descrizione del problema rilevato. Si veda la sezione avanti per una lista dei codici corrispondenti a ciascuna descrizione.
- ContactListContactId: Se si aggiungono contatti a una mailing list o si crea una nuova lista, l'ID del contatto nella specifica mailing list.
- 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 Fallito.
- ContactListContactStatusCode: Codice di stato del contatto nella lista di invio. Per la lista dei codici e il loro significato, si veda la sezione Avanti.
Errori di file comuni e relativi codici di stato
Di seguito è riportata una lista dei possibili codici di stato e delle relative descrizioni.
Consiglio Q: se si contatta l'assistenza per chiedere aiuto, tenere a portata di mano il file di risoluzione dei problemi.
| Codice stato | Descrizione |
|---|---|
| 0 | Si è verificato un errore sconosciuto; riprovare l'importazione. |
| 1 | Si è verificato un errore sconosciuto; riprovare l'importazione. |
| 10 | Il campo "FirstName " è vuoto o non valido; inserisci un nome valido. |
| 11 | Il campo " contactLastName" è vuoto o non valido; inserisci un cognome valido. |
| 12 | Il valore del contatto per ExternalDataReference è vuoto o non valido; inserire un valore di ExternalDataReference valido. |
| 13 | Il Contatto è vuoto o non valido; inserire un numero di telefono convalidato. |
| 14 | L'indirizzo e-mail di contatto non è valido; inserisci un indirizzo e-mail valido. |
| 15 | Contatto non valido perché la chiave del campo dati integrati supera i 200 caratteri. |
| 16 | Contatto non valido perché il valore del campo dati integrati è superiore a 1024 caratteri. |
| 18 | Il contatto ha un ContactID che esiste in una directory diversa da quella in cui viene importato; cancellare il valore. |
| 19 | Il parametro " contactLanguage " non è valido; inserisci un codice lingua di lunghezza inferiore a 20 caratteri. |
| 20 | Il contatto non è stato creato perché contiene codice eseguibile nelle informazioni di contatto o nei dati integrati. |
| 40 | Il contatto è stato creato con successo. |
| 41 | Il contatto è stato aggiornato con successo. |
| 42 | Il contatto non è stato creato; riprovare l'importazione. |
| 43 | Il contatto non è stato creato; riprovare l'importazione. |
| 44 | Il contatto non è stato creato; riprovare l'importazione. |
| 45 | Il contatto non è stato creato; riprovare l'importazione. |
| 46 | Il contatto non è stato creato; riprovare l'importazione. |
| 47 | Il contatto non è stato creato; riprovare l'importazione. |
| 49 | Si è verificato un errore interno; riprovare la riga non riuscita. Se l'errore persiste, contattare il supporto Qualtrics. |
| 60 | Il contatto è stato aggiunto alla lista di invio con successo. |
| 61 | Il contatto è stato aggiornato con successo nella lista di invio. |
| 62 | Il contatto non è stato aggiunto alla lista di contatti; riprovare l'importazione. |
| 63 | Il contatto non è stato aggiunto all'elenco perché la creazione del contatto non è riuscita |
| 70 | La transazione è stata creata con successo. |
| 71 | L'importazione della transazione non è andata a buon fine: non è stato trovato alcun contatto valido associato alla transazione; si prega di fornire informazioni di contatto valide. |
| 72 | La transazione non è stata creata; riprovare l'importazione. |
| 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 | La creazione della transazione non è riuscita a causa della mancanza della TransactionDate; inserire una data di transazione convalida. |
| 75 | Si è verificato un errore sconosciuto; riprovare l'importazione. |
| 76 | Transazione non valida perché la chiave del campo dati della transazione supera i 200 caratteri. |
| 77 | Transazione non valida a causa del valore del campo dati della transazione superiore a 1024 caratteri. |
| 78 | La transazione non è stata creata perché la creazione del contatto associato non è riuscita. |
Altri suggerimenti per la risoluzione dei problemi
- Ortografia delle intestazioni: Assicuratevi di avere tutte le intestazioni pertinenti. Capitalizzazione, ortografia e spaziatura sono importanti. Lista dei campi predefiniti.
- Intestazioni mancanti: Tutte le colonne devono avere intestazioni.
- Limiti di caratteri: Il vostro file potrebbe avere uno o più campi che superano il limite di caratteri. Valutate i limiti di caratteri indicati di seguito:
- Lingua: 20
- Nome: 100
- Ultimo nome: 100
- Indirizzo e-mail: 254
- Numero di telefono: 20
- Riferimento a dati esterni: 100
- Campo dati INTEGRATI: 200
- Valore dei dati integrati: 1.024
- Valorivuoti: Tenere presente che le impostazioni della directory possono influenzare il trattamento dei valori vuoti. Se stai cercando di aggiornare un contatto e non ottieni il risultato previsto, ciò potrebbe essere dovuto a un'impostazione configurata da un amministratore. Vedere Importazione di valori vuoti nella Directory XM.
- Problemi relativi al formato dei file: se i suggerimenti riportati in questa sezione non hanno risolto il problema, consulta anche la pagina dedicata ai problemi relativi al caricamento di file CSV e TSV.
Inserimento manuale dei contatti della directory
Assicurati di iniziare dalla scheda “Contatti della rubrica ”.
Aggiunta di contatti dalle Intercettazioni digitali
È possibile aggiungere automaticamente i contatti alla propria Directory XM da qualsiasi intercettazioni digitale creata. Ulteriori informazioni su come impostare la creazione automatica di contatti nei progetti di Feedback WEBSITE / APP sono disponibili nella pagina di supporto dell'integrazione della Directory XM con Digital Intercetta.
Prelevare automaticamente i contatti da un'altra piattaforma
È possibile impostare l'estrazione automatica dei contatti da un altro servizio utilizzato (ad esempio SFTP, Qualtrics File Service, Google Drive o altro) in Qualtrics. Scegliete il programma più adatto a voi e al vostro team e lasciate che si svolga da solo.
Per ulteriori informazioni, consulta questa pagina dedicata ai flussi di lavoro della Directory XM.
FAQs
Sembra che il mio file sia stato caricato, ma non vedo nessun contatto nella mia lista in Directory XM. Cosa è successo?
Sembra che il mio file sia stato caricato, ma non vedo nessun contatto nella mia lista in Directory XM. Cosa è successo?
Se non riesci a visualizzare la scheda "Impostazioni directory", rivolgiti al brand administrator.
Il mio file con i contatti della lista di invio/rubrica non si carica affatto su Directory XM. Che succede?
Il mio file con i contatti della lista di invio/rubrica non si carica affatto su Directory XM. Che succede?
Come faccio ad aggiungere a una lista di invio i contatti già presenti nella Directory XM?
Come faccio ad aggiungere a una lista di invio i contatti già presenti nella Directory XM?
Che cos’è Directory XM? / Qual è il pubblico di riferimento?
Che cos’è Directory XM? / Qual è il pubblico di riferimento?
Quando si importano gli aggiornamenti relativi ai contatti esistenti, come vengono gestiti i campi vuoti o lasciati in bianco?
Quando si importano gli aggiornamenti relativi ai contatti esistenti, come vengono gestiti i campi vuoti o lasciati in bianco?
Quando si aggiornano i contatti tramite il caricamento di un file, i campi vuoti (come FirstName, LastName e Riferimento dati esterno) sovrascriveranno i valori esistenti dei contatti presenti nella directory.
Tuttavia, per impostazione predefinita, i dati integrati nei campi dati delle directory non verranno sovrascritti. È possibile scegliere quali campi dati integrati debbano consentire ai valori vuoti di sovrascrivere quelli esistenti modificando le impostazioni della directory. Per ulteriori informazioni, consultare la sezione “Importazione di valori vuoti nella Directory XM ”.
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!