Formatos de dados de feedback individuais

Sobre formatos de dados de feedback individuais

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 resposta única de um cliente (por exemplo, uma resposta de pesquisa ou uma revisã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 carregar feedback individual por meio dos seguintes formatos:

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

Formatação CSV e Excel para feedback individual

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

• Configuração de linhas: verifique se a primeira linha da planilha contém nomes de colunas. Esses nomes serão usados como nomes de atributos e tipos textuais. Cada linha subsequente é tratada como um documento separado. Você pode ter um máximo de 100.000 linhas em um único arquivo.
  Atenção: não inclua linhas vazias entre as entradas.
• Nomes de colunas: quando o XM Discover converte nomes de coluna em nomes de atributo, ele os ajusta automaticamente para corresponder ao formato suportado, removendo caracteres não suportados e truncando nomes de colunas longas. Siga as orientações abaixo:
  • Os nomes de chave só devem conter letras inglesas (A-Z, a-z), números (0-9), sublinhados (_), traços (-), colchetes [] e espaços em branco.
  • O comprimento ideal do nome da chave é 21 caracteres ou mais curto. Os nomes de chave não devem exceder 99 caracteres, pois os 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: Este é um limite suave para permitir o crescimento do projeto.
• Comprimento máximo de campo: os seguintes limites se aplicam a valores de campo:
  • Atributos de texto: 900 caracteres. Se o valor exceder esse limite, ele será automaticamente truncado.
  • Atributos multivariados: 4.000 caracteres. Se o valor exceder esse limite, ele será automaticamente truncado.
  • Campos de contexto: 512.000 caracteres. Se o valor exceder esse limite, o registro é 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 seu arquivo não tiver uma coluna de data, você poderá gerar datas seguindo as instruções em Configuração de um nome de documento específico.
  • Código exclusivo: se houver uma coluna com valores exclusivos para cada linha, você poderá usá-la como códigos naturais para seus documentos. Este campo é opcional, mas altamente recomendado, uma vez que permite que você gerencie documentos duplicados.
    Qdica: se seu arquivo não tiver uma coluna de ID exclusivo, você poderá gerá-los automaticamente seguindo as instruções em Geração automática de IDs naturais.

Formatação JSON para feedback individual

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

• Nomes de chave: quando o XM Discover converte nomes de chave em nomes de atributos e tipos textuais, ele os ajusta automaticamente para corresponder ao formato suportado. Os principais nomes devem seguir estas diretrizes:
  • Os nomes de chave só devem conter letras inglesas (A-Z, a-z), números (0-9), sublinhados (_), traços (-), colchetes [] e espaços em branco.
  • O comprimento ideal do nome da chave é 21 caracteres ou mais curto. Os nomes de chave 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: existe um limite de 100.000 objetos em um único arquivo JSON.
• Comprimento máximo do campo: atributos diferentes têm limites de comprimento de valor diferentes:
  • Atributos de texto: no máximo 900 caracteres. Se o valor exceder o limite, ele será automaticamente truncado.
  • Atributos de valores múltiplos: máximo de 4.000 caracteres. Se o valor exceder o limite, ele será automaticamente truncado.
  • Campos de contexto: máximo de 512.000 caracteres. Se o valor exceder o limite, o registro é 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 seu arquivo não tiver uma coluna de data, você poderá gerar datas seguindo as instruções em Configuração de um nome de documento específico.
  • Código exclusivo: se houver uma coluna com valores exclusivos para cada linha, você poderá usá-la como códigos naturais para seus documentos. Este campo é opcional, mas altamente recomendado, uma vez que permite que você gerencie documentos duplicados.
    Qdica: se seu arquivo não tiver uma coluna de ID exclusivo, você poderá gerá-los automaticamente seguindo as instruções em Geração automática de IDs naturais.

Exemplo

Abaixo está um exemplo de payload JSON para feedback individual.

[
{
"ID": "1001",
"SOURCE": "HotelSurveys",
"CITY": "New York City",
"HOTEL": "Sheraton New York Hotel and Towers",
"AUTHOR": "Richard",
"REVIEW": "Hospedou uma reunião aqui e teve uma experiência muito boa. Gostaria de recomendar altamente.",
"GENDER": "M",
"LOYALTY LEVEL": "Gold",
"AGE": 51,
"CHECK-IN DATE": "2019-01-01T12:00:00Z",
"SCORE": 9