Individuelle Feedback-Datenformate

Informationen zu individuellen Feedback-Datenformaten

In XM Discover wird das individuelle Feedback-Format 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).

In der Regel enthält ein individuelles Feedbackdokument eine Reihe strukturierter und unstrukturierter Datenfelder, die eine einzelne Antwort eines Kunden darstellen (z. B. eine Umfrageantwort oder eine Online-Überprüfung). Strukturierte Felder können Datums-, Zahlen- oder Textdaten mit einem hohen Grad an Organisation enthalten (z.B. Namen von Marken, Städten oder Hotels). Unstrukturierte Felder enthalten Hinweise, Kommentare oder Antworten auf offene Fragen.

Sie können individuelles Feedback über die folgenden Formate hochladen:

• CSV
• XLS oder XLSX (Microsoft Excel)
• JSON

CSV- und Excel-Formatierung für individuelles Feedback

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.

• Zeileneinrichtung: Stellen Sie sicher, dass die erste Zeile Ihrer Tabellenkalkulation Spaltennamen enthält. Diese Namen werden als Attributnamen und verbale Typen verwendet. Jede nachfolgende Zeile wird als separater Beleg behandelt. Sie können maximal 100.000 Zeilen in einer einzelnen Datei haben.
  Achtung: Fügen Sie keine leeren Zeilen zwischen den Einträgen ein.
• Spaltennamen: Wenn XM Discover Spaltennamen in Attributnamen konvertiert, werden sie automatisch an das unterstützte Format angepasst, indem nicht unterstützte Zeichen entfernt und lange Spaltennamen abgeschnitten werden. Befolgen Sie die folgende Anleitung:
  • Schlüsselnamen dürfen nur englische Buchstaben (A-Z, a-z), Zahlen (0-9), Unterstriche (_), Bindestriche (-), eckige Klammern [] und Leerzeichen enthalten.
  • Die ideale Länge des Schlüsselnamens beträgt 21 Zeichen oder kürzer. Schlüsselnamen dürfen 99 Zeichen nicht überschreiten, da längere Namen automatisch abgeschnitten werden.
• Maximale Dateigrößenbeschränkungen: Die folgenden Dateigrößenbeschränkungen sind vorhanden:
  • Maximale Zeilenanzahl: 100.000 Zeilen.
  • Maximale Spaltenanzahl: 100 Spalten mit Attributen und 20 Spalten mit ausführlichem Feedback.
    Tipp: Dies ist eine weiche Grenze für das Projektwachstum.
• Maximale Feldlängen: Für Feldwerte gelten folgende Grenzen:
  • Textattribute: 900 Zeichen. Wenn der Wert diesen Grenzwert überschreitet, wird er automatisch abgeschnitten.
  • Mehrwertige Attribute: 4.000 Zeichen. Wenn der Wert diesen Grenzwert überschreitet, wird er automatisch abgeschnitten.
  • Verbatim-Felder: 512.000 Zeichen. Wenn der Wert diese Grenze überschreitet, wird der Datensatz abgelehnt.
• Erforderliche Felder: Die folgenden Felder werden in Ihrer Datei empfohlen:
  • Datumsfeld: Ein Datumsfeld in Ihren Daten ist für das Reporting oder die Analyse von entscheidender Bedeutung. Das empfohlene Datumsformat ist JJJJ-MM-TTThh:mm:ssZ.
    Tipp: Wenn Ihre Datei keine Datumsspalte enthält, können Sie Datumsangaben generieren, indem Sie den Anweisungen unter Festlegen eines bestimmten Dokumentnamens folgen.
  • Eindeutige ID: Wenn es für jede Zeile eine Spalte mit eindeutigen Werten gibt, können Sie sie als natürliche IDs für Ihre Dokumente verwenden. Dieses Feld ist optional, wird jedoch dringend empfohlen, da es Ihnen ermöglicht, doppelte Dokumente zu verwalten.
    Tipp: Wenn Ihre Datei keine eindeutige ID-Spalte enthält, können Sie sie automatisch generieren, indem Sie den Anweisungen unter Automatische Generierung natürlicher IDs folgen.

JSON-Formatierung für individuelles Feedback

In diesem Abschnitt werden die JSON-Formatierungsanforderungen für individuelles Feedback behandelt.

• Schlüsselnamen: Wenn XM Discover Schlüsselnamen in Attributnamen und ausführliche Datentypen konvertiert, werden sie automatisch an das unterstützte Format angepasst. Schlüsselnamen sollten den folgenden Richtlinien entsprechen:
  • Schlüsselnamen dürfen nur englische Buchstaben (A-Z, a-z), Zahlen (0-9), Unterstriche (_), Bindestriche (-), eckige Klammern [] und Leerzeichen enthalten.
  • Die ideale Länge des Schlüsselnamens beträgt 21 Zeichen oder kürzer. Schlüsselnamen dürfen 99 Zeichen nicht überschreiten, da längere Namen abgeschnitten werden.
• Objekte: Ihre JSON-Datei kann entweder ein einzelnes Objekt oder mehrere Objekte enthalten.
  Achtung: Es gibt ein Limit von 100.000 Objekten in einer einzelnen JSON-Datei.
• Maximale Feldlänge: Unterschiedliche Attribute haben unterschiedliche Wertlängengrenzen:
  • Textattribute: Maximal 900 Zeichen. Wenn der Wert den Grenzwert überschreitet, wird er automatisch abgeschnitten.
  • Mehrwertige Attribute: Maximal 4.000 Zeichen. Wenn der Wert den Grenzwert überschreitet, wird er automatisch abgeschnitten.
  • Ausführliche Felder: Maximal 512.000 Zeichen. Wenn der Wert das Limit überschreitet, wird der Datensatz abgelehnt.
• Erforderliche Felder: Die folgenden Felder werden in Ihrer Datei empfohlen:
  • Datumsfeld: Ein Datumsfeld in Ihren Daten ist für das Reporting oder die Analyse von entscheidender Bedeutung. Das empfohlene Datumsformat ist JJJJ-MM-TTThh:mm:ssZ.
    Tipp: Wenn Ihre Datei keine Datumsspalte enthält, können Sie Datumsangaben generieren, indem Sie den Anweisungen unter Festlegen eines bestimmten Dokumentnamens folgen.
  • Eindeutige ID: Wenn es für jede Zeile eine Spalte mit eindeutigen Werten gibt, können Sie sie als natürliche IDs für Ihre Dokumente verwenden. Dieses Feld ist optional, wird jedoch dringend empfohlen, da es Ihnen ermöglicht, doppelte Dokumente zu verwalten.
    Tipp: Wenn Ihre Datei keine eindeutige ID-Spalte enthält, können Sie sie automatisch generieren, indem Sie den Anweisungen unter Automatische Generierung natürlicher IDs folgen.

Beispiel

Nachfolgend finden Sie eine Beispiel-JSON-Payload für individuelles Feedback.

[
{
"ID": "1001",
"SOURCE": "HotelSurveys",
"CITY": "New York City",
"HOTEL": "Sheraton New York Hotel and Towers",
"AUTHOR": "Richard",
"REVIEW": "Hosted a meeting here and had a very fine erfahrung. Wäre sehr empfehlenswert.",
"GENDER": "M",
"LOYALTY LEVEL": "Gold",
"AGE": 51,
"CHECK-IN DATE": "2019-01-01T12:00:00Z",
"SCORE": 9
}