Modello di articolo

Informazioni sui formati dei dati di feedback individuali

In XM DISCOVER, il formato di feedback individuale viene utilizzato per i documenti che presentano i dati come un oggetto a riga singola o “piatto”. Ogni documento può contenere diversi campi verbatim, ma di solito provengono da un’unica autorità (ad esempio, quando un sondaggio contiene più di una domanda a risposta aperta).

In genere, un documento di feedback individuale contiene una serie di campi dati strutturati e non strutturati che rappresentano una singola risposta da parte di un cliente (ad esempio, una risposta a un sondaggio o un valutatore online). I campi strutturati possono contenere date, numeri o dati testuali con un alto grado di organizzazione (come nomi di brand, città o hotel). I campi non strutturati contengono note, commenti o risposte a domande aperte.

È possibile caricare feedback individuali nei seguenti formati:

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

Formattazione CSV ed Excel per il feedback individuale

Questa sezione tratta la formattazione dei feedback individuali per i file CSV ed Excel. La formattazione e i requisiti per entrambi i tipi di file sono gli stessi.

• Impostazione delle righe: Assicurarsi che la prima riga del foglio di calcolo contenga i nomi delle colonne. Questi nomi saranno usati come nomi di attributi e tipi verbali. Ogni riga successiva viene trattata come un documento separato. È possibile avere un massimo di 100.000 righe in un singolo file.
  Attenzione: Non includere righe vuote tra le voci.
• Nomi di colonna: Quando XM Discover converte i nomi delle colonne in nomi di attributi, li regola automaticamente per adattarli al formato supportato, rimuovendo i caratteri non supportati e troncando i nomi delle colonne lunghi. Seguire le indicazioni riportate di seguito:
  • I nomi delle chiavi devono contenere solo lettere inglesi (A-Z, a-z), numeri (0-9), trattini (_), trattini (-), parentesi quadre [] e spazi bianchi.
  • La lunghezza ideale del nome della chiave è di 21 caratteri o meno. I nomi delle chiavi non devono superare i 99 caratteri, poiché i nomi più lunghi verranno automaticamente troncati.
• Limiti di dimensione massima dei file: Sono in vigore i seguenti limiti di dimensione dei file:
  • Numero massimo di righe: 100.000 righe.
  • Numero massimo di colonne: 100 colonne con attributi e 20 colonne con feedback verbali.
    Consiglio Q: si tratta di un limite morbido per consentire la crescita del progetto.
• Lunghezza massima dei campi: ai valori dei campi si applicano i seguenti limiti:
  • Attributi di testo: 900 caratteri. Se il valore supera questo limite, viene automaticamente troncato.
  • Attributi multivariati: 4.000 caratteri. Se il valore supera questo limite, viene automaticamente troncato.
  • Campi verbatim: 512.000 caratteri. Se il valore supera questo limite, il record viene rifiutato.
• Campi obbligatori: I seguenti campi sono consigliati nel file:
  • Campo data: La presenza di un campo data nei dati è fondamentale per i rapporti o le analisi. Il formato di data consigliato è AAAA-MM-DDThh:mm:ssZ.
    Consiglio Q: se il file non ha una colonna di date, è possibile generare date seguendo le istruzioni su Impostazione di un nome specifico del documento.
  • ID univoco: se esiste una colonna con valori univoci per ogni riga, è possibile utilizzarla come ID naturale per i documenti. Questo campo è facoltativo, ma altamente consigliato in quanto consente di gestire i documenti duplicati.
    Consiglio Q: se il file non ha una colonna di ID univoco, è possibile generarlo automaticamente seguendo le istruzioni su Generazione automatica di ID naturali.

Formattazione JSON per il feedback individuale

Questa sezione tratta i requisiti di formattazione JSON per i feedback individuali.

• Nomi delle chiavi: Quando XM DISCOVER converte i nomi delle chiavi in nomi di attributi e tipi verbatim, li adatta automaticamente al formato supportato. I nomi delle chiavi devono seguire queste linee guida:
  • I nomi delle chiavi devono contenere solo lettere inglesi (A-Z, a-z), numeri (0-9), trattini (_), trattini (-), parentesi quadre [] e spazi bianchi.
  • La lunghezza ideale del nome della chiave è di 21 caratteri o meno. I nomi delle chiavi non devono superare i 99 caratteri, poiché i nomi più lunghi saranno troncati.
• Oggetti: Il file JSON può contenere un singolo oggetto o più oggetti.
  Attenzione: C’è un limite di 100.000 oggetti in un singolo file JSON.
• Lunghezza massima del campo: I diversi attributi hanno limiti di lunghezza dei valori diversi:
  • Attributi di testo: Massimo 900 caratteri. Se il valore supera il limite, viene automaticamente troncato.
  • Attributi multivalore: Massimo 4.000 caratteri. Se il valore supera il limite, viene automaticamente troncato.
  • Campi verbatim: Massimo 512.000 caratteri. Se il valore supera il limite, il record viene rifiutato.
• Campi obbligatori: I seguenti campi sono consigliati nel file:
  • Campo data: La presenza di un campo data nei dati è fondamentale per i rapporti o le analisi. Il formato di data consigliato è AAAA-MM-DDThh:mm:ssZ.
    Consiglio Q: se il file non ha una colonna di data, è possibile generare le date seguendo le istruzioni su Impostazione di un nome di documento specifico.
  • ID univoco: se esiste una colonna con valori univoci per ogni riga, è possibile utilizzarla come ID naturale per i documenti. Questo campo è facoltativo, ma altamente consigliato in quanto consente di gestire i documenti duplicati.
    Consiglio Q: se il file non ha una colonna di ID univoco, è possibile generarlo automaticamente seguendo le istruzioni su Generazione automatica di ID naturali.

Esempio

Di seguito è riportato un esempio di payload JSON per un feedback individuale.

[
{
"ID": "1001",
"FONTE": "HotelSurveys",
"CITY": "New York City",
"HOTEL": "Sheraton New York Hotel and Towers",
"AUTORITÀ": "Richard",
"VALUTATORE": "Ho ospitato qui una riunione e ho avuto un'ottima esperienza. Lo consiglio vivamente",
"GENDER": "M",
"LIVELLO DI FEDELTA'": "Oro",
"Età": 51,
"DATA DEL CHECK-IN": "2019-01-01T12:00:00Z",
"PUNTEGGIO": 9
}
]