Qualtrics Outbound Connector

Informationen zum Qualtrics Outbound Connector

Mit dem ausgehenden Qualtrics-Connector können Sie die folgenden Aktionen in Ihrem Qualtrics-Konto ausführen:

• Lösen Sie ein JSON-Workflow-Ereignis aus, und verwenden Sie XM-Discover-Daten in Qualtrics-Workflows.
• Exportieren Sie Antworten mit XM-Discover-Anreicherungen aus XM Discover, und importieren Sie sie in einen Qualtrics-Umfragedatensatz.

Anforderungen

Bevor Sie die Verbindung einrichten, benötigen Sie die folgenden Informationen aus Ihrem Qualtrics-Konto:

• Ihre Qualtrics-Rechenzentrums-ID.
• Ihr Qualtrics-API-Token.
• Ihr XM Discover Export API-Endpunkt.

JSON-Ereignisjobs

Um ein JSON-Ereignis mit dem Qualtrics Outbound Connector auszulösen, benötigen Sie den Endpunkt des JSON-Ereignisses. Sie können den Endpunkt kopieren, indem Sie beim Bearbeiten des JSON-Ereignisses in Ihrem Qualtrics-Workflow auf URL kopieren klicken.

Auftrag „Antworten exportieren“

Wenn Sie Antworten auf einen Qualtrics-Umfragedatensatz exportieren, müssen Sie sicherstellen, dass Ihre Daten die folgenden Anforderungen erfüllen:

• Ihr Umfragedatensatz muss Felder enthalten, die den XM-Discover-Anreicherungen entsprechen, die Sie exportieren möchten. Wenn diese Felder nicht vorhanden sind, können Sie sie als eingebettete Daten hinzufügen oder sie mithilfe benutzerdefinierter Felder anlegen.
• Die Dokumente, die Sie aus XM Discover exportieren, müssen ein Feld enthalten, das der Umfrage-ID der Umfrage entspricht, in die Sie Antworten importieren möchten.

Qualtrics-Ausgangskonnektorauftrag erstellen

1. Klicken Sie auf der Seite Aufträge auf Neuer Auftrag.
   
2. Wählen Sie den Qualtrics Outbound Connector aus.
   
3. Geben Sie Ihrem Job einen Namen, damit Sie ihn identifizieren können.
   
4. Wählen Sie das Projekt aus, in das Daten geladen werden sollen.
5. Geben Sie Ihrer Stelle eine Beschreibung, damit Sie ihren Zweck kennen.
6. Klicken Sie auf Weiter.
7. Wählen Sie den Qualtrics-Datentyp aus, den Sie exportieren möchten:
   
   • Umfrage: Exportieren Sie Antwortdaten, um sie in ein Umfragedatenset zu importieren.
   • JSON-Ereignis: Exportieren Sie Daten, um ein JSON-Workflow-Ereignis auszulösen.
8. Klicken Sie auf Weiter.
9. Verwenden Sie die Dropdown-Liste, um eine vorhandene Qualtrics-Verbindung auszuwählen, oder wählen Sie Neu hinzufügen, um eine neue Verbindung zu erstellen.
   
   Tipp: Gehen Sie zu Ihren Kontoeinstellungen, um eine vorhandene Verbindung zu bearbeiten oder zu entfernen.
10. Geben Sie beim Hinzufügen einer neuen Verbindung Folgendes an:
    • Verbindungsname: Geben Sie der Verbindung einen Namen, damit Sie sie später identifizieren können.
    • Qualtrics-Rechenzentrums-ID: Geben Sie Ihre Qualtrics-Rechenzentrums-ID ein.
    • Qualtrics-API-Token: Geben Sie das API-Token Ihres Qualtrics-Kontos ein.
11. Wenn die Verbindung nach einem bestimmten Zeitraum ablaufen soll, aktivieren Sie die Option Ablaufbenachrichtigungen senden. Verwenden Sie das Feld Ablaufdatum, um festzulegen, wann die Anmeldeinformationen ablaufen. Geben Sie im Feld Tage vor Ablauf an, wie weit im Voraus Sie über den Ablauf der Verbindung benachrichtigt werden möchten, bis zu 100 Tage.
12. Klicken Sie auf Weiter.
13. Geben Sie Ihren XM Discover Export-API-Endpunkt an.
    
14. Klicken Sie auf Weiter.
15. Wählen Sie die Datenebene aus, die Sie exportieren möchten:
    
    • Sätze: Verwenden Sie Daten auf Satzebene.
    • Dokumente: Verwenden Sie Daten auf Belegebene.
      Tipp: Die verbleibenden Schritte auf der Seite Abfragekonfiguration sind optional und helfen Ihnen dabei, die exportierten Daten einzugrenzen.
16. Stellen Sie eine Suchabfrage bereit, nach der die ausgehenden Daten gefiltert werden sollen. Verwenden Sie dieselbe Syntax wie zum Suchen von Daten in Designer. Lassen Sie dieses Feld leer, um alle Daten einzuschließen.
    Beispiel: Sie können eine oder mehrere Survey-IDs angeben, um nur die ausgewählten Survey-Datensätze mit folgender Syntax zu aktualisieren:surveyid:sv_01
17. Geben Sie den Namen des Filters aus Ihrem Projekt ein, der auf die Ausgangsdaten angewendet werden soll. Lassen Sie dieses Feld leer, wenn Sie Ihre Daten nicht filtern möchten.
18. Wählen Sie aus, welche Datensätze Sie importieren möchten:
    • Neue Datensätze laden: Datensätze, die seit der letzten Ausführung des Ausgangsjobs angelegt wurden.
    • Neue und aktualisierte Datensätze laden: Datensätze, die seit der letzten Ausführung des Ausgangsjobs entweder angelegt oder aktualisiert wurden.
    • Aktualisierte Datensätze laden: Datensätze, die seit der letzten Ausführung des Ausgangsjobs aktualisiert wurden.
19. Wählen Sie über das Dropdown-Menü aus, welche Klassifizierungsmodelle Sie in Ihre Daten aufnehmen möchten. Markieren Sie das Ankreuzfeld Alle Modelle, um die Klassifizierungsdaten für alle im Projekt verfügbaren Modelle einzubeziehen.
20. Wählen Sie aus, wie sich Klassifizierungen auf die Datenfilterung auswirken sollen:
    • Ignorieren: Basierend auf den ausgewählten Modellen wird kein Filter angewendet.
    • Aktuell klassifiziert: Gibt die Datensätze zurück, die von den ausgewählten Modellen während des letzten Klassifikationslaufs klassifiziert wurden.
    • Ever Classified: Gibt die Datensätze zurück, die von den ausgewählten Modellen zu einem beliebigen Zeitpunkt klassifiziert wurden.
21. Wählen Sie die zusätzlichen Exportoptionen aus, die Sie verwenden möchten:
    • Ob Kategorie-IDs (true) anstelle von Kategorienamen zurückgegeben werden sollen (false): Kategorie-IDs anstelle von Kategorienamen exportieren
    • Filtert Ergebnisse, indem eine Filterabfrage mit allen Blattknotenpfaden angewendet wird: Fügt dem Export-API-Aufruf mehrere Modelle mit dem Parameter „leaf_only flag“ hinzu.
    • Leere Werte ignorieren: Überspringen Sie die Aktualisierung eines Umfragedokuments, wenn alle ausgehenden Werte leer sind.
22. Klicken Sie auf Weiter.
23. Der nächste Schritt hängt davon ab, ob Sie Umfragedaten exportieren oder Daten an einen JSON-Endpunkt senden, um einen Workflow auszulösen:
    • Umfrage: Wählen Sie die Umfrage aus, in die Sie Daten exportieren möchten, und klicken Sie auf Weiter.
      
      Wählen Sie dann das XM-Discover-Attribut aus, das Ihre Qualtrics-Umfrage-ID enthält.
      
      Tipp: Nur Dokumente mit Umfrage-ID, die mit der im vorherigen Schritt ausgewählten Umfrage übereinstimmen, werden aktualisiert.
    • JSON-Ereignis: Geben Sie den JSON-Endpunkt aus dem JSON-Ereignis ein.
      
24. Ordnen Sie Felder von XM Discover zu Qualtrics zu. Klicken Sie auf das leere Feld, und wählen Sie das XM-Discover-Attribut aus, das Sie an Qualtrics senden möchten.
    
25. Wählen Sie den Datentyp aus, als der das Feld exportiert werden soll. Dies entspricht dem eingebetteten Datenvariablentyp des Felds in Qualtrics:
    
    • Nicht zuordnen: Kein Variablentyp angegeben.
    • Zahlenattribut: Variablentyp Zahl.
    • Textattribut: Textset-Variablentyp.
    • Datumsattribut: Datumsvariablentyp.
    • Ausführlich: Textvariablentyp.
26. Geben Sie den Namen des eingebetteten Felds aus Qualtrics ein, das mit den Werten des ausgewählten XM-Discover-Attributs gefüllt werden soll.
27. Verwenden Sie die Plus- (+ ) und Minuszeichen (– ), um Felder nach Bedarf hinzuzufügen und zu entfernen.
28. Klicken Sie auf Weiter.
29. Bei Bedarf können Sie einen Konnektorfilter hinzufügen, um die eingehenden Daten zu filtern und so einzuschränken, welche Daten importiert werden.
    
30. Sie können auch die Anzahl der in einem einzelnen Job importierten Datensätze begrenzen, indem Sie eine Zahl in das Feld Datensatzlimit angeben eingeben. Geben Sie „Alle“ ein, wenn Sie alle Datensätze importieren möchten.
    Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
31. Klicken Sie auf Weiter.
32. Wählen Sie aus, wann Sie benachrichtigt werden möchten. Weitere Informationen finden Sie unter Jobbenachrichtigungen.
    
33. Klicken Sie auf Weiter.
34. Wählen Sie aus, wann Ihr Job ausgeführt wird. Sie können entweder einen einmaligen Pull durchführen oder einen wiederkehrenden Daten-Pull einrichten. Weitere Informationen finden Sie unter Jobeinplanung.
    
35. Klicken Sie auf Weiter.
36. Überprüfen Sie Ihre Einrichtung. Wenn Sie eine bestimmte Einstellung ändern müssen, klicken Sie auf die Schaltfläche Bearbeiten, um zu diesem Schritt in der Verbindungseinrichtung zu gelangen.
    
37. Wählen Sie Fertigstellen, um den Job zu sichern.

Sobald Ihr Auftrag gespeichert wurde, werden die von Ihnen angegebenen Daten basierend auf dem von Ihnen festgelegten Zeitplan nach Qualtrics exportiert. Wenn Sie ein JSON-Ereignis auslösen, stellen Sie sicher, dass Sie den Rest Ihres Workflows erstellen. Dazu gehört das Hinzufügen von Bedingungen, um die Ausführung des Workflows und Aufgaben einzuschränken, um die Ausgabe des Workflows zu bestimmen.