Qualtrics-Eingangskonnektor

Informationen zum Qualtrics-Eingangskonnektor

Sie können den Qualtrics-Eingangskonnektor verwenden, um Umfragen aus Ihrem Qualtrics-Konto zu laden.

Hochladen von Daten aus einem Qualtrics-Konto in XM Discover

Bevor Sie anfangen

Bevor Sie einen Job mit dem Qualtrics-Eingangskonnektor konfigurieren, stellen Sie sicher, dass Sie über die folgenden Informationen zu Ihrem Qualtrics-Konto verfügen:

• Ihre Qualtrics-Instanzadresse.
• Ihr Qualtrics-API-Token.
• Der Name der Umfrage, aus der Daten hochgeladen werden sollen.
  Tipp: Weitere Informationen finden Sie in der Qualtrics-API-Dokumentation.

Verbindung einrichten

1. Melden Sie sich bei Connectors an.
2. Klicken Sie oben rechts auf der Seite Aufträge auf die Schaltfläche Neuer Auftrag.
   
3. Wechseln Sie auf der Seite Connectors zum Abschnitt SELECT A SOURCE.
   
4. Klicken Sie auf die Qualtrics-Schaltfläche.
   

Erstellen eines eingehenden Qualtrics-Connector-Jobs

Nachdem Sie die Verbindung eingerichtet haben, führen Sie die folgenden Schritte aus, um Ladeumfragen aus Ihrem Qualtrics-Konto in XM Discover zu erstellen.

• Schritt 1: Jobnamen angeben
• Schritt 2: Projekt und Beschreibung angeben
• Schritt 3: Qualtrics-Anmeldedaten angeben
• Schritt 4: Qualtrics-Datentyp
• Schritt 5: Gewünschte Felder XM Discover zuordnen
• Schritt 6: Datenersetzung und -redundanz (optional)
• Schritt 7: Filter (optional) und Datensatzlimit angeben
• Schritt 8: Benachrichtigung und Konfiguration (optional)
• Schritt 9: Zusätzliche Optionen für Job einrichten
• Schritt 10: Alle Jobeinstellungen bestätigen

Tipp: Klicken Sie auf die Schaltflächen Zurück und Weiter, um zwischen den Seiten zu navigieren, oder verwenden Sie die Pfeiltasten: LEFT, um zurückzugehen, RIGHT, um fortzufahren. Wenn Sie die Einrichtung abbrechen möchten, klicken Sie auf die Schaltfläche Abbrechen.

Schritt 1: Jobnamen angeben

Geben Sie oben links auf der Seite im Feld Jobname einen erkennbaren Jobnamen ein.

Schritt 2: Projekt und Beschreibung angeben

1. Wählen Sie auf der Seite Projekt und Beschreibung angeben aus dem Dropdown-Menü Projekte das Projekt aus, in das Daten geladen werden sollen.
   
   Tipp: Sie haben die Möglichkeit, im Feld Stellenbeschreibung eine Notiz zum Job einzugeben. Die Stellenbeschreibung, die Sie im Feld Stellenbeschreibung eingeben, kann nur in der Liste Konnektoren aufgerufen werden und wird nicht als Teil der Daten für eine Stelle hochgeladen.
2. Klicken Sie auf Weiter.

Schritt 3: Qualtrics-Anmeldedaten angeben

1. Auf der Seite Qualtrics-Anmeldeinformationenangeben können Sie einen vorhandenen Satz von Anmeldeinformationen aus dem Dropdown-Menü auswählen.
   
   Tipp: Sie können einen neuen Satz von Qualtrics-Anmeldeinformationen hinzufügen. Informationen zu neuen Qualtrics-Anmeldeinformationen finden Sie im Hinzufügen neuer Qualtrics-Anmeldeinformationen Abschnitt beschriebenen Schritte befolgen.
2. Klicken Sie auf Weiter.

Schritt 4: Qualtrics-Datentyp

1. Wählen Sie auf der Seite Qualtrics-Datentypeine der folgenden Optionen aus, um den Datentyp anzugeben, der in XM Discover hochgeladen werden soll:

• Umfrage: Laden Sie Daten aus einem bestimmten Qualtrics-System hoch. Weitere Informationen finden Sie unten im Unterabschnitt „Umfrage“.
• Online Reputation Management (ORM): Laden Sie Bewertungen und Standortdaten aus einem Qualtrics Reputation Management Projekt hoch. Weitere Informationen finden Sie unten im Unterabschnitt Online Reputation Management (ORM).
• Tickets: Nehmen Sie Ticketdaten aus Qualtrics Engage auf. Weitere Informationen finden Sie unten im Unterabschnitt Tickets.
  

2. Klicken Sie auf Weiter.

Umfrage

1. Wenn Sie Umfrage auswählen, gelangen Sie zur Seite Umfrage für Konfiguration auswählen, auf der Sie eine der verfügbaren Qualtrics-Umfragen auswählen können, aus der Sie Daten hochladen möchten.
   
   Tipp: Wenn die gesuchte Umfrage nicht angezeigt wird, stellen Sie sicher, dass sie mit dem Konto geteilt wird, das den API-Schlüssel aus der Qualtrics-Umgebung generiert hat.
2. Wenn für die ausgewählte Umfrage Filter verfügbar sind, wählen Sie einen der Qualtrics-Filter aus dem Menü aus (optional). Weitere Informationen finden Sie unter Filtern von Antworten.
   
3. Aktivieren Sie das Kontrollkästchen Antworten mit dem Status “In Bearbeitung” abrufen, wenn Sie nicht abgeschlossene Antworten in den Upload einbeziehen möchten. Markieren Sie dieses Ankreuzfeld nicht, wenn Sie nur abgeschlossene Antworten abrufen möchten.
   
   Tipp: Sie können die Abfragekonfiguration aktualisieren, nachdem der Auftrag erstellt wurde.

Online Reputation Management (ORM)

Wenn Sie Online Reputation Management (ORM) auswählen, gelangen Sie zur Seite ID des ORM-Datensets angeben, auf der Sie die idpSourceId für das importierte Datenprojekt in das Feld IDP-Quell-ID eingeben können.

Tickets

Wenn Sie Tickets auswählen, gelangen Sie zur Gewünschte Felder in XM Discover abbilden auf der Sie Quelldatenfelder mit Datenfeldern in Ihrem XM-Discover-Projekt verbinden können.

Schritt 5: Gewünschte Felder XM Discover zuordnen

1. Wählen Sie auf der Seite Gewünschte Felder XM Discover zuordnen die Registerkarte QUELLZUORDNUNG aus, um Quelldatenfelder mit Datenfeldern in Ihrem XM Discover-Projekt zu verbinden.
   
2. Konfigurieren Sie im Abschnitt Standardquellzuordnung die Standarddatenfelder, die alle Dokumente in XM Discover gemeinsam nutzen. Informationen zur Standardquellzuordnung finden Sie im Standardquellzuordnung Abschnitt beschriebenen Schritte befolgen.
3. Konfigurieren Sie im Abschnitt Quellzuordnung alle zusätzlichen Datenfelder aus der Datei.
   
   Tipp: Weitere Informationen zur Datenzuordnung finden Sie unter Konfigurieren der Datenzuordnung.
4. Klicken Sie auf Weiter.

Schritt 6: Datensubstitution und Redaktion (optional)

1. Auf der Seite Datenersetzung und Redaktion können Sie Ersetzungs- und Redaktionsregeln angeben, um sensible Daten auszublenden oder bestimmte Wörter und Phrasen in Kundenfeedback und -interaktionen automatisch zu ersetzen.
   
   Tipp: Weitere Informationen zur Datenersetzung und Unkenntlichmachung finden Sie unter Datenersetzung und Redaktion.
2. Klicken Sie auf Weiter.

Schritt 7: Filter (optional) und Datensatzlimit angeben

1. Auf der Seite Filter angeben können Sie eine Filterbedingung für einen Job definieren, um nur Datensätze zu laden, die ihn erfüllen (optional).
   
   Tipp: Weitere Informationen zum Anwenden eines Filters finden Sie unter Konnektorfilter.
2. Sie können im Feld Datensatzlimit angeben ein Datensatzlimit angeben. Alternativ können Sie das Datensatzlimit als Standard Alle belassen, wenn Sie möchten, dass alle Datensätze in einem einzigen Push zurückgegeben werden.
   Tipp: Das Datensatzlimit ist ein Limit pro Ausführung des Auftrags. Wenn Sie den Wert auf 1.000 setzen, wird der Job nach dem von Ihnen festgelegten Zeitplan ausgeführt und nach dem Abrufen von 1.000 Datensätzen gestoppt. Wenn Sie sie auf “Täglich” setzen, bedeutet dies, dass sie einmal pro Tag ausgeführt wird und Sie bis zu 1.000 Datensätze für jeden Tag erhalten.
   Tipp: Bei dialogorientierten Daten wird der Grenzwert basierend auf Unterhaltungen und nicht auf Zeilen angewendet.
3. Klicken Sie auf Weiter.

Schritt 8: Benachrichtigungskonfiguration (optional)

1. Auf der Seite Benachrichtigungskonfiguration können Sie die Benachrichtigungen auswählen, die die Beobachter eines Auftrags erhalten sollen, wenn eines der unten aufgeführten Ereignisse eintritt.

• Benachrichtigung, wenn null Datensätze in das Projekt geladen wurden.
• Benachrichtigen, wenn aufeinanderfolgende fehlende Werte gefunden werden.
• Benachrichtigen, wenn die Jobausführung fehlschlägt.
• Benachrichtigen, wenn die Jobausführung teilweise erfolgreich ist.
• Benachrichtigen, wenn der Job mit einem Timeout endet.
• Benachrichtigen Sie den Support, wenn dieser Job fehlschlägt.
  

2. Klicken Sie auf Weiter.

Schritt 9: Zusätzliche Optionen für Job einrichten

1. Wählen Sie auf der Seite Zusätzliche Optionen für Job einrichten im Abschnitt Behandlung neuer und vorhandener Dokumente, wie das System doppelte Dokumente behandeln soll, indem Sie eines der folgenden Ankreuzfelder im Abschnitt Behandlung neuer und vorhandener Dokumente markieren:
   • Duplikate für vorhandene Belege ablehnen und neue Datensätze für neue Belege anlegen
   • Strukturierte Attribute für vorhandene Belege aktualisieren und neue Datensätze für neue Belege anlegen
   • Strukturierte Attribute für vorhandene Belege aktualisieren und keine Datensätze für neue Belege anlegen
     
     Achtung: Jedes Dokument muss eine eindeutige natürliche ID haben, damit das System doppelte Dokumente mit identischen natürlichen IDs verarbeiten kann.

2. Wählen Sie auf der Seite Zusätzliche Optionen für Job einrichten im Abschnitt Historischen/inkrementellen Job einplanen eine der folgenden Optionen:

• Inkrementelle Läufe einplanen, um einen Zeitplan für inkrementelle Datenabrufe einzurichten.
  Tipp: Weitere Informationen zur Einplanung inkrementeller Läufe finden Sie unter Jobeinplanung.
• Einmaliges Pull einrichten, um einen einmaligen Daten-Pull durchzuführen.
  

3. Klicken Sie auf Weiter.
   

Schritt 10: Alle Jobeinstellungen bestätigen

1. Auf der Seite Alle Jobeinstellungen bestätigen können Sie eine Zusammenfassung aller Einstellungen für einen Job anzeigen und die Einstellungen bei Bedarf bearbeiten, bevor Sie den Daten-Upload ausführen.
   
2. Um den Daten-Upload auszuführen, wählen Sie Fertigstellen, wenn Sie bereit sind, den Daten-Upload auszuführen. Es wird eine Bestätigungsmeldung angezeigt, die bestätigt, dass der Job erfolgreich übermittelt wurde.

Wenn Sie auf Fertig stellen klicken, geschieht Folgendes: Einmalige Pulls werden sofort ausgeführt. Wenn Sie die Option „Job anlegen, aber keine Daten abrufen“ nicht aktiviert haben, werden eingeplante Pulls sofort ausgeführt und dann gemäß dem von Ihnen definierten Zeitplan ausgeführt.

Weitere Informationen zum Überwachen von Jobs finden Sie unter Jobseitenübersicht.

Hinzufügen neuer Qualtrics-Anmeldeinformationen

1. Um einen neuen Satz von Anmeldeinformationen hinzuzufügen, wählen Sie im Menü mit den Anmeldeinformationen die Option Neu hinzufügen.
   
2. Geben Sie den Namen des neuen Anmeldeinformationssatzes in das Feld Verbindungsname ein.
   
3. Geben Sie Ihre Qualtrics-Rechenzentrums-ID im Feld QUALTRICS-DATENTRAGENTER-ID an.
   Tipp: Informationen zur Suche nach Ihrem Rechenzentrum finden Sie im Abschnitt Suchen nach Ihrer Rechenzentrums-ID auf der Seite Suchen nach Qualtrics-IDs.
4. Geben Sie das API-Token für Ihr Qualtrics-Konto im Feld QUALTRICS API TOKEN an.
   Tipp: Informationen zum Finden eines Qualtrics-API-Tokens finden Sie unter API-Token-Authentifizierung.
5. Sie können festlegen, dass Ihre Anmeldeinformationen nach einem bestimmten Zeitraum ablaufen (optional). Um ein Ablaufdatum für diesen Anmeldeinformationssatz zu definieren und eine Erinnerung für alle Jobbeobachter festzulegen, aktivieren Sie das Kontrollkästchen Ablaufbenachrichtigungen senden. Dadurch wird das Feld Tage vor Ablauf aktiviert.
   
6. Geben Sie einen Wert in das Feld Tage vor Ablauf ein, um festzulegen, wie viele Tage vor dem Ablauf die Benachrichtigungen beginnen sollen. Mögliche Werte liegen zwischen 1 und 100 Tagen.
   Tipp: Diese Erinnerung wird jedes Mal ausgelöst, wenn der Auftrag ausgeführt wird, sobald das Ablaufdatum unter der im Feld Tage vor Ablauf festgelegten Anzahl von Tagen liegt.
7. Wählen Sie das Ablaufdatum aus der Kalenderdatumsauswahl aus. Das Ablaufdatum wird dann dem Feld Ablaufdatum hinzugefügt.

Standardquellzuordnung

Dies sind die Standardoptionen für Datenfelder für den Qualtrics-Eingangskonnektor:

1. natural_id: Natürliche ID dient als eindeutige ID eines Dokuments und ermöglicht die korrekte Verarbeitung doppelter Dokumente. Für die natürliche ID verwendet XM Discover Quell-IDs, denen der Name des Connectors über eine benutzerdefinierte Transformation vorangestellt ist: Natürliche ID = Connector-Name;Source-ID
   
2. document_date: Das Belegdatum ist das primäre Datumsfeld, das mit einem Dokument verknüpft ist. Dieses Datum wird in XM-Discover-Berichten, Trends, Warnungen usw. verwendet. Wählen Sie für Belegdatumeine der folgenden Optionen:

• endDate (Standard): Datum und Uhrzeit der Übermittlung der Umfrage durch den Umfrageteilnehmer. Wenn es sich bei dem Eintrag um eine Teilantwort handelt, gibt dieses Datum den Zeitpunkt an, an dem der Umfrageteilnehmer zum letzten Mal mit der Umfrage interagiert hat.
  
• startDate: Datum und Uhrzeit des ersten Klicks des Umfrageteilnehmers auf den Umfrage-Link.
• recordedDate: Dies ist ein Datensatz darüber, wann eine Umfrageantwort in Qualtrics gestartet, übermittelt oder aktualisiert wurde.
  Tipp: Wenn Quelldaten andere Datumsfelder enthalten, können Sie eines davon als Dokumentdatum festlegen, indem Sie es in der Spalte Feldname auswählen.
  

3. job_name: Mit Jobname können Sie Daten anhand des Namens des Jobs identifizieren, der zum Hochladen verwendet wird. Sie können den Wert dieses Attributs während der Einrichtung über das Feld Jobname ändern, das während der Einrichtung oben auf jeder Seite angezeigt wird.
4. loadDate: Ladedatum gibt an, wann ein Dokument in XM Discover hochgeladen wurde. Dieses Feld wird automatisch gesetzt.
5. feedback_provider: Der Feedbackanbieter hilft Ihnen dabei, die von einem bestimmten Anbieter erhaltenen Daten zu identifizieren. Für Qualtrics-Dokumente ist der Wert dieses Attributs auf Qualtrics gesetzt.
6. feedback_type: Mithilfe des Feedback-Typs können Sie Daten anhand ihres Typs identifizieren. Dies ist hilfreich für das Reporting, wenn Ihr Projekt verschiedene Arten von Daten enthält (z.B. Umfragen und Social-Media-Feedback). Für Qualtrics-Dokumente ist der Wert dieses Attributs auf Umfrage gesetzt.
7. Quelle: Mit der Quelle können Sie Daten identifizieren, die aus einer bestimmten Quelle abgerufen wurden. Dies kann alles sein, das die Herkunft der Daten beschreibt, z.B. der Name einer Umfrage oder einer mobilen Marketingkampagne. Standardmäßig ist der Wert dieses Attributs auf Qualtrics gesetzt, Sie können jedoch Ihren eigenen Wert in der Spalte Fest programmierter Wert angeben.