Datenformate für digitale Interaktionen
Was finden Sie hier?
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.
Sobald Sie Ihre Datei erstellt haben, sortieren Sie sie nach „conversationId“, damit alle Zeilen einer bestimmten Interaktion zusammengefasst werden. 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 dem Attribut „natural_id“ zuordnen, um es als „Natural 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 dem Attribut „document_date“ zuordnen, um es als Dokumentdatum 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-ID über mehrere Konversationen hinweg verwenden (z. B. denselben Mitarbeiter über viele Interaktionen hinweg), innerhalb einer Konversation darf sie jedoch nicht identisch sein. |
Teilnehmerart (Erforderlich) | Der Typ des Teilnehmer:in. Mögliche Werte:
Diese Werte werden zur Berichterstellung und zur Darstellung der Teilnehmer an das Attribut „CB-Teilnehmertyp“ weitergegeben. Sofern nicht anders angegeben, weist der CB-Teilnehmertyp keinen meldepflichtigen Wert auf. |
is_bot (Optional) | Ein boolesches Feld, das angibt, ob ein Teilnehmer:in ein Chatbot oder eine Person ist.
Diese Werte werden an das CB -Attribut „Teilnehmertyp“ weitergeleitet, um sie für die Berichterstellung und die Visualisierung der Teilnehmer zu nutzen. Sofern nicht anders angegeben, weist das Feld „CB-Teilnehmertyp“ keinen meldepflichtigen Wert auf. |
text (Erforderlich) | Der Text der Nachricht.
|
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
Dieser Abschnitt enthält die 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 dem Attribut „natural_id“ zuordnen, um es als „Natural 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 dem Attribut „document_date“ zuordnen, um es als Dokumentdatum 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 im Inhaltsobjekt verschachtelten Objekte beschrieben.
| 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 im Objekt „participants“ verschachtelten Felder beschrieben.
| 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-ID über mehrere Konversationen hinweg verwenden (z. B. denselben Mitarbeiter über viele Interaktionen hinweg), innerhalb einer Konversation darf sie jedoch nicht identisch sein. |
Teilnehmerart (Erforderlich) | Der Typ des Teilnehmer:in. Mögliche Werte:
Diese Werte werden zur Berichterstellung und zur Darstellung der Teilnehmer an das Attribut „CB-Teilnehmertyp“ weitergegeben. Sofern nicht anders angegeben, weist der CB-Teilnehmertyp keinen meldepflichtigen Wert auf. |
is_bot (Optional) | Ein boolesches Feld, das angibt, ob ein Teilnehmer:in ein Chat-Bot oder eine Person ist.
Diese Werte werden an das CB -Attribut „Teilnehmertyp“ weitergeleitet, um sie für die Berichterstellung und die Visualisierung der Teilnehmer zu nutzen. Sofern nicht anders angegeben, weist das Feld „CB-Teilnehmertyp“ keinen meldepflichtigen Wert auf. |
conversationContent-Objekt
In der folgenden Tabelle werden die Felder beschrieben, die im Objekt „conversationContent“ verschachtelt sind.
| 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.
|
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
Hier ist ein Beispiel für ein Gesprächsprotokoll zwischen einem Mitarbeiter und einem Kunden.
[{"conversationId": "37852","conversationTimestamp": "2020-07-30T12:42:15.000Z","content": {"participants": [{"participantId": "1","participantType": "AGENT","is_bot": true},{"participantId": "2","participantType": "CLIENT","is_bot": false}],"conversationContent": [{"participantId": "1","text": "Hallo, wie kann ich Ihnen helfen?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785201"},{"participantId": "2","text": "Hallo, habt ihr heute geöffnet?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785202"},{"participantId": "1","text": "Wir haben 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 vornehmen.","timestamp": "2020-07-30T12:42:15.000Z","id": "3785204"},{"participantId": "1","text": "Aber sicher! Welchen Namen kann ich verwenden?","timestamp": "2020-07-30T12:42:15.000Z","id": "3785205"}]},"city": "Boston","source": "Facebook"}]
Großartig! Vielen Dank für die Rückmeldung!
Vielen Dank für die Rückmeldung!