Modello di articolo

Informazioni sul connettore in uscita di Qualtrics

Il connettore in uscita di Qualtrics consente di eseguire le seguenti performance nel proprio account di Qualtrics:

• Trigger un evento JSON del flusso di lavoro e utilizzare i dati XM Discover nei flussi di lavoro di Qualtrics.
• Esportare le risposte con gli arricchimenti di XM Discover da XM Discover e importarle in un set di dati di sondaggio di Qualtrics.

Requisiti

Prima di impostare la connessione, sono necessarie le seguenti informazioni dal vostro account Qualtrics:

• L’ID del datacenter di Qualtrics.
• Il vostro token API di Qualtrics .
• L’endpoint dell’API XM Discover Export.

Lavori su eventi JSON

Per triggerare un evento JSON con il Connettore in uscita di Qualtrics, è necessario l’endpoint dell’evento JSON. È possibile copiare l’endpoint facendo clic su Copia URL durante la modifica dell’evento JSON nel flusso di lavoro di Qualtrics.

Esportazione Risposte Lavoro

Se si esportano le risposte in un set di dati di un sondaggio di Qualtrics, è necessario assicurarsi che i dati soddisfino i seguenti requisiti:

• Il dataset del sondaggio deve avere campi corrispondenti agli arricchimenti XM Discover che si desidera esportare. Se questi campi non esistono, è possibile aggiungerli come dati integrati o crearli con campi personalizzati.
• I documenti esportati da XM Discover devono avere un campo che corrisponde all’ID del sondaggio in cui si desidera importare le risposte.

Creazione di un lavoro del connettore in uscita di Qualtrics

1. Nella pagina Lavori, fare clic su Nuovo lavoro.
   
2. Selezionare il connettore Qualtrics Outbound.
   
3. Date un nome al vostro lavoro per poterlo identificare.
   
4. Scegliere il progetto in cui caricare i dati.
5. Date al vostro lavoro una descrizione, in modo da conoscerne lo scopo.
6. Fare clic su Successivo.
7. Scegliete il tipo di dati di Qualtrics che desiderate esportare:
   
   • Sondaggio: Esportazione dei dati delle risposte per importarli in un set di dati del sondaggio.
   • Evento JSON: Esportazione di dati per attivare un flusso di lavoro JSON.
8. Fare clic su Successivo.
9. Utilizzate il menu a tendina per selezionare una connessione a Qualtrics esistente o scegliete Aggiungi nuovo per crearne una nuova.
   
   Consiglio Q: per modificare o rimuovere una connessione esistente, accedere alle impostazioni account.
10. Quando si aggiunge una nuova connessione, fornire quanto segue:
    • Nome della connessione: Assegnare un nome alla connessione per poterla identificare in seguito.
    • ID del datacenter di Qualtrics: Inserire l’ID del datacenter di Qualtrics.
    • Token API di Qualtrics: Inserire il token API del proprio account Qualtrics.
11. Se si desidera che la connessione scada dopo un certo periodo di tempo, attivare l’opzione Invia notifiche di scadenza . Utilizzare il campo Data di scadenza per scegliere quando le credenziali scadono. Nella casella Giorni prima della scadenza, inserire con quanto anticipo si desidera essere avvisati della scadenza della connessione, fino a 100 giorni.
12. Fare clic su Successivo.
13. Fornire l’endpoint dell’API XM Discover Export.
    
14. Fare clic su Successivo.
15. Scegliere il livello di dati che si desidera esportare:
    
    • Frasi: Utilizzare i dati a livello di frase.
    • Documenti: Utilizzare i dati a livello di documento.
      Consiglio Q: I restanti passaggi della pagina di configurazione della query sono facoltativi e aiutano a restringere i dati esportati.
16. Fornire unaquerydi ricerca per filtrare i dati in uscita. Utilizzare la stessa sintassi usata per cercare i dati in Designer. Lasciare questo campo vuoto per includere tutti i dati.
    Esempio: È possibile specificare uno o più ID sondaggio per aggiornare solo i record del sondaggio selezionato utilizzando la seguente sintassi:surveyid:sv_01
17. Inserire il nome del filtro del progetto che si desidera applicare ai dati in uscita. Lasciare questo campo vuoto se non si desidera filtrare i dati.
18. Scegliere i record da importare:
    • Carica nuovi record: I record creati dall’ultima volta che è stato eseguito il lavoro in uscita.
    • Carica i record nuovi e aggiornati: I record creati o aggiornati dall’ultima volta che è stato eseguito il lavoro in uscita.
    • Carica record aggiornati: I record che sono stati aggiornati dall’ultima volta che è stato eseguito il lavoro in uscita.
19. Utilizzare il menu a discesa per scegliere i modelli di classificazione da includere nei dati. Selezionare la casella di controllo Tutti i progetti per includere i dati di classificazione di tutti i modelli disponibili nel progetto.
20. Selezionare la modalità di impatto delle classificazioni sul filtro dei dati:
    • Ignora: Non si applica alcun filtro in base ai modelli selezionati.
    • Attualmente classificato: Restituisce i record che sono stati classificati dai modelli selezionati durante l’ultima esecuzione di classificazione.
    • Sempre classificati: Restituisce i record che sono stati classificati dai modelli selezionati in qualsiasi momento.
21. Scegliere le opzioni di esportazione aggiuntive che si desidera utilizzare:
    • Se restituire gli ID delle categorie (true) invece dei nomi delle categorie (false): Esporta gli ID delle categorie invece dei nomi delle categorie
    • Filtra i risultati applicando una query di filtro con tutti i percorsi dei nodi foglia: Api aggiunge più modelli con il parametro “leaf_only flag” alla chiamata API di esportazione.
    • Ignora i valori vuoti: Salta l’aggiornamento di un documento di sondaggio se tutti i suoi valori in uscita sono vuoti.
22. Fare clic su Successivo.
23. Il passo successivo dipende dall’esportazione dei dati del sondaggio o dall’invio dei dati a un endpoint JSON per attivare un flusso di lavoro:
    • Sondaggio: Scegliere il sondaggio in cui esportare i dati e fare clic su Avanti.
      
      Quindi, selezionare l’attributo XM Discover che contiene l’ID del sondaggio Qualtrics.
      
      Consiglio Q: Verranno aggiornati solo i documenti con ID sondaggio corrispondente al sondaggio selezionato nel passaggio precedente.
    • Evento JSON: Inserire l’endpoint JSON dell’evento JSON.
      
24. Mappare i campi da XM Discover a Qualtrics. Fare clic sulla casella vuota e scegliere l’attributo XM Discover che si desidera inviare a Qualtrics.
    
25. Selezionare il tipo di dati con cui esportare il campo, che corrisponde al tipo di variabile dati integrata del campo in Qualtrics:
    
    • Non mappare: Nessun tipo di variabile specificato.
    • Attributo Numero: Numero Tipo di variabile.
    • Attributo Testo: Tipo di variabile del set di testo.
    • Attributo Date: Data Tipo di variabile.
    • Verbatim: Tipo di variabile testo.
26. Inserire il nome del campo incorporato da Qualtrics che deve essere popolato con i valori dell’attributo XM Discover selezionato.
27. Usare i segni più ( + ) e meno ( – ) per aggiungere e rimuovere campi secondo le necessità.
28. Fare clic su Successivo.
29. Se si desidera, è possibile aggiungere un filtro al connettore per filtrare i dati in entrata e limitare i dati importati.
    
30. È anche possibile limitare il numero di record importati in un singolo lavoro inserendo un numero nella casella Specifica limite record. Inserire “Tutti” se si desidera importare tutti i record.
    Consiglio Q: Per i dati delle conversazioni, il limite si applica in base alle conversazioni anziché alle righe.
31. Fare clic su Successivo.
32. Scegliete quando volete essere avvisati. Per ulteriori informazioni, vedere Notifiche di lavoro.
    
33. Fare clic su Successivo.
34. Scegliere quando eseguire il lavoro. È possibile effettuare un’estrazione una tantum o impostare un’estrazione ricorrente dei dati. Per ulteriori informazioni, vedere Pianificazione dei lavori.
    
35. Fare clic su Successivo.
36. Valutate la vostra configurazione. Se è necessario modificare un’impostazione specifica, fare clic sul pulsante Modifica per accedere alla fase di impostazione del connettore.
    
37. Fare clic su Fine per salvare il lavoro.

Una volta salvato il lavoro, i dati specificati verranno esportati in Qualtrics in base alla pianificazione impostata. Se si sta triggerando un evento JSON, assicurarsi di costruire il resto del flusso di lavoro, che include l’aggiunta di condizioni per limitare l’esecuzione del flusso di lavoro e attività per determinare l’output del flusso di lavoro.