Integrazione directory XM con intercette digitali

Informazioni sull’integrazione della directory XM con le intercette digitali

XM Directory ti consente di creare il tuo panel interno con profili ricchi di clienti e clienti potenziali. Avere una directory di contatti valida per tutta l’organizzazione ti consente di visualizzare i profili dei numerosi punti di contatto dei contatti con la tua organizzazione, rendendo più semplice che mai scoprire approfondimenti sulla loro esperienza con il tuo brand.

Integrare Website/App Insights con XM Directory ti consente di utilizzare i vantaggi della directory XM con i visitatori del tuo sito web. Puoi impostare la frequenza contatti omnicanale, assicurandoti che i visitatori del tuo sito web non ricevano un invito via e-mail se hanno già ricevuto un’intercetta web e viceversa. Puoi anche indirizzare la visualizzazione delle intercette del sito web e delle app a segmenti specifici di utenti, così come ottenere approfondimenti specifici per segmento e viaggio

Prima di poter utilizzare questa funzione, devi accedere a quanto segue:

1. Accedi alla directory XM.
2. Accesso al feedback website / app.
3. Contatti o segmenti all’interno di 1 delle tue directory.

Configurazione dell’integrazione

Directory XM

L’integrazione con le intercette del sito web utilizzerà la configurazione esistente della directory XM. Se non hai ancora configurato la tua directory, consulta Nozioni introduttive sulla directory XM.

Per trarre il massimo vantaggio dall’integrazione, seguire queste best practice:

• Mantieni aggiornati i tuoi contatti. Ciò consente a Qualtrics di distinguere se i visitatori del tuo sito web sono contatti esistenti o nuovi visitatori.
  Esempio: configura un’automazione di importazione dei contatti per mantenere la directory XM sincronizzata con le liste dei tuoi clienti, oppure lavora con il tuo team di sviluppo per creare contatti utilizzando l’ per creare un nuovo contatto e aggiornare le chiamate API di un contatto.
• Unisci automaticamente contatti duplicati. È possibile unire solo i contatti appena creati o tutti i contatti esistenti. Per ulteriori informazioni, consulta Unione di contatti duplicati nella directory XM.
  Consiglio Q: l’unione dei contatti in base al campo Riferimento a dati esterni garantisce che ogni contatto abbia un valore univoco.

Intercette

Per accedere ai vantaggi della Directory XM dal tuo progetto Website/App Insights, devi prima assicurarti che Qualtrics sappia chi sta visitando il tuo sito web e possa abbinare tali informazioni ai tuoi contatti esistenti. A tal fine, è necessario specificare l’espressione JavaScript valutata nella sessione di logon dell’utente per ottenere l’ID riferimento esterno per il contatto.

Successivamente, dovrai trasmettere a Qualtrics le informazioni sui tuoi visitatori. I passaggi sono diversi se si utilizza un sito Web rispetto a un’app per dispositivi mobili.

Se stai utilizzando un sito web, collabora con il tuo team di sviluppo web per aggiungere il seguente frammento di codice al tuo sito web, oltre al codice di distribuzione del progetto. Lo snippet passa l’ID externalReference dell’utente a Qualtrics per associare il visitatore del sito web a un contatto nella Directory XM. Metti questo frammento di codice nel caricamento della pagina, assicurandoti che il valore dell’ID sia già stato recuperato.

Fare clic qui per visualizzare lo snippet del codice.

if(typeof QSI === "non definito") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }

Se stai utilizzando un’app mobile, collabora con il team di sviluppo delle app mobili per integrarlo con l’ultima versione di Qualtrics Mobile App SDK. Consultare la documentazione API per ulteriori informazioni.

Collegamento alla directory XM

Collega alla directory XM ti permette di impostare un collegamento tra il tuo progetto digitale e una directory dalla directory XM. Quando questa opzione è selezionata, i dati incorporati dei contatti per gli utenti saranno automaticamente aggiunti alla risposta al sondaggio. Per ulteriori informazioni, consulta Utilizzo dei dati incorporati con la directory XM. Inoltre, un evento nella linea cronologica del punto di contatto XM Directory del tuo visitatore sarà creato ogni volta che la tua intercetta gli viene visualizzata.

Collegamento della directory XM al sito Web & progetto App Insight

1 sito Web & il progetto App Insight può essere collegato solo a 1 directory. Ciò aiuta a garantire che non vi siano problemi con le regole di frequenza dei contatti, in particolare se lo stesso contatto esiste in directory diverse con regole di frequenza diverse. Consolida inoltre tutti i punti di contatto digitali in un unico luogo da organizzare e mantenere.

Per collegare un progetto Website & App Insight a una directory, vai alla scheda Impostazioni del progetto, abilita Collegamento alla directory XM e seleziona la directory dall’elenco di riepilogo a discesa.

Dopo che il progetto è collegato a una directory, puoi collegare un’intercetta a una directory andando su Opzioni intercetta e selezionando Collega questa intercetta alla Directory XM.

Creazione contatto automatica

I contatti della Directory XM possono essere creati ogni volta che gli utenti visitano le pagine web con il codice di distribuzione del progetto di App Insights su di essi. Questa opzione consente l’aggiunta automatica di contatti quando il codice di distribuzione del progetto Website & App Insights viene eseguito sulla pagina Web, eliminando la necessità di caricamenti manuali di file o automazioni basate su SFTP.

Per abilitare la creazione automatica dei contatti, devi prima collegare il progetto Website & App Insights alla Directory XM nella scheda Impostazioni progetto. Quindi, fai clic sul segno di spunta accanto all’opzione che dice Se il contatto non esiste nella tua directory, aggiungilo automaticamente.

È possibile aggiungere le seguenti informazioni per ogni contatto:

Nome
Cognome
Lingua
Coppie di valori chiave supplementari (ad es. “Luogo”: “Seattle”, “Genere”: “Femminile”). È possibile aggiungere fino a 200 coppie

Configurazione delle regole di frequenza contatti per le intercettazioni

Le regole di frequenza contatti possono essere configurate per limitare la frequenza con cui viene mostrata un’intercetta. È possibile utilizzare regole generali della directory, nonché regole personalizzate per questionari specifici. Per i sondaggi che possono essere visualizzati su molti dispositivi o browser, come le intercette di feedback passive, consigliamo di non utilizzare la frequenza contatti.

1. Apri un progetto feedback website / app esistente o creane uno nuovo.
2. Apri un’intercetta esistente o creane una nuova.
3. Modifica le opzioni Visualizza frequenza e Directory XM.
   
4. Abilita collegamento alla directory XM.
   
   Qtip: quando questa opzione è selezionata, i dati incorporati di contatto per gli utenti che compilano questo sondaggio saranno automaticamente aggiunti alla loro risposta al sondaggio. Guarda Utilizzo dei dati incorporati con la directory XM
5. Confermare la directory selezionata, impostata dalla pagina Impostazioni.
6. Abilita regole di frequenza contatti.
7. Salvare le modifiche.
8. Le fasi successive differiscono a seconda che si stia implementando questa funzionalità in un sito Web o in un’app mobile.
   • Sito Web: sul tuo sito web dove lancerai l’intercetta, specifica l’espressione JavaScript che sarà valutata nella sessione di accesso dell’utente per ottenere l’ID di riferimento esterno per il contatto. Questo ID di riferimento esterno viene utilizzato per cercare il visitatore nella directory XM e tracciare se ha visto la tua intercetta.
   • App: nell’app in cui avvierai l’intercetta, dovrai aggiornare l’SDK della tua app mobile per recuperare l’ID di riferimento. Consultare la documentazione API.

Configurazione di segmenti per il targeting delle intercettazioni

Una volta creati i segmenti nella directory XM, è possibile utilizzarli in Qualtrics in molti degli stessi luoghi in cui le liste di invio e i campioni possono essere utilizzati, anche con Website/App Insights. La combinazione di XM Directory e Website / App Insights ti consente di indirizzare la visualizzazione delle intercette del sito web e delle app a segmenti specifici di utenti, nonché di ottenere approfondimenti specifici per segmento e viaggio.

1. Crea un intercetta su un progetto feedback website / app nuovo o esistente.
   Qtip: se invece di creare un’intercetta indipendente desideri assistenza durante l’intero processo, non esitare a utilizzare la nostra configurazione guidata per progetti Website/App Feedback. Se utilizzi la configurazione guidata, ti verrà richiesto di aggiungere un editor di intercetta, connettere il sondaggio e configurare la tua intercetta. Per ulteriori informazioni sulla configurazione guidata, visitare Scegli come raccogliere feedback.
2. Naviga alle Opzioni dell’intercetta.
   
   Qtip: i passaggi sono gli stessi sulle intercette dell’app mobile, ma vedrai meno opzioni di intercettazione.
3. Abilita “Collega alla directory XM” selezionando la casella di controllo.
4. Confermare la directory selezionata, impostata dalla pagina Impostazioni.
5. Torna al tuo editor intercette e aggiungi la logica di destinazione che contiene il segmento della tua directory XM.
   Esempio: Ad esempio, il segmento directory XM è un utente di alto valore.
   Qtip: sulle intercettazioni del sito web, puoi testare l’intercetta utilizzando il bookmarklet sia con i contatti che sono nel segmento sia con i contatti che non sono nel segmento. Durante il test, dovrai imitare l’impostazione dell’ID di riferimento esterno all’interno del tuo browser in modo che Qualtrics possa identificare il contatto.
6. Le fasi successive variano a seconda che si stia implementando questa funzionalità in un sito Web o in un’app mobile.
   • Sito Web: sul tuo sito web dove lancerai l’intercetta, specifica l’espressione JavaScript che sarà valutata nella sessione di accesso dell’utente per ottenere l’ID di riferimento esterno per il contatto. Questo ID di riferimento esterno viene utilizzato per cercare il visitatore nella directory XM e tracciare se ha visto la tua intercetta. Consultare la sezione precedente per ulteriori dettagli sull’espressione JavaScript.
   • App: nell’app in cui avvierai l’intercetta, dovrai aggiornare l’SDK della tua app mobile per recuperare l’ID di riferimento. Consultare la documentazione API.

Testare l’integrazione della directory XM con le intercette del sito Web

Prima di lanciare la tua intercetta sul tuo sito web, dovresti testarla per assicurarti che la frequenza contatti, la destinazione del segmento o la creazione del contatto siano state implementate correttamente.

Nella tua reale distribuzione, l’ID di riferimento esterno del visitatore del tuo sito sarà disponibile nel contesto della loro sessione registrata attraverso un’espressione JavaScript o un cookie.

I seguenti passi consentono di eseguire uno scenario end-to-end utilizzando i dati di test e i workaround del browser Web.

Frequenza dei contatti di test

1. Nella directory XM, creare un nuovo contatto e specificare un ID riferimento univoco per tale contatto.
   Esempio: Utilizzeremo aaa123 come ID riferimento di esempio. Ogni volta che si visualizza il numero ID in queste fasi, sostituirlo con l’ ID di riferimento specificato.
2. Seguire i passaggi nella sezione Configurazione di segmenti per il targeting delle intercettazioni per configurare un’intercettazione per seguire la destinazione segmento.
3. Vai a Prova l’intercetta.
   
4. Trascinare il bookmarklet nella barra dei segnalibri del browser.
5. Passare a una pagina Web da utilizzare per i test.
6. Passare alla console sviluppatore. A seconda del tuo browser web, lo raggiungerai in modo diverso:
   • Google Chrome: nella barra dei menu di Chrome, passare a View → Developer → Developer Tools. Nella finestra visualizzata, passare alla Console
   • Apple Safari: assicurarsi che il menu Develop sia abilitato per Safari. Per eseguire questa operazione, accedere a Preferenze → Avanzate → Mostra menu Sviluppa nella barra dei menu. Fare clic su Sviluppa nel menu Safari e selezionare Mostra Web Inspector. Nella finestra visualizzata, passare alla Console
   • Mozilla Firefox: fare clic sull’icona del menu, quindi selezionare Web Developer. Nel menu Sviluppatore Web, selezionare Console
   • Microsoft Edge: nella barra menu, passare a Tools → Developer → Developer Tools. Nella finestra che si apre, passare alla Console
   • Internet Explorer: fare clic sull’icona Gear e selezionare Developer Tools. Nella finestra che si apre, passare alla Console
7. Nel menu Console digitare questa espressione, quindi premere Invio:
   UserID="aaa123"
   
   Qtip: aaa123 è il nostro esempio di valore ID riferimento e deve essere sostituito con il valore attribuito al contatto nella fase 1.
8. Incollare lo snippet JavaScript qui sotto per impostare la variabile externalReference JavaScript come espressione JavaScript.
   

   if(typeof QSI === "undefined") {
        QSI = {};
        QSI.config = {
            externalReference: UserID
        };
    }

9. Premere Invio.
10. Fai clic sul bookmarklet e vedrai che il target del segmento sarà onorato in modo appropriato per determinare se l’intercetta deve o non deve essere visualizzata.
    Qtip: per motivi di sicurezza, la linea logica di destinazione che include il segmento includerà solo l’ID segmento. Per associare un ID segmento a un nome segmento, vai alla directory XM e modifica il tuo segmento. L’URL avrà l’ID segmento, in grassetto nel seguente URL di esempio: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

Per ripetere queste fasi per ulteriori test, effettuare le seguenti operazioni tra i test:

1. Aggiorna ogni volta il tuo browser.
2. Impostare l’espressione JavaScript all’interno della console.
3. Riesegui il tuo bookmarklet.
4. Naviga alla directory XM e verifica che il contatto sia stato creato con i valori di input.

CREAZIONE CONTATTI DI TEST

1. Apri un progetto di feedback website / app esistente.
2. Navigare fino alle Impostazioni.
   
3. Abilita collegamento alla directory XM.
4. Selezionare una directory dall’elenco di riepilogo a discesa.
5. Fai clic sulla casella di controllo accanto a Se il contatto non esiste nella tua directory, aggiungilo automaticamente.
6. Fare clic su Applica modifiche.
7. Seguire le istruzioni nel tab Deployment per copiare lo snippet del codice di deployment.
8. Passare a una pagina Web che si intende utilizzare per il test.
9. Passare a Developer Console. A seconda del browser Web, lo raggiungerai in modo diverso:
   • Google Chrome: nella barra dei menu di Chrome, passare a View → Developer → Developer Tools. Nella finestra visualizzata, passare alla Console
   • Apple Safari: assicurarsi che il menu Develop sia abilitato per Safari. Per eseguire questa operazione, accedere a Preferenze → Avanzate → Mostra menu Sviluppa nella barra dei menu. Fare clic su Sviluppa nel menu Safari e selezionare Mostra Web Inspector. Nella finestra visualizzata, passare alla Console
   • Mozilla Firefox: fare clic sull’icona del menu, quindi selezionare Web Developer. Nel menu Sviluppatore Web, selezionare Console
   • Microsoft Edge: nella barra menu, passare a Tools → Developer → Developer Tools. Nella finestra che si apre, passare alla Console
   • Internet Explorer: fare clic sull’icona Gear e selezionare Developer Tools. Nella finestra che si apre, passare alla Console
10. Nel menu Console digitare questa espressione con i valori di contatto della directory XM di esempio, quindi premere Invio.

    QSI = {config: {externalReference:"test123", contactEmbeddedData: {"Location":"Seattle"}, lingua:"English", firstName:"Jane", lastName:"Smith"}}

    

    Qtip: i valori di questa espressione sono esempi di valori di contatto che verranno aggiunti al profilo della directory XM del contatto di prova. È possibile modificare questi valori in qualsiasi modo.
    Attenzione: non supportiamo gli indirizzi e-mail come attributi di profilo al fine di preservare intercettazioni web altamente sicure. È possibile aggiungere indirizzi e-mail manualmente tramite la directory o caricamenti di file e automazioni SFTP.
11. Fai clic sul bookmarklet e vedrai che l’intercetta sarà visualizzata.
    Qtip: l’intercetta NON deve essere visualizzata affinché la creazione del contatto funzioni. Deve solo essere valutato nella pagina.
    Qtip: altre funzionalità della directory XM, come il target dei segmenti o le regole di frequenza dei contatti, non funzioneranno come parte dello stesso caricamento di pagina di quello in cui è stato creato il profilo del contatto. Tuttavia, una volta creato il contatto, eventuali intercettazioni successive valuteranno la frequenza dei contatti e le regole di targeting dei segmenti.
12. Incollare lo snippet del codice di distribuzione nella console, quindi premere Invio.
13. Andare alla directory XM indicata nell’elenco a discesa della fase 3 e confermare che il contatto è stato creato con i valori immessi nella fase 9.

Consigli di risoluzione dei problemi

Un nuovo utente è stato aggiunto ai segmenti, ma non visualizza un’intercetta destinata al suo segmento.

I segmenti vengono ricostruiti quotidianamente nella directory XM. Pertanto, esiste la possibilità che il nuovo utente non sia stato ancora considerato come membro del segmento.

La finestra del debugger dell’intercetta non visualizza i nomi dei segmenti.

Per motivi di sicurezza non viene visualizzato il nome del segmento nella finestra del debugger per una logica di destinazione con segmenti. Verrà visualizzato l’ID segmento. Per attribuire un ID segmento al nome segmento, elabora il tuo segmento nella directory XM e consulta l’URL. L’URL avrà l’ID segmento, che è evidenziato nel seguente URL di esempio: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

, puoi aprire direttamente un’intercetta ed esaminare la logica di destinazione per vedere quali segmenti sono stati presi di mira.

L’intercettazione è lenta a comparire per gli utenti al primo accesso.

Per motivi di prestazioni, archiviamo temporaneamente l’appartenenza ai segmenti in memoria e l’aggiorniamo solo in base alle esigenze. Se un utente non è ancora nella nostra memoria temporanea, la visualizzazione iniziale dell’intercettazione di quell’utente potrebbe richiedere più tempo.