Connettore in entrata Qualtrics

Informazioni sul connettore di entrata Qualtrics

È possibile utilizzare il connettore in entrata Qualtrics per caricare i sondaggi dal proprio account Qualtrics.

Caricamento di dati da un account Qualtrics in XM Discover

Prima di iniziare

Prima di configurare un processo utilizzando il connettore in entrata Qualtrics, assicurarsi di disporre delle seguenti informazioni relative al proprio account Qualtrics:

• Il tuo indirizzo di istanza Qualtrics.
• Il tuo token API Qualtrics.
• Il nome dell’indagine da cui caricare i dati.
  Consiglio Q: Per ulteriori informazioni, consulta la Documentazione API Qualtrics.

Configurazione della connessione

1. Accedere ai connettori.
2. Fare clic sul pulsante Nuova mansione nell’angolo in alto a destra della pagina Processi.
   
3. Nella pagina Connettori, passare alla sezione SELEZIONA UN’ORIGINE.
   
4. Fai clic sul pulsante Qualtrics.
   

Creazione di un processo del connettore in entrata Qualtrics

Dopo aver configurato la connessione, segui questi passaggi per creare sondaggi di caricamento dal tuo account Qualtrics in XM Discover.

• Fase 1: fornisci nome job
• Fase 2: specificare progetto e descrizione
• Fase 3: fornisci le credenziali Qualtrics
• Passaggio 4: Tipo di dati Qualtrics
• Passaggio 5: Mappa i campi desiderati in XM Discover
• Passo 6: Sostituzione e Redazione dei Dati (Facoltativo)
• Passo 7: specificare il filtro (facoltativo) e il limite di record
• Fase 8: notifica e configurazione (facoltativo)
• Fase 9: Configura opzioni aggiuntive per il job
• Passo 10: conferma tutte le impostazioni del job

Consiglio Q: Fare clic sui pulsanti Indietro e Avanti per spostarsi tra le pagine, oppure utilizzare i tasti freccia: SINISTRA per tornare indietro, DESTRA per andare avanti. Per annullare la configurazione, fare clic sul pulsante Annulla.

Fase 1: fornisci nome job

Immettere un nome processo riconoscibile nella casella Nome processo nell’angolo in alto a sinistra della pagina.

Fase 2: specificare progetto e descrizione

1. Nella pagina Specifica progetto e descrizione, selezionare il progetto in cui devono essere caricati i dati dal menu a discesa dei progetti.
   
   Consiglio Q: è possibile inserire una nota relativa al processo nella casella Descrizione lavoro. La descrizione processo immessa nella casella Descrizione processo è accessibile solo nell’elenco Connettori e non viene caricata come parte dei dati di un processo.
2. Fare clic su Successivo.

Fase 3: fornisci le credenziali Qualtrics

1. Nella pagina Fornisci credenziali Qualtrics, puoi selezionare un insieme di credenziali esistente dal menu a discesa.
   
   Consiglio Q: puoi aggiungere una nuova serie di credenziali Qualtrics. Per informazioni sulle nuove credenziali Qualtrics, vedere Aggiunta di nuove credenziali Qualtrics sezione.
2. Fare clic su Successivo.

Fase 4: Tipo di dati Qualtrics

1. Nella pagina Tipo di dati Qualtrics, seleziona 1 delle seguenti opzioni per specificare il tipo di dati da caricare in XM Discover:

• Sondaggio: Carica i dati da uno specifico Qualtrics Vedi la sottosezione Sondaggio qui sotto per maggiori informazioni.
• Gestione reputazione online (ORM): carica recensioni e dati sulla posizione da un progetto Qualtrics Reputation Management. Per ulteriori informazioni, consultare la sottosezione ORM (Online Reputation Management) riportata di seguito.
• Ticket: inserisci i dati dei ticket da Qualtrics Engage. Per ulteriori informazioni, consultare la sottosezione Ticket di seguito.
  

2. Fare clic su Successivo.

Sondaggio

1. Se selezioni Sondaggio, verrai reindirizzato alla pagina Seleziona sondaggio per configurazione, in cui puoi selezionare 1 dei sondaggi Qualtrics disponibili da cui caricare i dati.
   
   Consiglio Q: se non vedi il sondaggio che stai cercando, assicurati che sia condiviso con l’account che ha generato la chiave API dall’ambiente Qualtrics.
2. Se sono disponibili filtri per il sondaggio selezionato, selezionare 1 dei filtri Qualtrics dal menu (facoltativo). Per ulteriori informazioni, consultare Filtro delle risposte.
   
3. Selezionare la casella di spunta Recupera risposte “In corso” se si desidera includere le risposte non completate nel caricamento. Non selezionare questa casella di spunta se si intende rilevare solo le risposte completate.
   
   Consiglio Q: è possibile aggiornare la configurazione delle query dopo la creazione del processo.

Gestione reputazione online (ORM)

Se si seleziona Online Reputation Management (ORM), si verrà indirizzati alla pagina Specifica ID insieme di dati ORM in cui è possibile immettere l’idpSourceId per il progetto di dati importato nella casella ID origine IDP.

Ticket

Se si seleziona Tickets, si verrà indirizzati a Mappa i campi desiderati in XM Discover pagina in cui puoi collegare i campi dati sorgente ai campi dati nel tuo progetto XM Discover.

Passaggio 5: Mappa i campi desiderati in XM Discover

1. Nella pagina Mappa i campi desiderati in XM Discover, seleziona la scheda MAPPATURA ORIGINE per collegare i campi dati sorgente ai campi dati nel tuo progetto XM Discover.
   
2. Nella sezione Mappatura sorgente predefinita, configura i campi dati predefiniti che tutti i documenti in XM Discover condividono. Per informazioni sul mappaggio sorgente predefinito, vedere Mappaggio sorgente predefinito sezione.
3. Nella sezione Mappaggio sorgente, configurare eventuali campi dati supplementari dal file.
   
   Consiglio Q: per ulteriori informazioni sulla mappatura dei dati, consultare Configurazione della mappatura dei dati.
4. Fare clic su Successivo.

Passo 6: Sostituzione e Redazione dei Dati (Facoltativo)

1. Nella pagina Data Substitution and Redaction, è possibile fornire regole di sostituzione e oscuramento per nascondere i dati sensibili o sostituire automaticamente determinate parole e frasi nel feedback e nelle interazioni dei clienti.
   
   Qtip: Per ulteriori informazioni sulla sostituzione e l’oscuramento dei dati, consultare Sostituzione dei dati e Redazione.
2. Fare clic su Successivo.

Fase 7: specificare il filtro (facoltativo) e il limite del record

1. Nella pagina Specifica filtro, è possibile definire una condizione di filtro per un processo per caricare solo i record che lo soddisfano (facoltativo).
   
   Consiglio Q: Per ulteriori informazioni sull’applicazione di un filtro, vedere Filtro connettore.
2. È possibile specificare un limite di record nella casella Specifica limite record. In alternativa, è possibile lasciare il limite di record come valore predefinito Tutti se si desidera che tutti i record vengano restituiti in un unico push.
   Qtip: Il limite di registrazione è un limite per ogni esecuzione del job. Se lo imposti su 1.000, il job verrà eseguito in base alla pianificazione impostata e si arresterà dopo aver estratto 1.000 record. Se lo si imposta su giornaliero, ciò significa che verrà eseguito una volta al giorno e si otterranno fino a 1.000 record per ogni giorno.
   Consiglio Q: Per i dati conversazionali, il limite viene applicato in base alle conversazioni piuttosto che alle righe.
3. Fare clic su Successivo.

Fase 8: configurazione delle notifiche (facoltativo)

1. Nella pagina Configurazione notifiche, è possibile selezionare le notifiche che gli osservatori di un processo devono ricevere se si verifica uno degli eventi elencati di seguito.

• Notificare quando vengono caricati zero record nel progetto.
• Notificare quando vengono trovati valori mancanti consecutivi.
• Notificare quando l’esecuzione del processo non riesce.
• Invia una notifica quando l’esecuzione del job riesce parzialmente.
• Notificare quando il job termina con un timeout.
• Invia una notifica al supporto quando questo processo non riesce.
  

2. Fare clic su Successivo.

Fase 9: Configura opzioni aggiuntive per il job

1. Nella pagina Configura opzioni supplementari per job, nella sezione Gestione di documenti nuovi ed esistenti, scegliere il modo in cui il sistema deve gestire i documenti duplicati selezionando una delle seguenti caselle di controllo nella sezione Gestione di documenti nuovi ed esistenti:
   • Rifiutare duplicati per documenti esistenti e creare nuovi record per nuovi documenti
   • Aggiornare attributi strutturati per documenti esistenti e creare nuovi record per nuovi documenti
   • Aggiornare attributi strutturati per documenti esistenti e non creare record per nuovi documenti
     
     Attenzione: ogni documento deve avere un ID naturale univoco in modo che il sistema possa gestire documenti duplicati con ID naturali identici.

2. Nella pagina Configura opzioni supplementari per job, nella sezione Pianifica job storico/incrementale, selezionare 1 delle seguenti opzioni:

• Pianificare esecuzioni incrementali per configurare una pianificazione per le esecuzioni incrementali di dati.
  Consiglio Q: per ulteriori informazioni sulla pianificazione di esecuzioni incrementali, consultare Pianificazione job.
• Configura pull una tantum per eseguire un recupero di dati una tantum.
  

3. Fare clic su Successivo.
   

Passo 10: conferma tutte le impostazioni del job

1. Nella pagina Conferma tutte le impostazioni processo, è possibile visualizzare un riepilogo di tutte le impostazioni di un processo e modificarle, se necessario, prima di eseguire il caricamento dei dati.
   
2. Per eseguire l’upload dei dati, fare clic sul pulsante Concludere quando si è pronti per eseguire l’upload dei dati. Verrà visualizzato un messaggio di conferma che conferma che il processo è stato inviato correttamente.

Quando si fa clic su Fine, si verifica quanto segue: I pull una tantum vengono eseguiti immediatamente. A meno che non sia stata attivata l’opzione “Crea job ma non estrarre dati”, i pull pianificati vengono eseguiti immediatamente, quindi impostati per l’esecuzione in base alla pianificazione definita.

Per ulteriori informazioni sul monitoraggio dei job, consultare Riepilogo pagina dei job.

Aggiunta di nuove credenziali Qualtrics

1. Per aggiungere un nuovo insieme di credenziali, selezionare Aggiungi Nuovo dal menu delle credenziali.
   
2. Immettere il nome del nuovo insieme di credenziali nella casella NOME CONNESSIONE.
   
3. Fornisci il tuo ID datacenter Qualtrics nella casella QUALTRICS DATACENTER ID.
   Consiglio Q: Per informazioni su come trovare il tuo datacenter, leggi la sezione Locating your Datacenter ID nella pagina Finding Qualtrics ID.
4. Fornisci il token API per il tuo account Qualtrics nella casella ARGOMENTI API QUALTRICS.
   Consiglio Q: Per sapere come trovare un token API Qualtrics, consulta Autenticazione token API.
5. È possibile impostare la scadenza delle credenziali dopo un determinato periodo di tempo (facoltativo). Per definire una data di scadenza per questo set di credenziali e impostare un promemoria per tutti gli osservatori job, selezionare la casella di spunta Invia notifiche di scadenza. In questo modo viene attivata la casella Giorni prima della scadenza.
   
6. Immettere un valore nella casella Giorni prima della scadenza per impostare quanti giorni prima della scadenza devono iniziare le notifiche. I valori possibili sono compresi tra 1 e 100 giorni.
   Consiglio Q: questo promemoria viene avviato ogni volta che il processo viene eseguito una volta che la data di scadenza è inferiore al numero di giorni impostato nella casella Giorni prima della scadenza.
7. Selezionare la Data di scadenza dal selettore della data di calendario. La data di scadenza verrà quindi aggiunta alla casella Data di scadenza.

Mappaggio sorgente predefinito

Queste sono le opzioni dei campi dati predefinite per il connettore in entrata Qualtrics:

1. natural_id: l’ID naturale funge da identificatore univoco di un documento e consente la corretta elaborazione di documenti duplicati. Per l’ID naturale, XM Discover utilizza gli ID sorgente preceduti dal nome del connettore tramite una trasformazione personalizzata: ID naturale = nome connettore;ID sorgente
   
2. document_date: Document Date è il campo data principale associato a un documento. Questa data viene utilizzata in XM Discover per report, tendenze, avvisi e così via. Per Data documento, selezionare 1 delle seguenti opzioni:

• endDate (predefinito): la data e l’ora in cui il partecipante ha inviato il sondaggio. Se la voce è una risposta parziale, questa data indicherà l’ultima volta in cui l’intervistato ha interagito con il sondaggio.
  
• startDate: la data e l’ora in cui il partecipante ha fatto clic sul collegamento del sondaggio per la prima volta.
• recordedDate: questo è un record di quando una risposta al sondaggio è stata avviata, inviata o aggiornata in Qualtrics.
  Consiglio Q: se i dati di origine contengono altri campi data, è possibile impostarne 1 come Data documento selezionandolo nella colonna Nome campo.
  

3. job_name: il nome del job consente di identificare i dati in base al nome del job utilizzato per caricarli. È possibile modificare il valore di questo attributo durante la configurazione tramite il campo Nome job visualizzato nella parte superiore di ogni pagina durante la configurazione.
4. loadDate: la data di caricamento indica quando un documento è stato caricato in XM Discover. Questo campo viene impostato automaticamente.
5. feedback_provider: il provider di feedback consente di identificare i dati ottenuti da un fornitore specifico. Per i documenti Qualtrics, il valore di questo attributo è impostato su Qualtrics.
6. feedback_type: Il tipo di feedback ti aiuta a identificare i dati in base al suo tipo. Ciò è utile per il reporting quando il progetto contiene diversi tipi di dati (ad esempio, questionari e feedback sui social media). Per i documenti Qualtrics, il valore di questo attributo è impostato su Sondaggio.
7. Origine: consente di identificare i dati ottenuti da un’origine specifica. Può trattarsi di qualsiasi elemento che descriva l’origine dei dati, ad esempio il nome di un’indagine o di una campagna di marketing mobile. Per impostazione predefinita, il valore di questo attributo è impostato su Qualtrics, ma è possibile fornire il proprio valore nella colonna Valore programmato in maniera fissa.