Formats des données de feedback individuel

À propos des formats de données de feedback individuel

Dans XM Discover, le format de feedback individuel est utilisé pour les documents qui présentent les données sous la forme d’un objet à une seule ligne ou “plat”. Chaque document peut contenir plusieurs champs textuels, mais ils proviennent généralement d’un seul auteur (par exemple, lorsqu’une enquête contient plusieurs questions ouvertes).

En règle générale, un document de feedback individuel contient un certain nombre de zones de données structurées et non structurées qui représentent une réponse unique d’un client (par exemple, une réponse à une enquête ou une revue en ligne). Les champs structurés peuvent contenir des dates, des chiffres ou des données de texte avec un degré élevé d’organisation (comme les noms des marques, des villes ou des hôtels). Les champs non structurés contiennent des remarques, des commentaires ou des réponses à des questions ouvertes.

Vous pouvez charger un feedback individuel aux formats suivants :

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

Formatage CSV et Excel pour les avis individuels

Cette section traite de la mise en forme des avis individuels pour les fichiers CSV et Excel. La mise en forme et les exigences pour les deux types de fichiers sont identiques.

• Configuration des lignes : assurez-vous que la première ligne de votre feuille de calcul contient des noms de colonnes. Ces noms seront utilisés comme noms d’attributs et types verbatim. Chaque ligne suivante est traitée comme un document distinct. Vous pouvez avoir un maximum de 100 000 lignes dans un seul fichier.
  Attention : n’incluez aucune ligne vide entre les entrées.
• Noms de colonnes : lorsque XM Discover convertit les noms de colonnes en noms d’attributs, il les ajuste automatiquement pour correspondre au format pris en charge en supprimant les caractères non pris en charge et en tronquant les noms de colonnes longs. Suivez les instructions ci-dessous :
  • Les noms clés doivent uniquement contenir des lettres anglaises (A-Z, a-z), des chiffres (0-9), des traits de soulignement (_), des tirets (-), des crochets [] et des espaces.
  • La longueur idéale du nom de clé est de 21 caractères ou moins. Les noms de clés ne doivent pas dépasser 99 caractères car les noms plus longs seront automatiquement tronqués.
• Limites maximales de taille de fichier : Les limites de taille de fichier suivantes sont en place :
  • Nombre maximal de lignes : 100 000 lignes.
  • Nombre maximal de colonnes : 100 colonnes avec des attributs et 20 colonnes avec des commentaires verbatim.
    Astuce Qualtrics : il s’agit d’une limite souple pour permettre la croissance du projet.
• Longueur de zone maximale : les limites suivantes s’appliquent aux valeurs de zone :
  • Attributs de texte : 900 caractères. Si la valeur dépasse cette limite, elle est automatiquement tronquée.
  • Attributs multivaleurs : 4 000 caractères. Si la valeur dépasse cette limite, elle est automatiquement tronquée.
  • Champs de verbatim : 512 000 caractères. Si la valeur dépasse cette limite, l’enregistrement est refusé.
• Champs obligatoires : les champs suivants sont recommandés dans votre fichier :
  • Champ de date : il est essentiel d’avoir un champ de date dans vos données pour le reporting ou l’analyse. Le format de date recommandé est AAAA-MM-JJThh:mm:ssZ.
    Astuce Qualtrics : si votre fichier ne comporte pas de colonne de date, vous pouvez générer des dates en suivant les instructions relatives à la définition d’un nom de document spécifique.
  • ID unique : s’il existe une colonne avec des valeurs uniques pour chaque ligne, vous pouvez l’utiliser comme ID naturels pour vos documents. Cette zone est facultative, mais fortement recommandée car elle vous permet de gérer les documents en double.
    Astuce Qualtrics : si votre fichier ne comporte pas de colonne ID unique, vous pouvez les générer automatiquement en suivant les instructions relatives à la génération automatique d’ID naturels.

Mise en forme JSON pour feedback individuel

Cette section couvre les exigences de mise en forme JSON pour les commentaires individuels.

• Noms de clés : lorsque XM Discover convertit les noms de clés en noms d’attributs et en types verbatim, il les ajuste automatiquement pour correspondre au format pris en charge. Les noms clés doivent suivre ces directives :
  • Les noms clés doivent uniquement contenir des lettres anglaises (A-Z, a-z), des chiffres (0-9), des traits de soulignement (_), des tirets (-), des crochets [] et des espaces.
  • La longueur idéale du nom de clé est de 21 caractères ou moins. Les noms de clés ne doivent pas dépasser 99 caractères car les noms plus longs seront tronqués.
• Objets : votre fichier JSON peut contenir un seul objet ou plusieurs objets.
  Attention : il existe une limite de 100 000 objets dans un seul fichier JSON.
• Longueur de zone maximale : différents attributs ont des limites de longueur de valeur différentes :
  • Attributs de texte : 900 caractères maximum. Si la valeur dépasse la limite, elle est automatiquement tronquée.
  • Attributs multivaleurs : 4 000 caractères maximum. Si la valeur dépasse la limite, elle est automatiquement tronquée.
  • Champs de verbatim : maximum 512 000 caractères. Si la valeur dépasse la limite, l’enregistrement est rejeté.
• Champs obligatoires : les champs suivants sont recommandés dans votre fichier :
  • Champ de date : il est essentiel d’avoir un champ de date dans vos données pour le reporting ou l’analyse. Le format de date recommandé est AAAA-MM-JJThh:mm:ssZ.
    Astuce Qualtrics : si votre fichier ne comporte pas de colonne de date, vous pouvez générer des dates en suivant les instructions relatives à la définition d’un nom de document spécifique.
  • ID unique : s’il existe une colonne avec des valeurs uniques pour chaque ligne, vous pouvez l’utiliser comme ID naturels pour vos documents. Cette zone est facultative, mais fortement recommandée car elle vous permet de gérer les documents en double.
    Astuce Qualtrics : si votre fichier ne comporte pas de colonne ID unique, vous pouvez les générer automatiquement en suivant les instructions relatives à la génération automatique d’ID naturels.

Exemple

Vous trouverez ci-dessous un exemple de données utiles JSON pour les commentaires individuels.

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