Integrazione della Directory Xm con Intercettazioni Digitali
Cosa puoi trovare in questa pagina
Informazioni sull'integrazione della Directory Xm con Digital Intercettazioni
Attenzione: Per utilizzare questa funzionalità, il vostro brand Qualtrics deve avere sia Directory xm che Website / App Insights. Se sei interessato a questa funzionalità, contatta il Servizio Clienti.
Directory XM è una rubrica di contatti a livello aziendale che tiene traccia dei numerosi punti di interazione di ciascun cliente con la vostra azienda. L'integrazione degli approfondimenti su sito web e app con Directory XM ti consente di sfruttare i vantaggi di Directory XM con i visitatori del tuo sito web. Grazie alla frequenza contatti omnicanale, puoi assicurarti che i visitatori del tuo sito web non ricevano un invito via e-mail se hanno già ricevuto un messaggio di intercettazione sul web, e viceversa. È inoltre possibile destinare la visualizzazione delle intercettazioni di siti web e app a segmenti specifici di utenti, nonché ottenere approfondimenti specifici per segmento e percorso.
Per poter utilizzare questa funzione, è necessario avere accesso a quanto segue:
- Accesso alla directory XM.
- Accessibilità al feedback website / app.
- Contatti o segmenti presenti in una delle tue directory.
Impostazione dell'integrazione
Directory XM
L'integrazione con le intercettazioni di siti web utilizzerà la configurazione della Directory XM esistente. Se non si è ancora configurata la directory, vedere Guida introduttiva alla DIRECTORY XM.
Consiglio Q: per poter utilizzare questa integrazione, è necessario che in Directory XM sia configurata una regola di risoluzione delle identità che unisca i contatti duplicati in base a un campo identificativo, come l’indirizzo e-mail o un riferimento a dati esterni di .
Consiglio Q: le analisi del sito web funzionano con diverse regole di risoluzione dell'identità, purché venga utilizzato un solo campo. Le versioni mobili funzionano solo con la risoluzione dell'identità basata su un riferimento a dati esterni.
Per ottenere il massimo dall'integrazione, seguite queste best practice:
Tenere aggiornati i contatti. Ciò consente a QUALTRICS di distinguere se i visitatori del vostro sito web sono contatti esistenti o nuovi visitatori.
Esempio: Impostare un flusso di lavoro che mantenga sincronizzata la Directory XM con gli elenchi di contatti, oppure collaborare con il team di sviluppo per creare i contatti utilizzando le chiamate APIcreate a new contact e update a contact.
- Unisce automaticamente i contatti duplicati. È possibile unire solo i contatti appena creati o tutti i contatti esistenti. Per ulteriori informazioni, vedere Unione di contatti duplicati nella Directory XM.
Attenzione: Il Riferimento a dati esterni / ID riferimento esterno è sensibile alle maiuscole e minuscole quando si integra la Directory XM con le intercettazioni.
Identificazione dei visitatori
Attenzione: La seguente documentazione richiede conoscenze di programmazione per essere implementata. Si consiglia di trasmettere queste informazioni al team che implementerà il codice di distribuzione. Il nostro team di supporto non offre assistenza o consulenza per la codifica personalizzata. Puoi invece provare a domandare alla nostra community di utenti esperti. Se desiderate saperne di più sui nostri servizi di programmazione personalizzata che potete richiedere, contattate il vostro Account Executive Qualtrics.
Per poter usufruire dei vantaggi della Directory XM dal tuo progetto Approfondimenti su sito web e app, devi innanzitutto assicurarti che Qualtrics sappia chi visita il tuo sito web o la tua app e sia in grado di abbinare tali informazioni ai tuoi contatti esistenti. Per farlo, dovrai specificare l'espressione JavaScript che viene valutata nella sessione di accesso dell'utente per ottenere
Negli esempi riportati di seguito, ci concentreremo su uno scenario in cui la risoluzione dell'identità si basa su un riferimento a dati esterni. Mostreremo come impostare un ID di riferimento esterno, che deve corrispondere al riferimento ai dati esterni presente nella Directory XM.
Attenzione: L'integrazione tra la Directory XM e le intercettazioni digitali funziona al meglio quando i contatti sono univoci; è necessario utilizzare una regola di risoluzione dell'identità in Directory XM per evitare contatti duplicati. Il valore legato a ciascun utente deve essere unico e identificativo per tutti i contatti del sito. Per evitare molti contatti duplicati, non utilizzare un valore segnaposto per i valori sconosciuti e utilizzare solo valori statici nei test.
Esempio: salvando il campo "ID di riferimento esterno" tramite JavaScript, un cookie o codice HTML sul proprio sito, è possibile associare ciascun visitatore in base al riferimento ai dati esterni memorizzato nella Directory XM.
Avanti, dovrete passare le informazioni sui vostri visitatori a Qualtrics. I passaggi sono diversi se si utilizza un sito web o un'applicazione mobile.
Configurazione di Intercept sul sito web
Se si utilizza un sito web, collaborare con il team di sviluppo web per aggiungere il seguente frammento di codice al sito web, oltre al codice di distribuzione del progetto. Per ulteriori informazioni, consulta la documentazione relativa all'API Connecting with Directory XM.
Il frammento di codice riportato di seguito trasmette l'ID externalReference dell'utente a Qualtrics per associare il visitatore del sito web a un contatto presente nel Directory XM. Inserire questo frammento di codice al caricamento della pagina, assicurandosi che il valore dell'ID sia già stato recuperato.
if(typeof QSI === "undefined") {
QSI = {};
QSI.config = {
externalReference: extRef
};
}Attenzione: Il frammento di codice per impostare l'ID externalReference deve trovarsi sopra il codice di distribuzione del progetto JavaScript nel codice del sito. Questo snippet deve essere incluso in ogni pagina del vostro sito in cui vi rivolgete ai visitatori con le intercettazioni.
Attenzione: Assicurarsi che al posto di extRef si specifichi l'espressione JavaScript da valutare per ottenere l'ID di riferimento esterno appropriato (ad esempio "UserID"). Questa espressione può essere semplice come una variabile JavaScript o un'espressione JavaScript per valutare un cookie specifico.
Configurazione di Intercept per app mobili
Se utilizzate un'applicazione mobile, collaborate con il vostro team di sviluppo dell'applicazione mobile per integrarla con l'ultima versione dell'SDK per applicazioni mobili di Qualtrics. Per ulteriori informazioni, consultare la documentazione di Api.
Consiglio q: se un utente finale si collega al sito con un ID di riferimento esterno che non è attualmente presente in Directory XM (cioè, il record di questo utente non è ancora presente in Directory XM), l'intercetta non apparirà per questo utente. È possibile utilizzare la Creazione automatica di contatti per aggiungere questo utente alla directory.
Collegare l'esperienza Digital con la Directory XM
È possibile integrare Directory XM con la propria esperienza digitale a livello di progetto e di intercettazione. È necessario collegare la Directory XM al progetto prima di poterla collegare a un'intercetta specifica.
Ogni singolo progetto "Approfondimenti su sito web e app" può essere collegato a una sola directory. In questo modo si evitano problemi con le regole di frequenza contatti, soprattutto se lo stesso contatto è presente in directory diverse con regole di frequenza diverse. Inoltre, consolida tutti i punti di contatto digitali in un unico luogo da organizzare e mantenere.
Esempio: Avete recentemente organizzato un evento di cui volete raccogliere i feedback, sia via e-mail che attraverso il vostro sito web. Ma il vostro sito web ha anche altre intercettazioni che volete eseguire e che non sono assolutamente correlate. Il collegamento con Directory XM e la successiva applicazione delle regole sulla frequenza dei contatti garantiscono che ai clienti non venga chiesto due volte di fornire un feedback per lo stesso evento, senza influire sulle altre opportunità di feedback presenti sul tuo sito web.
Esempio: riprendendo l'esempio precedente, se sul tuo sito web arrivano visitatori che prima non figuravano nella tua directory, ti conviene raccogliere le loro informazioni. È possibile attivare le regole di frequenza contatti per una sola intercettazioni, ma abilitare la DIRECTORY XM per l'intero progetto in modo da raccogliere più informazioni sui contatti.
Quando l'opzione " Collegamento con Directory XM " è abilitata a livello di intercettazione o di progetto, i dati integrati relativi agli utenti verranno automaticamente aggiunti alle loro risposte al sondaggio. Per ulteriori informazioni, vedere Utilizzo di dati integrati con Directory Xm.
Inoltre, ogni volta che viene visualizzata la vostra intercetta, viene creato un evento nella timeline della DIRECTORY XM del visitatore.
Nell'esempio precedente:
Collegamento di un intero sito web e di un progetto App Insights
Per collegare un intero progetto Website & App Insights a una directory:
Attenzione: A partire da maggio 2024, i progetti non potranno essere collegati a più directory.
Consiglio Q: se si cerca di spostare un'intercetta e il progetto complessivo in due directory diverse, non sarà possibile salvare la modifica e verrà richiesto di abbinarle o di scollegarle completamente dalle directory.
Collegamento di un'intercettazione guidata
- Apri l'intercettazione guidata.
Andare su Impostazioni.
Vai alla Directory XM.
- Seleziona " Collega questa intercettazione alla Directory XM".
- Poiché le regole di risoluzione delle identità sono già definite a livello di progetto, non è necessario impostare alcuna regola di questo tipo in questa sede. Inoltre, non è necessario specificare la directory, poiché questa viene impostata a livello di progetto.
- Se lo si desidera, applicare le regole relative alla frequenza dei contatti.
- Fare clic su Applica le modifiche.
Collegamento di un'intercetta individuale
Creazione automatica di contatti
Attenzione: È necessario collaborare con il team di sviluppo del sito web per aggiungere il codice necessario a inviare le informazioni sui contatti alla directory tramite API. Per ulteriori informazioni, consultare la documentazione API sulla creazione di un contatto della directory o sulla creazione di un contatto in una lista di invio.
I contatti della Directory XM possono essere creati ogni volta che gli utenti visitano pagine web su cui è presente il codice di distribuzione del progetto Qualtrics Website & App Insights. Questa opzione consente di aggiungere automaticamente i contatti quando il codice di implementazione del progetto "Approfondimenti su sito web e app" viene eseguito sulla pagina web, eliminando la necessità di caricare manualmente i file o di ricorrere ad automazioni basate su SFTP.
Attenzione: L'integrazione della Directory XM con le intercettazioni digitali può essere utilizzata solo per creare nuovi contatti. Non aggiorna i contatti esistenti. Se il tuo intercettatore mostra un sondaggio, potresti creare un flusso di lavoro per aggiornare le informazioni di contatto in base alle risposte fornite dal visitatore del sito nel sondaggio.
Consiglio Q: non è necessario che venga visualizzato un intercettatore affinché la creazione del contatto funzioni; è sufficiente che il codice di implementazione venga eseguito sulla pagina. Si prega di tenere presente che la visualizzazione dell'intercettazione potrebbe richiedere qualche secondo in più se, insieme alla sessione, deve essere creato automaticamente un contatto. Per ulteriori informazioni sul funzionamento del codice di implementazione sul tuo sito, consulta la sezione " Visualizzazioni di pagina".
Per abilitare la creazione automatica dei contatti, collega innanzitutto il tuo progetto Approfondimenti su sito web e app e Directory XM, come descritto in precedenza. Quindi, attiva l'opzione " Aggiungi contatti sconosciuti alla rubrica". Ricordarsi di applicare le modifiche.
Per ogni nuovo utente web (ovvero, visitatore del tuo sito web), puoi acquisire i seguenti campi di contatto tramite la configurazione del tuo sito web:
- Nome
- Cognome
- Riferimento a dati esterni
- Telefono
- Lingua
Coppie chiave-valore aggiuntive (ad es. "Località": "Seattle", "Sesso": "Femmina"). Ogni coppia chiave-valore è limitata a 50 caratteri e la lunghezza totale combinata di tutte le coppie può raggiungere i 400 caratteri.
Consiglio Q: Se la directory ha più regole di risoluzione dell'identità XM, un contatto creato tramite questo flusso deve essere unico in tutte le regole di risoluzione della directory (cioè, non deve corrispondere a nessun campo di contatto esistente in nessuna regola di risoluzione).
Consiglio Q: nelle app mobili, i contatti possono essere creati solo tramite "Riferimento a dati esterni".
Impostazione delle regole di Frequenza CONTATTI per le Intercettazioni
Attenzione: Al fine di mantenere i livelli di servizio adeguati per tutti i clienti, Qualtrics può limitare il traffico ai nostri server in rari casi in cui si verifichino picchi inaspettatamente elevati.
Le regole relative alla frequenza dei contatti possono limitare la frequenza con cui viene visualizzato un messaggio di interruzione. È possibile utilizzare regole generali della directory e regole personalizzate per sondaggi specifici.
Per i sondaggi che potrebbero essere visualizzati su diversi dispositivi o browser, come ad esempio i sondaggi di feedback passivo, sconsigliamo di utilizzare la frequenza contatti.
Attenzione: al momento non sono supportate le regole personalizzate relative alla frequenza dei contatti applicabili alle liste.
Attenzione: se nella stessa pagina sono presenti più intercettazioni che utilizzano regole di frequenza contatti, ne verrà visualizzata solo una. L'intercetta visualizzata sarà quella più vecchia.
Consiglio Q: se non si recupera un ID di riferimento, l'intercetta si comporterà come se le regole di frequenza contatti non fossero abilitate. Se si recupera un ID di riferimento che non corrisponde a nessun ID della directory, l'intercetta non verrà visualizzata.
Impostazione dei segmenti per la destinazione delle intercettazioni
Attenzione: Al fine di mantenere i livelli di servizio adeguati per tutti i clienti, Qualtrics può limitare il traffico ai nostri server in rari casi in cui si verifichino picchi inaspettatamente elevati.
Attenzione: I segmenti possono essere creati e modificati solo dai manager che hanno l'autorizzazione Manage Directory abilitata. Qualsiasi utente con l'autorizzazione di accesso ai contatti può distribuire ai segmenti esistenti.
Una volta creati i segmenti in DIRECTORY XM, è possibile utilizzarli in Qualtrics in molti degli stessi luoghi in cui è possibile utilizzare liste di invio e campioni, anche con Website / App Insights. La combinazione di Directory xm e Website / App Insights consente di destinare la visualizzazione delle intercettazioni di siti web e app a segmenti specifici di utenti, nonché di ottenere insight specifici per segmento e viaggio.
Consiglio Q: se l'intercetta viene visualizzata dal visitatore del sito web, questo punto di contatto verrà visualizzato anche nella timeline dei punti di contatto della Directory XM.
Esempio: i contatti che hanno scelto di non essere inclusi nella Directory XM non vedranno alcuna notifica collegata alla Directory XM. Questo avviene automaticamente e non è necessario impostare regole di targeting per segmenti o di frequenza dei contatti per escludere i contatti che hanno esercitato il diritto di rinuncia.
Test dell'integrazione della Directory xm con le Intercettazioni di siti web
Prima di lanciare l'intercetta sul vostro sito web, dovreste testarla per assicurarvi che la frequenza contatti, il targeting dei segmenti o la creazione dei contatti siano stati implementati correttamente.
Sebbene sia possibile identificare i contatti utilizzando diversi campi, negli esempi riportati di seguito ci concentreremo su uno scenario in cui la risoluzione dell'identità si basa su un riferimento a dati esterni. Nell'implementazione reale, l'ID di riferimento esterno del visitatore del sito sarà disponibile nel contesto della sua sessione registrata attraverso un'espressione JavaScript o un cookie.
I passaggi riportati di seguito illustrano come eseguire uno scenario end-to-end utilizzando dati di test e soluzioni alternative basate su browser web.
Verifica della frequenza contatti
Per ripetere questi passaggi per ulteriori test, eseguire le seguenti operazioni tra un test e l'altro:
TEST PER LA CREAZIONE DI UN CONTATTO
Consiglio Q: Per le intercettazioni di siti web, è possibile testare l'intercettazione utilizzando il bookmarklet sia con contatti che fanno parte del segmento sia con contatti che non fanno parte del segmento. During testing, you’ll have to mimic the setting of the External Reference ID within your browser so Qualtrics can identify the contact.
Analisi dell'esperienza digitale e Directory Xm
Le sessioni registrate per l'Analisi dell'esperienza digitale (DXA) possono essere riflesse nei profili dei contatti della Directory XM. Questi dati arricchiscono la comprensione di quali clienti sono maggiormente influenzati dall'esperienza del vostro sito web e possono aiutarvi a decidere come dare priorità alle lacune individuate nell'esperienza digital.
Consiglio Q: i replay delle sessioni salvati nella Directory xm non supportano la funzione di cancellazione dei dati personali tramite e-mail. Consultate invece la nostra guida su Session Replay e GDPR.
Impostazione di DIRECTORY XM e Directory XM
L'integrazione tra DXA e Directory XM è identica al collegamento di un progetto Website Insights a Directory XM!
Consiglio Q: se si sono già completati i passaggi sottostanti per il proprio progetto Website Insights, non è necessario ripetere questi passaggi.
Consiglio Q: Per assistenza nella distribuzione del codice di distribuzione del progetto Website Insights su un sito web, i team IT possono consultare la nostra Documentazione tecnica.
Visualizzazione dei dati dei contatti in una sessione di replay
Per visualizzare i replay delle sessioni, apri l'Assistente digitale. Invece di "Utente anonimo", si vedrà il nome del contatto così come appare nella directory.
È possibile espandere il nome del contatto per visualizzare altre informazioni identificative, come i metadati del dispositivo e l'e-mail.
Visualizzazione dei dati di replay della sessione su un contatto
Le esperienze di visita al sito web possono comparire nella cronologia di un contatto per indicare interazioni con un intercettatore o registrazioni di sessioni. Se è stata acquisita una sessione, la voce è accompagnata da un pulsante chiamato Visualizza replay sessione.
Verrà inoltre visualizzato un riepilogo dei segnali di frustrazione rilevati durante la sessione.
Consigli di risoluzione dei problemi
Un nuovo utente è stato aggiunto ai segmenti, ma non vede un annuncio di intercettazione destinato al proprio segmento.
I segmenti vengono ricostruiti quotidianamente nella DIRECTORY XM. Pertanto, è possibile che il nuovo utente non sia stato ancora accountato come membro del segmento.
La finestra del debugger di Intercetta non mostra i nomi dei segmenti.
Per motivi di sicurezza, non mostriamo il nome del segmento nella finestra del debugger per nessuna logica di destinazione che abbia segmenti. Mostreremo l'ID del segmento. Per mappare l'ID di un segmento al nome del segmento, modificare il segmento nella Directory XM e guardare l'URL. L'URL conterrà l'ID del segmento, evidenziato nell'URL di esempio riportato di seguito:https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k
In alternativa, puoi aprire direttamente un Intercept ed esaminare la logica di targeting per vedere quali segmenti vengono presi di mira.
La finestra del debugger di intercettazione non viene visualizzata per i contatti che hanno scelto di non partecipare.
Quando si esegue il test dell’intercettazione e il parametro `externalReference` punta a un contatto che ha esercitato il diritto di rinuncia, l’intercettazione non verrà visualizzata nella finestra del debugger. Durante il test, assicurati che il contatto a cui ti riferisci abbia acconsentito all'inserimento nella rubrica.
L'intercetta è lenta a comparire per i primi utenti.
Per motivi di performance, memorizziamo temporaneamente i membri del segmento in memoria e li aggiorniamo solo quando necessario. Se un utente non è ancora presente nella nostra memoria temporanea, la sua intercetta potrebbe richiedere un po' più di tempo per essere visualizzata inizialmente.
È fantastico! Grazie per il tuo feedback!
Grazie per il tuo feedback!