Report di integrazione

Informazioni sul rapporto sull’integrazione

Ogni giorno, il Customer Journey Optimizer esamina i sistemi collegati per assicurarsi che i dati vengano recuperati correttamente e compila i risultati in un report. Questo report visualizza un riepilogo dei dati importati per ogni sorgente in entrata, incluso se si sono verificati errori o se non sono stati importati dati quel giorno.

Sottoscrizione al report di integrazione

Per ricevere il rapporto di integrazione, devi contattare il tuo rappresentante delle implementazioni Qualtrics e chiedergli di configurare il rapporto da inviare. Quando contatti il tuo rappresentante, fornisci le tue preferenze sulla frequenza con cui desideri ricevere il rapporto e su chi dovrebbe riceverlo.

• Frequenza: di default, il report viene inviato una volta al giorno a mezzanotte PST. È possibile personalizzare la frequenza del rapporto da inviare in un’ora diversa del giorno o più volte al giorno.
• Pubblico: fornire l’indirizzo e-mail della persona che deve ricevere il rapporto. Al momento, il rapporto supporta solo l’invio a un indirizzo e-mail.
  Consiglio Q: se desideri inviare l’e-mail a più persone della tua organizzazione, ti consigliamo di lavorare con il tuo team IT per impostare un elenco di distribuzione che riceverà il report. Chiunque sia iscritto alla lista otterrà il report.
  Consiglio Q: il rapporto verrà inviato anche al rappresentante delle implementazioni Qualtrics.

Dati inclusi nel report

Ogni report contiene 2 tabelle che forniscono un riepilogo dei dati importati in quel giorno nell’ottimizzatore interazioni cliente. La parte superiore del rapporto conterrà avvisi sui potenziali problemi che potrebbero richiedere l’attenzione dell’utente.

Avvisi

Gli avvisi vengono visualizzati in giallo nella parte superiore del report. È necessario prestare molta attenzione ai messaggi di avvertimento per assicurarsi che eventuali problemi segnalati in essi vengano risolti.

Un avviso comune visualizzato è “0 nuove righe di dati importate nelle ultime 24 ore” per una determinata integrazione. Se si prevedono nuovi dati per questa integrazione ma non sono stati importati nuovi record, molto probabilmente si verifica un problema con la configurazione della connessione. Ricontrollare che la connessione sia configurata correttamente e che nel riepilogo dei dati siano presenti le entità corrette.

Tabella 1

La prima tabella del report fornisce una panoramica di ogni origine connessa. Le colonne nella tabella includono:

• Integrazione: il nome della connessione (ad esempio, “webhook” o “SFTP”).
• Nome entità: il nome dell’entità importata dalla connessione. Alcune connessioni possono avere più entità.
• Record validi: il numero di record validi importati.
• Record non riusciti: il numero di record che non è stato possibile importare.

Tabella 2

La seconda tabella del report fornisce maggiori dettagli sui singoli processi di recupero per ogni origine connessa. Le colonne nella tabella includono:

• Integrazione: il nome della connessione (ad esempio, “webhook” o “SFTP”).
• Nome entità: il nome dell’entità importata dalla connessione. Alcune connessioni possono avere più entità.
• ID esecuzione: l’ID interno Qualtrics di questa specifica esecuzione di recupero dati.
• Data: la data e l’ora di inizio del recupero dei dati.
• Stato: lo stato dell’esecuzione. I valori includono:
  • Completed_NR: il job è stato completato senza problemi.
  • Failed_NR: completamento del processo non riuscito. Consultare la colonna Messaggi di errore per ulteriori informazioni sull’errore.
• Messaggi di errore: se i record non sono stati importati, il motivo dell’errore. Per ulteriori informazioni, consultare Risoluzione dei messaggi di errore.

Risoluzione dei messaggi di errore

Questa sezione descrive i messaggi di errore comuni e come risolverli.

La chiave primaria configurata dell’entità ‘<field name> ‘ manca nel record

Questo messaggio di errore indica che nel record che si è tentato di importare in Qualtrics manca la chiave primaria. Quando si importano record, questi devono avere la chiave primaria così come definita nello schema dati di quell’entità.

Impossibile elaborare ‘<date value> ‘ in ‘<field name> ‘ perché ha un formato data non valido

Questo errore indica che è stato tentato di importare un campo data in Qualtrics, ma non è riuscito perché ha un formato data non valido. Ricontrollare il campo per assicurarsi che la data sia nel formato ISO-8601.

‘<Data Type> ‘ è un tipo di dati non supportato e deve essere sostituito con un tipo di dati valido

Questo errore viene visualizzato quando si tenta di importare un tipo di dati non supportato dall’ottimizzatore interazioni cliente (ad esempio, matrici). Aggiornare il campo in modo che sia un tipo di dati supportato, come definito nello schema dati dell’entità.

Lettura dell’attribuzione schema non riuscita (Webhook)

Questo errore viene visualizzato quando si tenta di importare record da un webhook. Per risolvere questo problema, consultare la sezione “schemaFields” del payload webhook e assicurarsi che i nomi dei campi schema corrispondano ai campi client in nome e maiuscole/minuscole. Inoltre, assicurarsi che i campi non contengano caratteri non validi.