Formatos de datos de feedback individual

Acerca de los formatos de datos de feedback individual

En XM Discover, el formato de opinión individual se utiliza para documentos que presentan datos como un objeto de una sola fila o “plano”. Cada documento puede contener varios campos literales, pero normalmente provienen de un único autor (por ejemplo, cuando una encuesta contiene más de una pregunta abierta).

Normalmente, un documento de comentarios individual contendría una serie de campos de datos estructurados y no estructurados que representan una única respuesta de un cliente (por ejemplo, una respuesta de encuesta o una revisión en línea). Los campos estructurados pueden contener fechas, números o datos de texto con un alto grado de organización (como nombres de marcas, ciudades u hoteles). Los campos no estructurados contienen notas, comentarios o respuestas a preguntas abiertas.

Puede cargar comentarios individuales a través de los siguientes formatos:

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

Formato CSV y Excel para opiniones individuales

En esta sección se trata el formato de los comentarios individuales para archivos CSV y Excel. El formato y los requisitos para ambos tipos de archivo son los mismos.

• Configuración de filas: asegúrese de que la primera fila de la hoja de cálculo contenga nombres de columna. Estos nombres se utilizarán como nombres de atributo y tipos textuales. Cada línea posterior se trata como un documento separado. Puede tener un máximo de 100.000 filas en un único archivo.
  Atención: No incluya filas vacías entre las entradas.
• Nombres de columna: cuando XM Discover convierte los nombres de columna en nombres de atributo, los ajusta automáticamente para que coincidan con el formato admitido eliminando los caracteres no admitidos y truncando los nombres de columna largos. Siga la siguiente guía:
  • Los nombres de clave solo deben contener letras inglesas (A-Z, a-z), números (0-9), guiones bajos (_), guiones (-), corchetes [] y espacios en blanco.
  • La longitud ideal del nombre de clave es de 21 caracteres o menos. Los nombres clave no deben superar los 99 caracteres, ya que los nombres más largos se truncarán automáticamente.
• Límites de tamaño máximo de archivo: los siguientes límites de tamaño de archivo están en su lugar:
  • Número máximo de filas: 100.000 filas.
  • Número máximo de columnas: 100 columnas con atributos y 20 columnas con feedback textual.
    Consejo Q: Este es un límite flexible para permitir el crecimiento del proyecto.
• Longitudes de campo máximas: Los siguientes límites se aplican a los valores de campo:
  • Atributos de texto: 900 caracteres. Si el valor supera este límite, se truncará automáticamente.
  • Atributos multivalor: 4.000 caracteres. Si el valor supera este límite, se truncará automáticamente.
  • Campos de Verbatim: 512.000 caracteres. Si el valor supera este límite, el registro se rechaza.
• Campos obligatorios: Se recomiendan los siguientes campos en su archivo:
  • Campo de fecha: Tener un campo de fecha en sus datos es crucial para la generación de informes o el análisis. El formato de fecha recomendado es AAAA-MM-DDThh:mm:ssZ.
    Consejo Q: Si su archivo no tiene una columna de fecha, puede generar fechas siguiendo las instrucciones en Configurar un nombre de documento específico.
  • ID único: si hay una columna con valores únicos para cada fila, puede utilizarla como ID naturales para sus documentos. Este campo es opcional, pero se recomienda encarecidamente, ya que le permite gestionar documentos duplicados.
    Consejo Q: Si su archivo no tiene una columna de ID única, puede generarla automáticamente siguiendo las instrucciones en Generación automática de ID naturales.

Formato JSON para feedback individual

Esta sección cubre los requisitos de formato JSON para comentarios individuales.

• Nombres clave: cuando XM Discover convierte los nombres clave en nombres de atributos y tipos textuales, los ajusta automáticamente para que coincidan con el formato admitido. Los nombres clave deben seguir estas directrices:
  • Los nombres de clave solo deben contener letras inglesas (A-Z, a-z), números (0-9), guiones bajos (_), guiones (-), corchetes [] y espacios en blanco.
  • La longitud ideal del nombre de clave es de 21 caracteres o menos. Los nombres de clave no deben superar los 99 caracteres, ya que los nombres más largos se truncarán.
• Objetos: su archivo JSON puede contener un único objeto o varios objetos.
  Atención: Hay un límite de 100.000 objetos en un único archivo JSON.
• Longitud de campo máxima: Los diferentes atributos tienen límites de longitud de valor diferentes:
  • Atributos de texto: Máximo 900 caracteres. Si el valor supera el límite, se truncará automáticamente.
  • Atributos de varios valores: Máximo 4.000 caracteres. Si el valor supera el límite, se truncará automáticamente.
  • Campos de Verbatim: Máximo 512.000 caracteres. Si el valor supera el límite, el registro se rechaza.
• Campos obligatorios: Se recomiendan los siguientes campos en su archivo:
  • Campo de fecha: Tener un campo de fecha en sus datos es crucial para la generación de informes o el análisis. El formato de fecha recomendado es AAAA-MM-DDThh:mm:ssZ.
    Consejo Q: Si su archivo no tiene una columna de fecha, puede generar fechas siguiendo las instrucciones en Configurar un nombre de documento específico.
  • ID único: si hay una columna con valores únicos para cada fila, puede utilizarla como ID naturales para sus documentos. Este campo es opcional, pero se recomienda encarecidamente, ya que le permite gestionar documentos duplicados.
    Consejo Q: Si su archivo no tiene una columna de ID única, puede generarla automáticamente siguiendo las instrucciones en Generación automática de ID naturales.

Ejemplo

A continuación se muestra un payload JSON de ejemplo para comentarios individuales.

[
{
"ID": "1001",
"SOURCE": "HotelSurveys",
"CITY": "New York City",
"HOTEL": "Sheraton New York Hotel and Towers",
"AUTHOR": "Richard",
"REVIEW": "Alojó una reunión aquí y tuvo una experiencia muy fina. Recomendaría encarecidamente.",
"GENDER": "M",
"LOYALTY LEVEL": "Gold",
"AGE": 51,
"CHECK-IN DATE": "2019-01-01T12:00:00Z",
"SCORE": 9
}