-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Artikelvorlage
Datenformate 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 in einer Unterhaltung und Attribut jede Nachricht einem Teilnehmer:in 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 Datumsangaben, Zahlen oder Textdaten mit einem hohen Organisation enthalten (z.B. Namen von Marken, Teilnehmer:in und Produkte). Unstrukturierte Felder enthalten Notizen, Kommentare und andere freier Text.
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
Dieser Abschnitt behandelt die Formatierung für individuelles Feedback für CSV und Excel-Dateien. Die Formatierung und die Anforderungen für beide Dateitypen sind identisch.
In CSV und Excel-Dateien werden digitale Interaktionen über mehrere Zeilen definiert. So funktioniert das System:
- Jede Zeile enthält eine einzelne Dialogzeile in einer Konversation zusammen mit Teilnehmer:in und einem Zeitstempel.
- Separate Zeilen, die zur selben Unterhaltung gehören, werden durch dieselbe Conversation-ID identifiziert.
- Konversationsweite Feldwerte (wie Dokumentdatum oder benutzerdefinierte Attribute) werden aus der ersten Zeile der Unterhaltung übernommen.
- Die Spaltenüberschriften sollten genau mit den Feldern in der folgenden Tabelle übereinstimmen.
Nachdem Sie Ihre Datei erstellt haben, sortieren Sie sie nach ConversationId Dadurch werden alle Zeilen einer bestimmten Interaktion gruppiert. Sortieren Sie die Datei anschließend nach ConversationTimestamp Die Gespräche sind also in chronologischer Reihenfolge.
Digitale Interaktionsfelder
| Spaltenkopf | Beschreibung |
| ConversationId
(Erforderlich) |
Eine eindeutige ID für die gesamte Unterhaltung. Jede Zeile mit derselben ID wird als separate Zeile innerhalb einer einzelnen Konversation behandelt.
Sie können dieses Feld der natural_id Attribut, 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 ist dies der Zeitpunkt, an dem das Gespräch beginnt. Verwenden Sie die ISO 8601 Format mit Sekundengenauigkeit.
Sie können dieses Feld der document_date Attribut es als Belegdatum zu verwenden. |
| Teilnehmer-ID
(Erforderlich) |
Die ID des Teilnehmer:in. Jeder eindeutige Teilnehmer:in in einer Unterhaltung muss eine andere ID haben.
Sie können dieselbe Teilnehmer:in in mehreren Konversationen haben (z.B. derselbe Agent über mehrere Interaktionen hinweg), aber innerhalb einer Unterhaltung kann sie nicht identisch sein. |
| Teilnehmerart
(Erforderlich) |
Der Typ des Teilnehmer:in. Mögliche Werte:
Diese Werte werden an die CB Teilnehmer:in Attribut für Berichterstellung und Visualisierung. Wenn nicht angegeben, CB Teilnehmer:in hat keinen berichtspflichtigen Wert. |
| is_bot
(optional) |
Ein boolesches Feld, das angibt, ob ein Teilnehmer:in ein Chatbot oder eine Person ist.
Diese Werte werden an die CB-Art des Teilnehmer:in Attribut für Berichterstellung und Visualisierung. Wenn nicht angegeben, CB-Art des Teilnehmer:in hat keinen berichtspflichtigen Wert. |
| Text
(Erforderlich) |
Der Text der Nachricht.
Achtung: Eine Summe aller Text Elemente dürfen 100.000 Zeichen nicht überschreiten. Ist dies der Fall, wird die Unterhaltung übersprungen.
|
| Zeitstempel
(Erforderlich) |
Das Datum und die Uhrzeit der Nachricht. Verwenden Sie die ISO 8601 Format mit Sekundengenauigkeit. |
| benutzerdefinierte Felder
(optional) |
Sie können mehrere Felder bereitstellen, um der Unterhaltung strukturierte Attribute hinzuzufügen. |
JSON 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 Unterhaltung.
Sie können dieses Feld der natural_id Attribut, 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 ist dies der Zeitpunkt, an dem das Gespräch beginnt. Verwenden Sie die ISO 8601 Format mit Sekundengenauigkeit.
Sie können dieses Feld der document_date Attribut es als Belegdatum zu verwenden. |
| Inhalt | Ein Objekt, das den Inhalt der Konversation enthält. Umfasst diese 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 Objekte beschrieben, die innerhalb von verschachtelt sind. Inhalt Objekt.
| Element | Beschreibung |
| Teilnehmer:innen | Eine Reihe von Objekten, die Informationen über die Teilnehmer der Unterhaltung bereitstellen. Umfasst die folgenden Felder:
|
| ConversationContent | Ein Array von Objekten, das die Zeilen der Konversation enthält. Umfasst die folgenden Felder:
|
Teilnehmer Objekt
In der folgenden Tabelle werden die Felder beschrieben, die innerhalb von verschachtelt sind. Teilnehmer Objekt.
| Element | Beschreibung |
| Teilnehmer-ID
(erforderlich) |
Die ID des Teilnehmer:in. Jeder eindeutige Teilnehmer:in in einer Unterhaltung muss eine andere ID haben.
Sie können dieselbe Teilnehmer:in in mehreren Konversationen haben (z.B. derselbe Agent über mehrere Interaktionen hinweg), aber innerhalb einer Unterhaltung kann sie nicht identisch sein. |
| Teilnehmerart
(Erforderlich) |
Der Typ des Teilnehmer:in. Mögliche Werte:
Diese Werte werden an die CB Teilnehmer:in Attribut für Berichterstellung und Visualisierung. Wenn nicht angegeben, CB Teilnehmer:in hat keinen berichtspflichtigen Wert. |
| is_bot
(optional) |
Ein boolesches Feld, das angibt, ob ein Teilnehmer:in ein Chat-Bot oder eine Person ist.
Diese Werte werden an die CB-Art des Teilnehmer:in Attribut für Berichterstellung und Visualisierung. Wenn nicht angegeben, CB-Art des Teilnehmer:in hat keinen berichtspflichtigen Wert. |
conversationContent-Objekt
In der folgenden Tabelle werden die Felder beschrieben, die innerhalb von verschachtelt sind. ConversationContent Objekt.
| Element | Beschreibung |
| Teilnehmer-ID
(Erforderlich) |
Die ID des Teilnehmer:in, der spricht. Muss mit einer der in angegebenen IDs übereinstimmen Teilnehmer Array. |
| Text
(Erforderlich) |
In: Speech transcript.
Achtung: Eine Summe aller Text Elemente dürfen 100.000 Zeichen nicht überschreiten. Ist dies der Fall, wird die Unterhaltung übersprungen.
|
| Zeitstempel
(Erforderlich) |
Das Datum und die Uhrzeit der Nachricht. Verwenden Sie die ISO 8601 Format mit Sekundengenauigkeit. |
| ID
(Erforderlich) |
Die eindeutige ID der Nachricht. |
JSON
Im Folgenden finden Sie ein Beispiel für ein Anrufprotokoll zwischen einem Agenten und einem Client.
[
{
"conversationId": "37852",
"conversationTimestamp": "2020-07-30T12:42:15.000Z",
"content": {
"Teilnehmer": [
{
"ParticipantId": "1",
"ParticipantType": "AGENT",
"is_bot": true
},
{
"ParticipantId": "2",
"ParticipantType": "CLIENT",
"is_bot": falsch
}
],
"conversationContent": [
{
"ParticipantId": "1",
"Text": "Hallo, wie kann ich Ihnen helfen?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785201"
},
{
"ParticipantId": "2",
"Text": "Hallo, hast du heute geöffnet?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785202"
},
{
"ParticipantId": "1",
"Text": "Wir sind von 17:00 bis 23:00 Uhr geöffnet.",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785203"
},
{
"ParticipantId": "2",
"text": "Ich möchte eine Reservierung machen.",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785204"
},
{
"ParticipantId": "1",
"text": "Auf jeden Fall! Welchen Namen kann ich verwenden?",
"timestamp": "2020-07-30T12:42:15.000Z",
"id": "3785205"
}
]
},
"Stadt": "Boston",
"Quelle": "Facebook"
}
]