Formatos de dados de feedback individual

Sobre formatos de dados de feedback individual

No XM Discover, o formato de feedback individual é usado para documentos que apresentam dados como uma única linha ou objeto “plano”. Cada documento pode conter vários campos literais, mas geralmente eles vêm de um único autor (por exemplo, quando uma pesquisa contém mais de uma pergunta aberta).

Normalmente, um documento de feedback individual conteria vários campos de dados estruturados e não estruturados que representam uma única resposta de um cliente (por exemplo, uma resposta pesquisa ou uma avaliação on-line). Os campos estruturados podem conter datas, números ou dados de texto com um alto grau de organização (como nomes de marcas, cidades ou hotéis). Os campos não estruturados contêm notas, comentários ou respostas a perguntas abertas.

Você pode fazer upload de comentários individuais nos seguintes formatos:

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

Formatação de CSV e Excel para feedback individual

Esta seção aborda a formatação de feedback individual para arquivos CSV e Excel. A formatação e os requisitos para ambos os tipos de arquivo são os mesmos.

• Configuração de linhas: Certifique-se de que a primeira linha da planilha contenha os nomes das colunas. Esses nomes serão usados como nomes atributo e tipos literais. Cada linha subsequente é tratada como um documento separado. É possível ter um máximo de 100.000 linhas em um único arquivo.
  Atenção: Não inclua nenhuma linha vazia entre as entradas.
• Nomes de colunas: Quando XM Discover converte nomes de colunas em nomes atributo, ele os ajusta automaticamente para que correspondam ao formato suportado, removendo caracteres não suportados e truncando nomes de colunas longos. Siga as orientações abaixo:
  • Os nomes das chaves devem conter apenas letras em inglês (A-Z, a-z), números (0-9), sublinhados (_), traços (-), colchetes [] e espaços em branco.
  • O comprimento ideal do nome da chave é de 21 caracteres ou menos. Os nomes das chaves não devem exceder 99 caracteres, pois nomes mais longos serão automaticamente truncados.
• Limites máximos de tamanho de arquivo: Os seguintes limites de tamanho de arquivo estão em vigor:
  • Número máximo de linhas: 100.000 linhas.
  • Número máximo de colunas: 100 colunas com atributos e 20 colunas com feedback literal.
    Qdica: esse é um limite flexível para permitir o crescimento do projeto.
• Comprimentos máximos de campo: Os limites a seguir aplicar aos valores de campo:
  • Atributos de texto: 900 caracteres. Se o valor exceder esse limite, ele será automaticamente truncado.
  • Atributos multivalorados: 4.000 caracteres. Se o valor exceder esse limite, ele será automaticamente truncado.
  • Campos textuais: 512.000 caracteres. Se o valor exceder esse limite, o registro será rejeitado.
• Campos obrigatórios: Os seguintes campos são recomendados em seu arquivo:
  • Campo de data: Ter um campo de data em seus dados é crucial para relatórios ou análises. O formato de data recomendado é AAAA-MM-DDThh:mm:ssZ.
    Qdica: se o seu arquivo não tiver uma coluna de data, você poderá gerar datas seguindo as instruções em Definir um nome de documento específico.
  • ID exclusivo: se houver uma coluna com valores exclusivos para cada linha, você poderá usá-la como IDs naturais para seus documentos. Esse campo é opcional, mas altamente recomendado, pois permite que você gerencie documentos duplicar.
    Qdica: se o seu arquivo não tiver uma coluna de ID exclusiva, você poderá gerá-la automaticamente seguindo as instruções em Geração automática de IDs naturais.

Formatação JSON para feedback individual

Esta seção aborda os requisitos de formatação JSON para feedback individual.

• Nomes de chave: Quando XM Discover converte nomes de chaves em nomes atributo e tipos literais, ele os ajusta automaticamente para corresponder ao formato suportado. Os nomes-chave devem seguir estas diretrizes:
  • Os nomes das chaves devem conter apenas letras em inglês (A-Z, a-z), números (0-9), sublinhados (_), traços (-), colchetes [] e espaços em branco.
  • O comprimento ideal do nome da chave é de 21 caracteres ou menos. Os nomes das chaves não devem exceder 99 caracteres, pois nomes mais longos serão truncados.
• Objetos: Seu arquivo JSON pode conter um único objeto ou vários objetos.
  Atenção: Há um limite de 100.000 objetos em um único arquivo JSON.
• Comprimento máximo do campo: Atributos diferentes têm limites de comprimento de valores diferentes:
  • Atributos de texto: Máximo de 900 caracteres. Se o valor exceder o limite, ele será automaticamente truncado.
  • Atributos multivalorados: Máximo de 4.000 caracteres. Se o valor exceder o limite, ele será automaticamente truncado.
  • Campos textuais: Máximo de 512.000 caracteres. Se o valor exceder o limite, o registro será rejeitado.
• Campos obrigatórios: Os seguintes campos são recomendados em seu arquivo:
  • Campo de data: Ter um campo de data em seus dados é crucial para relatórios ou análises. O formato de data recomendado é AAAA-MM-DDThh:mm:ssZ.
    Qdica: se o seu arquivo não tiver uma coluna de data, você poderá gerar datas seguindo as instruções em Definir um nome de documento específico.
  • ID exclusivo: se houver uma coluna com valores exclusivos para cada linha, você poderá usá-la como IDs naturais para seus documentos. Esse campo é opcional, mas altamente recomendado, pois permite que você gerencie documentos duplicar.
    Qdica: se o seu arquivo não tiver uma coluna de ID exclusiva, você poderá gerá-la automaticamente seguindo as instruções em Geração automática de IDs naturais.

Exemplo

Abaixo está um exemplo de carga útil JSON para feedback individual.

[
{
"ID": "1001",
"SOURCE": "HotelSurveys",
"CITY": "New York City",
"HOTEL": "Sheraton New York Hotel and Towers",
"AUTOR": "Richard",
"REVISÃO": "Organizei uma reunião aqui e tive uma experiência muito boa. Recomendaria muito.",
"GENDER": "M",
"LOYALTY NÍVEL": "Gold",
"AGE": 51,
"CHECK-IN DATE": "2019-01-01T12:00:00Z",
"SCORE": 9
}
]