-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Digitale Interaktionen Datenformate
Informationen zu Datenformaten für digitale Interaktionen
Mit XM Discover können Sie digitale Interaktionen (d.h. Konversationen) über CSV, Excel oder JSON hochladen. Digitale Interaktionen identifizieren die Teilnehmer einer Unterhaltung und ordnen jede Nachricht einem Teilnehmer zu.
In der Regel enthalten digitale Interaktionen eine Reihe strukturierter und unstrukturierter Datenfelder, die ein Gespräch zwischen einem Kunden und einer Entität in Ihrem Unternehmen darstellen (z.B. das Textprotokoll zwischen einem Kunden und einem Chatbot auf Ihrer Website oder das Chat-Protokoll zwischen einem Kunden und einem Live-Support-Mitarbeiter). Strukturierte Felder können Daten, Zahlen oder Textdaten mit einem hohen Organisationsgrad enthalten (z.B. Namen von Marken, Teilnehmernamen und Produkte). Unstrukturierte Felder enthalten Notizen, Kommentare und andere Freitextfelder.
Sie können digitale Interaktionen über die folgenden Formate hochladen:
- CSV
- XLS oder XLSX (Microsoft Excel)
- JSON
CSV- und Excel-Formatierung für digitale Interaktionen
In diesem Abschnitt wird die Formatierung für individuelles Feedback für CSV- und Excel-Dateien behandelt. Die Formatierung und die Anforderungen für beide Dateitypen sind identisch.
In CSV- und Excel-Dateien werden digitale Interaktionen mit mehreren Zeilen definiert. So funktioniert das System:
- Jede Zeile enthält eine einzelne Dialogzeile in einer Unterhaltung zusammen mit Teilnehmerdaten und einem Zeitstempel.
- Getrennte Zeilen werden in eine einzelne Konversation übertragen, indem dieselbe Conversation-ID verwendet wird.
- Conversation-weite Feldwerte (wie Dokumentdatum oder benutzerdefinierte Attribute) werden aus der ersten Zeile der Unterhaltung übernommen.
- Spaltenüberschriften sollten genau mit den Feldern in der folgenden Tabelle übereinstimmen.
In der folgenden Tabelle werden die Felder in einer digitalen Interaktion beschrieben.
| Spaltenüberschrift | Beschreibung |
| ConversationId
(erforderlich) |
Eine eindeutige ID für die gesamte Konversation. Jede Zeile mit derselben ID wird als separate Zeile innerhalb einer einzelnen Konversation behandelt.
Sie können dieses Feld dem Attribut natural_id zuordnen, um es als natürliche ID des Dokuments zu verwenden. |
| conversationTimestamp
(Erforderlich) |
Das Datum und die Uhrzeit für das gesamte Gespräch. In der Regel beginnt das Gespräch. Verwenden Sie das ISO-8601-Format mit Sekundengenauigkeit.
Sie können dieses Feld dem Attribut document_date zuordnen, um es als Belegdatum zu verwenden. |
| ParticipantId
(erforderlich) |
Die ID des Teilnehmers. Jeder eindeutige Teilnehmer in einer Unterhaltung muss eine andere ID haben.
Sie können dieselbe Teilnehmer-ID über mehrere Konversationen hinweg haben (z.B. denselben Agent über mehrere Interaktionen hinweg), aber innerhalb einer Konversation kann sie nicht dieselbe sein. |
| ParticipantType
(Erforderlich) |
Der Typ des Teilnehmers. Mögliche Werte:
Diese Werte werden zur Berichterstellung und zur Visualisierung der Teilnehmer an das Attribut CB-Teilnehmertyp übergeben. Wenn nicht angegeben, hat die Teilnehmerart der Zentralbank keinen berichtspflichtigen Wert. |
| is_bot
(optional) |
Ein boolesches Feld, das angibt, ob ein Teilnehmer ein Chatbot oder eine Person ist.
Diese Werte werden zur Berichterstellung und zur Visualisierung der Teilnehmer an das Attribut CB-Art des Teilnehmers übergeben. Wenn nicht angegeben, hat die CB-Art des Teilnehmers keinen berichtspflichtigen Wert. |
| Text
(erforderlich) |
Der Text der Nachricht.
Achtung: Eine Summe aller Textelemente darf 100.000 Zeichen nicht überschreiten. Ist dies der Fall, wird die Konversation übersprungen.
|
| Zeitstempel
(erforderlich) |
Das Datum und die Uhrzeit der Nachricht. Verwenden Sie das ISO-8601-Format mit Sekundengenauigkeit. |
| Benutzerdefinierte Felder
(optional) |
Sie können mehrere Felder bereitstellen, um der Konversation strukturierte Attribute hinzuzufügen. |
JSON-Formatierung für digitale Interaktionen
Objekte der obersten Ebene
In der folgenden Tabelle werden die Objekte der obersten Ebene eines Dokumentknotens beschrieben.
| Element | Beschreibung |
| ConversationId | Eine eindeutige ID für die gesamte Konversation.
Sie können dieses Feld dem Attribut natural_id zuordnen, um es als natürliche ID des Dokuments zu verwenden. |
| conversationTimestamp | Das Datum und die Uhrzeit für das gesamte Gespräch. In der Regel beginnt das Gespräch. Verwenden Sie das ISO-8601-Format mit Sekundengenauigkeit.
Sie können dieses Feld dem Attribut document_date zuordnen, um es als Belegdatum zu verwenden. |
| Inhalt | Ein Objekt, das den Inhalt der Konversation enthält. Umfasst die folgenden verschachtelten Objekte:
|
| Benutzerdefinierte Felder (Attribute) | Sie können mehrere Schlüssel-Wert-Paare angeben, um der Konversation strukturierte Attribute hinzuzufügen. |
Inhaltsobjekt
In der folgenden Tabelle werden die im Inhaltsobjekt verschachtelten Objekte beschrieben.
| Element | Beschreibung |
| Teilnehmer:innen | Eine Reihe von Objekten, die Informationen über die Teilnehmer der Konversation bereitstellen. Umfasst die folgenden Felder:
|
| ConversationContent | Ein Array von Objekten, das die Zeilen der Konversation enthält. Umfasst die folgenden Felder:
|
Akteurs-Objekt
In der folgenden Tabelle werden die Felder beschrieben, die im Teilnehmerobjekt verschachtelt sind.
| Element | Beschreibung |
| ParticipantId
(erforderlich) |
Die ID des Teilnehmers. Jeder eindeutige Teilnehmer in einer Unterhaltung muss eine andere ID haben.
Sie können dieselbe Teilnehmer-ID über mehrere Konversationen hinweg haben (z.B. denselben Agent über mehrere Interaktionen hinweg), aber innerhalb einer Konversation kann sie nicht dieselbe sein. |
| ParticipantType
(Erforderlich) |
Der Typ des Teilnehmers. Mögliche Werte:
Diese Werte werden zur Berichterstellung und zur Visualisierung der Teilnehmer an das Attribut CB-Teilnehmertyp übergeben. Wenn nicht angegeben, hat die Teilnehmerart der Zentralbank keinen berichtspflichtigen Wert. |
| is_bot
(optional) |
Ein boolesches Feld, das angibt, ob ein Teilnehmer ein Chat-Bot oder eine Person ist.
Diese Werte werden zur Berichterstellung und zur Visualisierung der Teilnehmer an das Attribut CB-Art des Teilnehmers übergeben. Wenn nicht angegeben, hat die CB-Art des Teilnehmers keinen berichtspflichtigen Wert. |
conversationContent-Objekt
In der folgenden Tabelle werden die Felder beschrieben, die innerhalb des ConversationContent-Objekts verschachtelt sind.
| Element | Beschreibung |
| ParticipantId
(erforderlich) |
Die ID des Teilnehmers, der spricht. Muss mit einer der im Teilnehmer-Array angegebenen IDs übereinstimmen. |
| Text
(erforderlich) |
In: Speech Transcript.
Achtung: Eine Summe aller Textelemente darf 100.000 Zeichen nicht überschreiten. Ist dies der Fall, wird die Konversation übersprungen.
|
| Zeitstempel
(erforderlich) |
Das Datum und die Uhrzeit der Nachricht. Verwenden Sie das ISO-8601-Format mit Sekundengenauigkeit. |
| ID
(erforderlich) |
Die eindeutige ID der Nachricht. |
Beispiel-JSON
Hier ist ein Beispiel für ein Anruftranskript zwischen einem Agent und einem Client.
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"content": {
"teilnehmender
Teilnehmer": [
ParticipENT": "antId",
"bestandteilnahme_Typ", "
Betrifft"
,
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"ParticipantId": "2",
"text": "Hallo, bist du heute geöffnet?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785202"
},
"
ParticipantId": "1",
"text": "We'are open from 17:00 bis 23:00.",
"timestamp" ParticipantId: "2020-020-30T12:15.000Z" like "3785Z",
"anta
" "id
" "
:
Welchen Namen kann ich verwenden?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
}
,
"city": "Boston",
"source": "Facebook"
]