Connettore di uscita Qualtrics

Informazioni sul connettore di uscita Qualtrics

È possibile utilizzare il connettore in uscita Qualtrics per eseguire le attività elencate di seguito.

• Aggiorna i sondaggi Qualtrics esistenti con gli arricchimenti XM Discover.
• Invia i dati di esportazione XM Discover a Qualtrics tramite un evento JSON per attivare un flusso di lavoro Qualtrics.

Contatta il tuo team dell’account Qualtrics se hai bisogno di ulteriore assistenza.

PRIMA DI INIZIARE

Prerequisiti:

Prima di configurare un processo utilizzando il connettore in uscita Qualtrics, assicurarsi che le condizioni elencate di seguito siano soddisfatte.

• I campi dati per gli arricchimenti XM Discover devono far parte del record del sondaggio Qualtrics.
  Suggerimento: per maggiori informazioni sull’aggiunta di campi dati per gli arricchimenti di XM Discover ai tuoi sondaggi, consulta Dati incorporati.
• I documenti in XM Discover devono contenere un campo dati con ID sondaggio quando si utilizza il tipo di connettore in uscita per il sondaggio.

Credenziali richieste:

Avrai bisogno delle seguenti informazioni relative ai tuoi account Qualtrics e XM Discover:

• Il tuo indirizzo di istanza Qualtrics.
• Il tuo token API Qualtrics.
• Il tuo endpoint API di esportazione XM Discover.

ISTITUZIONE DELLA CONNESSIONE

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

Configurazione di un processo del connettore di uscita Qualtrics

Dopo aver configurato la connessione, attenersi alla seguente procedura per configurare un processo.

• Fase 1: fornisci nome job
• Fase 2: specificare progetto e descrizione
• Fase 3: seleziona il tipo di dati Qualtrics
• Fase 4: fornisci le credenziali Qualtrics
• Passaggio 5: imposta le credenziali di esportazione XM Discover
• Passo 6: configurazione query
• Fase 7: Seleziona sondaggio per configurazione (solo per tipo di dati SURVEY) -OR- Specifica l’endpoint dell’evento JSON (solo per il tipo di dati JSON EVENTdata)
• Passo 8: configurazione query in uscita
• Fase 9: Mappa i campi desiderati in Qualtrics
• Fase 10: specificare il filtro (facoltativo) e il limite del record
• Fase 11: configurazione delle notifiche (facoltativo)
• Passo 12: Configura opzioni aggiuntive per il job
• Passo 13: Conferma tutte le impostazioni del job

Fase 1: fornisci nome job

1. Immettere un nome processo riconoscibile nella casella Nome processo nell’angolo in alto a sinistra della pagina.
   Attenzione: il nome immesso nella casella Nome processo verrà aggiunto a tutti i documenti caricati tramite questo processo come valore programmato in maniera fissa per l’attributo job_name.
   Consiglio Q: è possibile modificare il nome del processo durante la configurazione tramite il campo Nome processo visualizzato nella parte superiore di ogni pagina durante la configurazione.
2. Fare clic su Successivo.

Fase 2: specificare progetto e descrizione

1. Nella pagina Specifica progetto e descrizione, selezionare un progetto da cui caricare 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: seleziona il tipo di dati Qualtrics

1. Nella pagina Seleziona tipo di dati Qualtrics, seleziona uno dei seguenti tipi di dati da caricare.
   • Sondaggio: seleziona questo tipo di dati per aggiornare i sondaggi Qualtrics esistenti con gli arricchimenti XM Discover.
   • Evento JSON: seleziona questo tipo di dati per inviare i dati di esportazione XM Discover a Qualtrics tramite un evento JSON per attivare un’attività di automazione xFlow utilizzando gli arricchimenti XM Discover da qualsiasi origine di dati.
     Consiglio Q: per ulteriori informazioni, vedere Evento JSON.
2. Fare clic su Successivo.

Fase 4: fornisci le credenziali Qualtrics

Nella pagina Fornisci credenziali Qualtrics, puoi selezionare una serie di credenziali esistente dal menu a discesa oppure aggiungere una nuova serie di credenziali.

1. Per aggiungere un nuovo insieme di credenziali, selezionare Aggiungi nuovo dal menu a discesa delle credenziali e immettere i parametri di connessione elencati nella tabella seguente nelle caselle corrispondenti.
2. Immettere il nome del nuovo insieme di credenziali nella casella NOME CONNESSIONE.
3. Fornisci il token API connesso al tuo account Qualtrics nella casella TOKEN API QUALTRICS OUTBOUND.
4. Inserire l’indirizzo dell’istanza Qualtrics nella casella QUALTRICS OUTBOUND DATACENTER ID.
5. È possibile impostare la scadenza delle credenziali dopo un determinato periodo di tempo (facoltativo).
6. 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.
7. 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 attivato 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.
8. Selezionare la Data di scadenza dal selettore della data di calendario. La data di scadenza verrà quindi aggiunta alla casella Data di scadenza.
9. Fare clic su Successivo.

Passaggio 5: imposta le credenziali di esportazione XM Discover

1. Nella pagina Configura credenziali di esportazione Discover XM, fornisci il tuo punto finale XM Discover Export API nella casella HOST.
2. Fare clic su Successivo.

Passo 6: configurazione query

Nella pagina Configurazione query, è possibile specificare quali dati utilizzare per aggiornare i sondaggi Qualtrics (se è stato selezionato SURVEY come tipo di dati) o inviare a Qualtrics tramite un evento JSON (se è stato selezionato EVENTO JSON come tipo di dati).

1. Selezionare una delle seguenti opzioni dal menu a discesa Selezionare il livello di dati per scegliere il livello di granularità dei dati associato ai dati in uscita:
   • Frase: Usa dati a livello di frase.
   • Documenti: utilizzare dati a livello di documento.
2. Fornire una query in base alla quale filtrare i dati in uscita nella casella Immettere la query(facoltativo). Utilizzare la stessa sintassi utilizzata per cercare i dati in Designer.
   Esempio: è possibile specificare uno o più ID sondaggio per aggiornare solo i record del sondaggio selezionati utilizzando la seguente sintassi:Surveyid:sv_01
3. Fornire il nome del filtro del progetto da applicare ai dati in uscita nella casella Immettere il nome del filtro(facoltativo).
4. Per aggiornare i record creati dall’ultima esecuzione del job in uscita, selezionare Predefinito: caricare nuovi record in Scegliere i record da recuperare. Per aggiornare i record creati o aggiornati dall’ultima esecuzione del job in uscita, selezionare Carica record nuovi e aggiornati. Per aggiornare solo i record che sono stati aggiornati dall’ultima esecuzione del job in uscita, selezionare Carica record aggiornati.
   Consiglio Q: l’esecuzione o la riesecuzione della categorizzazione aggiorna un record nel sistema XM Discover.
5. È possibile definire quali dati di classificazione includere nei dati in uscita (facoltativo). Selezionare la casella di spunta Tutti i modelli per includere i dati di classificazione per tutti i modelli disponibili nel progetto. Non selezionare la casella di controllo Tutti i modelli se si desidera includere solo i modelli selezionati. Se l’opzione Tutti i modelli non è selezionata, è possibile selezionare modelli specifici da includere nei dati in uscita dal menu di riepilogo a discesa.
6. Selezionare una delle seguenti opzioni dai risultati dei filtri applicando le regole del modello:
   • Ignora: nessun filtro applicato in base ai modelli selezionati.
   • Attualmente classificato: restituisce le frasi/i documenti che sono stati classificati in base ai modelli selezionati durante l’ultima esecuzione di classificazione.
   • Ever Classified: restituisce le frasi/i documenti che sono stati classificati dai modelli selezionati in qualsiasi momento.
7. Selezionare la casella di controllo Se restituire gli ID categoria (true) anziché i nomi delle categorie (false) per utilizzare gli ID categoria anziché i nomi delle categorie (facoltativo).
8. Selezionare i risultati Filtri applicando la query di filtro con tutti i percorsi dei nodi foglia per aggiungere più modelli con il parametro “indicatore solo foglia” alla chiamata API di esportazione (facoltativo).
9. Selezionare Ignora valori vuoti se si desidera che il connettore salti l’aggiornamento di un documento di indagine se tutti i valori in uscita sono vuoti (facoltativo).
10. Fare clic su Successivo.

Fase 7: Seleziona sondaggio per configurazione -OR – Specifica l’endpoint dell’evento JSON

SELEZIONA SONDAGGIO PER CONFIGURAZIONE

1. Seleziona uno dei sondaggi Qualtrics disponibili da aggiornare.
   Consiglio Q: Se non visualizzi il sondaggio che stai cercando, assicurati che sia condiviso con l’account che ha generato la chiave API dall’ambiente Qualtrics.
2. Fare clic su Successivo.

SPECIFICA L’ENDPOINT DELL’EVENTO JSON

1. Specifica l’URL del punto finale dell’evento JSON per inviare i dati di esportazione XM Discover a Qualtrics tramite un evento JSON.
2. Consiglio Q: per ulteriori informazioni sulla configurazione di un evento JSON, consultare Evento JSON.
3. Fare clic su Successivo.

Passo 8: configurazione query in uscita

1. Seleziona l’attributo dal progetto XM Discover che archivia l’ID sondaggio Qualtrics.
   Consiglio Q: verranno aggiornati solo i documenti con ID indagine che corrispondono all’indagine selezionata nella fase precedente.
2. Fare clic su Successivo.

Fase 9: Mappa i campi desiderati in XM Discover

Nella pagina Mappa i campi desiderati in XM Discover, puoi mappare gli attributi di XM Discover e i risultati della classificazione ai campi di dati incorporati definiti in Qualtrics.

1. Fai clic all’interno della casella del campo personalizzato vuoto e seleziona il campo XM Discover che desideri aggiungere a un sondaggio in Qualtrics.
2. Seleziona il tipo di dati di un campo integrato corrispondente creato in XM Engage dal menu a discesa Tipo di dati.
3. Inserisci il nome del campo integrato in XM Engage che dovrebbe essere alimentato con i valori del campo XM Discover selezionato nella casella Nome attributo.
4. Fai clic sull’icona più (+) per aggiungere altri campi personalizzati e mapparli ai campi Qualtrics incorporati, se necessario.
5. Fare clic su Successivo.

Fase 10: 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 11: 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.
   • Nel progetto vengono caricati zero record.
   • Sono stati trovati valori mancanti consecutivi.
   • L’esecuzione di un processo non riesce.
   • L’esecuzione di un processo ha avuto esito parzialmente positivo.
   • Un job termina con un timeout.
   • Un job non riesce.
     Consiglio Q: è possibile selezionare qualsiasi combinazione di notifiche o decidere di non scegliere alcuna notifica. In questo caso, i controlli di un processo non ricevono notifiche.
     Consiglio Q: per ulteriori informazioni sulle impostazioni di configurazione delle notifiche, consultare Notifiche job.
2. Fare clic su Successivo.

Passo 12: Configura opzioni aggiuntive per il job

1. Nella pagina Configura opzioni aggiuntive per il processo, nella sezione Pianifica processo storico/incrementale, selezionare una delle seguenti opzioni:
   • Pianificare esecuzioni incrementali per configurare una pianificazione per le esecuzioni incrementali di dati.
     Consiglio Q: utilizzare l’opzione Crea processo ma non estrarre i dati se si desidera convalidare il processo e le relative impostazioni prima dell’aggiornamento dei dati. Per ulteriori informazioni sulla pianificazione di esecuzioni incrementali, consultare Pianificazione job.
   • Configura pull una tantum per eseguire un recupero di dati una tantum.
     Consiglio Q: è possibile modificare le impostazioni di pianificazione in un secondo momento; consultare Recupero di dati per ulteriori informazioni sulle esecuzioni una tantum e la pianificazione job per ulteriori informazioni sulle esecuzioni regolari.
2. Nella sezione Dati incrementali supplementari, è possibile specificare la quantità di dati supplementari (in giorni o ore) da rilevare durante un’esecuzione incrementale per garantire che tutti i dati storici rilevanti siano disponibili per il trasferimento in uscita (facoltativo).
   Consiglio Q: il valore massimo per questo campo è 30 giorni.
3. Fare clic su Successivo.

Passo 13: 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. 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.
2. 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

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