Übersicht über XM-Discover-Datenformate
Informationen zu XM Discover Data Formats
XM Discover unterstützt drei verschiedene Datenformate, die Sie mit verschiedenen Dateitypen hochladen können.
Die folgenden Konnektoren unterstützen das Laden von Daten über Dateien:
- Verbindung „Ad-hoc-Datei-Upload – Eingang“
- Dateieingangskonnektor
- XM Discover-Link – Eingangskonnektor
Tipp: Der eingehende XM-Discover-Link -Connector verarbeitet Daten-Uploads über API-Aufrufe, bei denen Daten im JSON-Format dargestellt werden.
Individuelles Feedback
Das individuelle Feedbackformat wird für Dokumente verwendet, die Daten als einzeiliges oder flaches Objekt darstellen. Jedes Dokument kann mehrere wörtliche Felder enthalten, die jedoch in der Regel von einem einzelnen Autor stammen (z.B. wenn eine Umfrage mehr als eine offene Frage enthält).
Sie können einzelne Feedbackdokumente wie folgt hochladen:
Digitale Interaktionen
Das digitale Interaktionsformat wird für Dokumente verwendet, die dialogorientierte Daten wie Chats enthalten.
Digitale Interaktionen müssen dem Konversationsformat von Qualtrics folgen, das dem System hilft, wichtige Details wie Sprecher, Sequenzen und Gesprächsveranstaltungen zu verstehen. Für Anrufprotokolle wird ein ähnliches Konversationsformat verwendet.
Sie können digitale Interaktionen wie folgt hochladen:
Abrufprotokolle
Das Anrufprotokollformat wird für Dokumente verwendet, die Gesprächsdaten wie Supportanrufe enthalten.
Anrufprotokolle müssen dem Konversationsformat von Qualtrics folgen, das dem System hilft, wichtige Details wie Sprecher, Sequenzen und Gesprächsereignisse zu verstehen. Ein ähnliches Konversationsformat wird für digitale Interaktionen verwendet.
Sie können Anrufprotokolle wie folgt hochladen:
Beispieldateifehler
Mit verschiedenen Connector-Jobs können Sie Beispieldateien hochladen (z.B. Ad-hoc-Datei-Uploads, Dateien oder XM-Discover-Link-Jobs). Wenn Ihre Beispieldatei falsch konfiguriert ist, wird eine Fehlermeldung angezeigt, in der Sie aufgefordert werden, alle Probleme zu beheben. In diesem Abschnitt werden die verschiedenen möglichen Fehler und deren Behebung behandelt.
CSV- und Excel-Fehler
Die folgenden Fehler sind für CSV- und Excel-Beispieldateien (XLS, XLSX) möglich:
- Die Datei sollte die erforderliche Eigenschaft „REQUIRED_FIELD“ haben: Ein erforderliches Feld fehlt. Weitere Informationen zu den für diese Verbindung erforderlichen Feldern finden Sie in der Dokumentation für diesen spezifischen Konnektor, und stellen Sie sicher, dass das aufgeführte Feld in Ihrer Beispieldatei enthalten ist.
- Inkonsistente ParticipantType-Werte für ParticipantId ID: Für jeden Teilnehmer in einer Unterhaltung kann nur ein ParticipantType-Wert definiert sein. Überprüfen Sie Ihre Beispieldatei für alle Teilnehmer, die mehrere ParticipantTypes haben.
- Anzahl der Spalten stimmt nicht mit den Kopfzeilen überein: Jede Spalte muss eine Kopfzeile haben, und die Anzahl der Spalten in jeder Zeile muss gleich sein.
- Zeile ROW_NUMBER der Spalte COLUMN_NAME sollte dem Datums-/Uhrzeitformat ISO 8601 YYYY-MM-DDThh:mm:ss.sZ entsprechen: Verwenden Sie für Datumsangaben das ISO-8601-Format mit Sekundengenauigkeit.
JSON-Fehler
Folgende Fehler sind für JSON-Dateien möglich:
- Fehler bei JSON_DATA_PATH: sollte eine Zeichenfolge im Datums-/Uhrzeitformat ISO 8601 YYYY-MM-DDThh:mm:ss.sZ sein: Verwenden Sie für Datumsangaben das ISO-8601-Format mit Sekundengenauigkeit.
- Fehler bei JSON_DATA_PATH: sollte eine Zeichenfolge mit dem Wert AGENT, CLIENT oder TYPE_UNKNOWN sein: Der ParticipantType im angegebenen Pfad ist ungültig. Es sollten nur die folgenden Werte verwendet werden:
- AGENT bezeichnet einen Unternehmensvertreter oder einen Chatbot.
- CLIENT kennzeichnet einen Kunden.
- TYPE_UNKNOWN zeigt einen nicht identifizierten Teilnehmer an.
- Fehler bei JSON_DATA_PATH: sollte DATA_TYPE sein: Der Feldwert ist der falsche Datentyp. Stellen Sie sicher, dass der Datentyp mit dem übereinstimmt, was in der Datenzuordnung Ihres Connectors enthalten ist.
- Fehler bei JSON_DATA_PATH: sollte Eigenschaft REQUIRED_FIELD haben: Ein erforderliches Feld fehlt. Weitere Informationen zu den für diese Verbindung erforderlichen Feldern finden Sie in der Dokumentation für diesen spezifischen Konnektor, und stellen Sie sicher, dass das aufgeführte Feld in Ihrer Beispieldatei enthalten ist.
- Fehler bei JSON_DATA_PATH: Teilnehmer mit Teilnehmer-ID kann in Teilnehmern nicht gefunden werden: Teilnehmer-IDs müssen mit einer der in der Teilnehmerliste angegebenen IDs übereinstimmen. Stellen Sie sicher, dass die aufgeführte ID in Ihrer Beispieldatei enthalten ist.