Aggiungere contatti e transazioni al task XMD

Informazioni sul task Aggiungere contatti e transazioni a XMD

L’attività Aggiungi contatti e transazioni a XMD ti consente di mappare i dati importati in Qualtrics nella tua directory XM. Ad esempio, puoi utilizzare un’attività Estrai dati da file SFTP per importare i dati in Qualtrics e quindi mappare tali dati alla tua directory.

Questa attività è simile all’attività Carica dati account B2B nella directory XM, ma consente di mappare sia i dati di contatto che i dati transazionali nella directory XM.

Configurazione di un’aggiunta di contatti e transazioni al task XMD

1. Fare clic sul menu di navigazione nell’angolo in alto a sinistra.
   
2. Selezionare Workflow.
3. Fare clic su Crea un workflow.
4. Determinare se il workflow deve essere Pianificato o Basato su eventi. Per un confronto di queste opzioni, vedere Workflow pianificati rispetto a Workflow basati su eventi.
   Qtip: di norma, utilizzerai un flusso di lavoro pianificato in modo che i tuoi dati siano regolarmente aggiornati.
5. Assegnare un nome al workflow.
6. Determinare quando deve essere eseguito il workflow (se un workflow pianificato) o l’evento che avvia il workflow (se un workflow basato su eventi).
7. Fai clic sul segno più ( + ), quindi su Attività per impostare l’attività di estrazione dei dati che importa i dati in Qualtrics. È necessario configurare un’attività di estrazione dei dati prima di poter utilizzare l’attività Carica dati account B2B nella directory XM. Per ulteriori informazioni, vedere Utilizzare le attività Workflow per creare flussi di lavoro ETL.
   Qtip: I file devono essere inferiori a 50 MB per essere compatibili con l’aggiunta di contatti e transazioni al task XMD.
8. Fare clic sul segno più ( + ), quindi su Attività.
   
9. Selezionare il task Aggiungere contatti e transazioni a XMD.
   
10. Selezionare la directory in cui mappare i dati.
    
    Qtip: la maggior parte delle licenze ha solo una directory predefinita, ma alcune possono avere più directory.
11. Seleziona una lista di invio a cui mappare i dati. È anche possibile scegliere di creare una nuova lista di invio per questa directory ogni volta che viene eseguito questo flusso di lavoro.
12. Seleziona un’origine dati. Questo dovrebbe essere il task dell’estrattore dati precedentemente configurato.
13. Utilizza i menu a discesa per mappare i campi dalla tua attività di estrazione dati alla directory XM.
    
    Consiglio Q: è anche possibile mappare i valori dei singoli campi. Per ulteriori informazioni, vedere Mappatura dei valori campo.
14. Per aggiungere campi personalizzati al proprio mapping, fare clic su Aggiungi campo.
    Qtip: i campi sorgente possono essere mappati a un solo campo di destinazione all’interno del task.
15. Se si intende mappare i dati di movimento oltre ai dati di contatto, selezionare un campo da utilizzare come data della transazione.
    
    Attenzione: quando mappi i dati transazionali devi mappare almeno un campo contatto nella sezione sopra. È inoltre necessario selezionare un elenco di contatti a cui verranno aggiunti i dati della transazione.

    Qtip: quando si mappano i campi data transazione durante la configurazione del task, le date transazione sono le date in cui si è verificata una transazione. Si presume che le date siano in UTC, a meno che il fuso orario non sia esplicitamente incluso nel valore della data. Per ulteriori informazioni su questi formati, consultare la pagina di supporto Sintassi formato data. Di seguito è riportato un elenco di formati ora compatibili:

    • ISO-8601 (2006-01-02T15:04:05+07:00)
    • ANSIC (lun gen _2 15:04:05 2006)
    • UnixDate (lun gen _2 15:04:05 MST 2006)
    • RFC822 (02 Gen 06 15:04 MST)
    • RFC850 (lunedì, 02-Jan-06 15:04:05 MST)
    • RFC1123 (Lun, 02 Gen 2006 15:04:05 MST)
16. Fare clic su Aggiungi campo per aggiungere altri campi transazione personalizzati e utilizzare i menu a discesa per mappare i valori di questi campi.
    Qtip: il campo della data della transazione è obbligatorio e non sarà possibile mappare campi transazione supplementari senza mappare un valore per questo campo.
17. Al termine della mappatura dei campi, fare clic su Salva.
    Qtip: questa attività obbedisce alle regole di deduplicazione dei contatti della directory.

Valori campo di mappaggio

Puoi mappare i valori dei singoli campi per salvare in Qualtrics. È possibile mappare i campi manualmente o caricare un file contenente i mappaggi. Inoltre, è possibile determinare cosa accade ai campi non mappati.

Per avviare la mappatura dei valori di campo, fare clic su Sostituisci tutti i valori a sinistra con i valori a destra sotto il campo desiderato.

VALORI MAPPAGGIO CON CARICAMENTO FILE

Hai la possibilità di caricare un file CSV o TSV contenente la tua mappatura. Questa operazione è consigliata se si hanno molti valori da mappare. Se alcuni valori sono già stati mappati, il caricamento di un file non sostituirà tali mappaggi. I mappaggi appena aggiunti verranno aggiunti sotto i valori già mappati.

1. Fare clic su Sostituisci tutti i valori a sinistra con i valori a destra.
   
2. Fare clic su Scarica modello CSV. Si consiglia di scaricare il template poiché contiene la formattazione corretta.
3. Aprire questo file in un editor di fogli di calcolo sul computer, come Microsoft Excel o Google Sheets.
4. Le prime 2 celle conterranno le intestazioni “da” e “a”. Questi rappresentano rispettivamente i valori di origine e di destinazione.
   
5. Aggiungere i valori dei campi. I valori di origine vanno nella colonna “da” e i valori di destinazione nella colonna “a”. Assicurarsi che il file soddisfi i seguenti requisiti:
   • È possibile avere fino a 500 coppie di mappaggio. Se il file contiene più di 500 mappaggi, si riceverà un messaggio di errore e verranno caricate solo le prime 500 righe.
   • Assicurarsi che il file contenga le intestazioni “da” e “a”. Se queste intestazioni non vengono rilevate, Qualtrics assumerà che la prima colonna sia “da” e la seconda colonna “a”.
6. Salva il tuo file come CSV o TSV con codifica UTF-8.
7. Nell’attività Aggiungi contatti e transazioni a XMD, fai clic su Scegli file, quindi seleziona il file dal tuo computer. Il mappaggio caricato verrà quindi alimentato nel task.
   

VALORI MANUALMENTE DI MAPPATURA

È anche possibile mappare manualmente i valori dei campi. Questa operazione è consigliata se si hanno solo pochi valori da mappare.

1. Fare clic su Sostituisci tutti i valori a sinistra con i valori a destra.
   
2. Inserire il valore sorgente nella prima colonna
3. Inserire il valore di destinazione nella seconda colonna
4. Fare clic sul segno più blu ( + ) per aggiungere un’altra coppia di mapping.

GESTIONE CAMPI NON ATTESI

Se un valore di campo non è mappato, il campo verrà importato in Qualtrics utilizzando il suo valore di origine. Tuttavia, è possibile scegliere di mappare tutti i valori non mappati a un valore di campo predefinito.

1. Fare clic su Sostituisci tutti i valori a sinistra con i valori a destra.
   
2. Attivare Mappa campi non mappati a un campo predefinito.
3. Inserire il valore campo di default.

ELIMINAZIONE DELLE MAPPATURE

1. Fare clic sul segno meno ( – ) accanto a una coppia di mappatura per eliminare la mappatura.
   
2. Fare clic su Cancella tutto per eliminare tutti i mappaggi per quel campo.

Consigli di risoluzione dei problemi

• Quando si esamina l’errore di un task del flusso di lavoro, eseguire il check-out dei workflow che riportano eventuali errori e correggerli prima di riprovare il task.
• La deduplicazione dei contatti consente di ripetere il task senza creare contatti duplicati. Assicurarsi di configurare le regole di deduplicazione dei contatti durante il test e il nuovo tentativo di questa attività.

FAQ