Intégration du répertoire XM à Digital Intercepts

À propos de l’intégration du répertoire XM à Digital Intercepts

Le répertoire XM vous permet de créer votre propre panel interne avec des profils riches de vos clients et prospects. Disposer d’un répertoire de contacts à l’échelle de l’organisation vous permet d’afficher les profils des nombreux points de contact des contacts avec votre organisation, ce qui facilite plus que jamais la découverte d’informations sur leur expérience avec votre marque.

L’intégration d’analyses de sites Web/d’applications au répertoire XM vous permet d’utiliser les avantages du répertoire XM auprès des visiteurs de votre site Web. Vous pouvez configurer la fréquence de contact omnicanal, en vous assurant que les visiteurs de votre site Web ne reçoivent pas d’invitation par e-mail s’ils ont déjà reçu un intercept Web, et vice versa. Vous pouvez également cibler l’affichage des intercepts de sites Web et d’applications sur des segments d’utilisateurs spécifiques, ainsi qu’obtenir des informations spécifiques au segment et au parcours

Avant de pouvoir utiliser cette fonctionnalité, vous devez avoir accès aux éléments suivants :

1. Accès au répertoire XM.
2. Accès à l’avis sur le site Web/l’application.
3. Contacts ou segments dans l’un de vos répertoires.

Configuration de l’intégration

Répertoire XM

L’intégration aux intercepts de sites Web utilisera votre configuration existante du répertoire XM. Si vous n’avez pas encore configuré votre répertoire, voir Prise en main du répertoire XM.

Pour tirer le meilleur parti de l’intégration, suivez les meilleures pratiques suivantes :

• Tenez vos contacts à jour. Qualtrics peut ainsi distinguer si les visiteurs de votre site Web sont des contacts existants ou des nouveaux visiteurs.
  Exemple : configurez une automatisation d’importation de contacts pour que le répertoire XM reste synchronisé avec vos listes de clients ou travaillez avec votre équipe de développement pour créer des contacts à l’aide de la fonction Créer un nouveau contact et mettre à jour les appels d’API d’un contact.
• Fusionner automatiquement les contacts en double. Vous pouvez fusionner uniquement les contacts nouvellement créés ou tous les contacts existants. Pour en savoir plus, voir Fusion de contacts en double dans le répertoire XM.
  Astuce Qualtrics : en fusionnant les contacts en fonction du champ Référence des données externes, assurez-vous que chaque contact a une valeur unique.

Intercepts

Pour accéder aux avantages du répertoire XM depuis votre projet d’analyses de sites Web/d’applications, vous devez d’abord vous assurer que Qualtrics sait qui visite votre site Web et qu’il peut associer ces informations à vos contacts existants. Pour ce faire, vous devez indiquer l’expression JavaScript qui est évaluée dans la session connectée de l’utilisateur pour obtenir l’ID de référence externe pour le contact.

Ensuite, vous devrez transmettre les informations relatives à vos visiteurs à Qualtrics. Les étapes sont différentes si vous utilisez un site Web par rapport à une application mobile.

Si vous utilisez un site Web, collaborez avec votre équipe de développement Web pour ajouter l’extrait de code ci-dessous à votre site Web, en plus du code de déploiement du projet. L’extrait de code transmet l’ID externalReference de l’utilisateur à Qualtrics pour associer le visiteur du site Web à un contact dans le répertoire XM. Mettez cet extrait de code au chargement de la page, en vous assurant que la valeur de l’ID a déjà été récupérée.

Cliquez ici pour afficher l’extrait de code.

if(typeof QSI === "unDefined") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }

Si vous utilisez une application mobile, collaborez avec votre équipe de développement d’applications mobiles pour l’intégrer à la dernière version de SDK de l’application Qualtrics Mobile. Pour plus d’informations, voir la documentation de l’API.

Liaison avec le répertoire XM

Lier au répertoire XM vous permet de configurer un lien entre votre intercept et un de vos répertoires à partir du répertoire XM. Lorsque cette option est sélectionnée, les données intégrées de contact des utilisateurs seront automatiquement ajoutées à leur réponse à l’enquête. Pour en savoir plus, voir Utilisation des données intégrées avec le répertoire XM. En outre, un événement dans la chronologie des points de contact du répertoire XM de votre visiteur sera créé chaque fois que votre intercept lui sera affiché.

Utilisation d’un répertoire unique

Nous vous recommandons d’établir un lien vers un seul répertoire par projet. Cela permet de garantir qu’il n’y a aucun problème avec les règles de fréquence de contact, en particulier si le même contact existe dans différents répertoires avec des règles de fréquence différentes. Il consolide également tous les points de contact numériques en un seul endroit pour l’organisation et la maintenance.

Pour déplacer vos intercepts vers un répertoire unique, sélectionnez d’abord le répertoire que vous souhaitez connecter à vos intercepts. Les intercepts actuellement liés à ce répertoire n’ont pas besoin d’être modifiés. Pour tous les intercepts liés à d’autres répertoires, accédez aux Options d’Intercept et désélectionnez Lier à XMD. Vous pouvez également lier cet intercept au répertoire que vous souhaitez utiliser à l’avenir.

Création automatique de contacts

Les contacts du répertoire XM peuvent être créés chaque fois que les utilisateurs visitent des pages Web avec le code de déploiement de projet Qualtrics. Cette option permet d’ajouter automatiquement des contacts lors de l’évaluation d’un intercept, ce qui évite d’avoir à charger manuellement des fichiers ou des automatisations basées sur SFTP.

Pour activer la création automatique de contacts, vous devez d’abord lier l’intercept au répertoire XM. Ensuite, cliquez sur la coche en regard de l’option indiquant Si le contact n’existe pas déjà, créez-le automatiquement dans le répertoire XM.

Vous pouvez ajouter les informations suivantes pour chaque contact :

Prénom
Nom
Langue
Paires de valeurs clés supplémentaires (par ex. “Lieu”:”Seattle”,”Genre”:”Féminin”). Vous pouvez ajouter jusqu’à 200 paires
.

Configuration des règles de fréquence de contact pour les Intercepts

Les règles de fréquence de contact peuvent être configurées pour limiter la fréquence d’affichage d’un intercept. Vous pouvez utiliser des règles générales de répertoire ainsi que des règles personnalisées pour des enquêtes spécifiques. Pour les enquêtes visibles sur de nombreux appareils ou navigateurs, telles que les intercepts de feedback passif, nous vous recommandons de ne pas utiliser la fréquence de contact.

1. Ouvrez l’un de vos projets de Feedback de site Web/d’application ou créez un nouveau projet.
2. Ouvrez l’un de vos intercepts existants ou créez-en un.
3. Modifiez les options Afficher la fréquence et Répertoire XM.
   
4. Activer le lien avec le répertoire XM.
   
   Astuce Qualtrics : lorsque cette option est sélectionnée, les données intégrées des contacts des utilisateurs qui répondent à cette enquête seront automatiquement ajoutées à leur réponse à l’enquête. Voir Utilisation des données intégrées avec le répertoire XM
5. Sélectionnez le répertoire.
6. Activez les règles de fréquence de contact et sélectionnez le répertoire dans lequel les contacts sont sauvegardés.
7. Sauvegardez vos modifications.
8. Les étapes suivantes diffèrent selon que vous implémentez cette fonctionnalité sur un site Web ou une application mobile.
   • Site Web : Sur votre site Web où vous lancerez l’intercept, spécifiez l’expression JavaScript qui sera évaluée lors de la session de connexion de l’utilisateur afin d’obtenir l’ID de référence externe du contact. Cet ID de référence externe est utilisé pour rechercher le visiteur dans le répertoire XM et suivre s’il a vu votre intercept.
   • Application : Dans l’application dans laquelle vous lancerez l’intercept, vous devrez mettre à jour le SDK de votre application mobile afin de récupérer l’ID de référence. Voir la documentation de l’API.

Configuration de segments pour cibler l’Intercept

Une fois que vous avez créé des segments dans le répertoire XM, vous pouvez les utiliser dans Qualtrics à la plupart des endroits que les listes de distribution et les échantillons peuvent utiliser, y compris avec les Analyses de sites Web/d’applications. La combinaison du répertoire XM et des informations sur le site Web/l’application vous permet de cibler l’affichage des intercepts de sites Web et d’applications vers des segments spécifiques d’utilisateurs, ainsi que d’obtenir des informations spécifiques au segment et au parcours.

1. Créer un intercept sur un projet de Feedback de site Web/d’application existant ou nouveau.
   Astuce Qualtrics : si, au lieu de créer un intercept autonome, vous souhaitez obtenir de l’aide tout au long du processus, n’hésitez pas à utiliser notre configuration guidée pour les projets de Feedback site Web/application. Si vous utilisez la configuration guidée, vous serez invité à ajouter un créatif, à connecter votre enquête et à configurer votre intercept. Pour plus d’informations sur la configuration guidée, visitez la page Sélectionner comment vous voulez collecter des commentaires.
2. Accédez aux Options d’Intercept.
   
   Astuce Qualtrics : les étapes sont les mêmes sur les intercepts de l’application mobile, mais vous verrez moins d’options d’intercept.
   
3. Activer « »Lier au répertoire XM» en cochant la case.
4. Sélectionnez le répertoire contenant vos segments.
5. Revenez à votre éditeur d’intercepts et ajoutez une logique de ciblage contenant votre segment de répertoire XM.
   Exemple : par exemple, un segment de répertoire XM est un utilisateur de grande valeur.
   Astuce Qualtrics : sur les intercepts du site Web, vous pouvez tester l’intercept à l’aide du marque-page avec les contacts qui se trouvent dans le segment et avec les contacts qui ne figurent pas dans le segment. Pendant le test, vous devrez imiter le paramètre de l’identifiant de référence externe dans votre navigateur pour que Qualtrics puisse identifier le contact.
6. Les étapes suivantes diffèrent selon que vous implémentez cette fonctionnalité sur un site Web ou une application mobile.
   • Site Web : Sur votre site Web où vous lancerez l’intercept, spécifiez l’expression JavaScript qui sera évaluée lors de la session de connexion de l’utilisateur afin d’obtenir l’ID de référence externe du contact. Cet ID de référence externe est utilisé pour rechercher le visiteur dans le répertoire XM et suivre s’il a vu votre intercept. Voir la section ci-dessus pour plus de détails sur l’expression JavaScript.
   • Application : Dans l’application dans laquelle vous lancerez l’intercept, vous devrez mettre à jour le SDK de votre application mobile afin de récupérer l’ID de référence. Voir la documentation de l’API.

Test de l’intégration du répertoire XM aux intercepts de sites Web

Avant de lancer votre intercept sur votre site Web, vous devez le tester pour vous assurer que la fréquence de contact, le ciblage de segment ou la création de contact ont été correctement implémentés.

Dans votre déploiement réel, l’ID de référence externe du visiteur de votre site sera disponible dans le contexte de sa session journalisée via une expression JavaScript ou un cookie.

Les étapes ci-dessous vous permettent d’effectuer un scénario de bout en bout à l’aide de données de test et de solutions alternatives du navigateur Web.

Tester la fréquence de contact

1. Dans votre répertoire XM Directory, créez un contact et spécifiez un ID de référence unique pour ce contact.
   Exemple : nous allons utiliser aaa123 comme exemple d’ID de référence. À chaque fois que vous voyez le numéro d’identification dans ces étapes, remplacez-le par l’ID de référence que vous avez indiqué.
2. Suivez les étapes de la section Configurer des segments pour cibler un intercept pour suivre le ciblage de segment.
3. Accéder à Tester l’intercept.
   
4. Faites glisser le marque-page dans la barre des signets de votre navigateur.
5. Accédez à une page Web que vous souhaitez utiliser à des fins de test.
6. Accédez à la console développeur. Selon votre navigateur Web, vous l’atteindrez différemment :
   • Google Chrome : dans la barre de menus de Chrome, accédez à Affichage → Développeur → Outils de développement. Dans la fenêtre qui s’affiche, accédez à la console.
   • Apple Safari : Assurez-vous que le menu Développer est activé pour Safari. Pour ce faire, accédez à Préférences → Avancé → Afficher le menu Développer dans la barre de menus. Cliquez sur Développer dans le menu Safari et sélectionnez Afficher Web Inspector. Dans la fenêtre qui s’affiche, accédez à la console.
   • Mozilla Firefox : Cliquez sur l’icône de menu puis sélectionnez Développeur Web. Dans le menu Développeur Web, sélectionnez la console
   • Microsoft Edge : dans la barre de menus, accédez à Outils → Développeur → Outils développeur. Dans la fenêtre qui s’ouvre, accédez à la console.
   • Internet Explorer : cliquez sur l’icône Engrenage et sélectionnez Outils de développement. Dans la fenêtre qui s’ouvre, accédez à la console.
7. Dans le menu Console, saisissez cette expression, puis appuyez sur Entrée:
   UserID="aaa123"
   
   Astuce Qualtrics : aaa123 est notre exemple de valeur d’ID de référence et doit être remplacé par la valeur que vous avez affectée au contact à l’étape 1.
8. Collez l’extrait de code JavaScript ci-dessous pour configurer la variable JavaScript externalReference comme expression JavaScript.
   

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

9. Appuyez sur Entrée.
10. Cliquez sur le marque-page pour voir que le ciblage du segment sera correctement honoré pour déterminer si l’intercept doit ou non être affiché.
    Astuce Qualtrics : pour des raisons de sécurité, la ligne de logique de ciblage qui inclut le segment inclura uniquement l’ID de segment. Pour faire correspondre un ID de segment à un nom de segment, accédez au répertoire XM et modifiez votre segment. L’URL aura l’ID de segment, qui est en gras dans l’exemple d’URL suivant : https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

Pour répéter ces étapes pour des tests supplémentaires, procédez comme suit entre les tests :

1. Actualisez votre navigateur à chaque fois.
2. Configurez l’expression JavaScript dans votre console.
3. Exécutez à nouveau votre marque-page.
4. Accédez au répertoire XM Directory et validez que le contact a été créé avec les valeurs d’entrée.

TESTS DE CRÉATION DE CONTACT

1. Ouvrez l’un de vos intercepts existants ou créez un nouvel intercept dans un projet de feedback de site Web/d’application.
2. Modifiez les options Afficher la fréquence et Répertoire XM.
   
3. Activer le lien avec le répertoire XM.
4. Sélectionnez un répertoire dans la liste déroulante.
5. Cochez la case en regard de Si le contact n’existe pas déjà, créez-le automatiquement dans le répertoire XM.
6. Cliquez sur Enregistrer.
7. Cliquez sur Aperçu de l’intercept.
   
8. Faites glisser le marque-page dans la barre des signets de votre navigateur.
9. Accédez à une page Web que vous souhaitez utiliser à des fins de test.
10. Accédez à la console développeur. En fonction de votre navigateur Web, vous l’atteindrez différemment :
    • Google Chrome : dans la barre de menus de Chrome, accédez à Affichage → Développeur → Outils de développement. Dans la fenêtre qui s’affiche, accédez à la console.
    • Apple Safari : Assurez-vous que le menu Développer est activé pour Safari. Pour ce faire, accédez à Préférences → Avancé → Afficher le menu Développer dans la barre de menus. Cliquez sur Développer dans le menu Safari et sélectionnez Afficher Web Inspector. Dans la fenêtre qui s’affiche, accédez à la console.
    • Mozilla Firefox : Cliquez sur l’icône de menu puis sélectionnez Développeur Web. Dans le menu Développeur Web, sélectionnez la console
    • Microsoft Edge : dans la barre de menus, accédez à Outils → Développeur → Outils développeur. Dans la fenêtre qui s’ouvre, accédez à la console.
    • Internet Explorer : cliquez sur l’icône Engrenage et sélectionnez Outils de développement. Dans la fenêtre qui s’ouvre, accédez à la console.
11. Dans le menu Console, saisissez cette expression avec des exemples de valeurs de contact du répertoire XM, puis appuyez sur Entrée.

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

    

    Astuce Qualtrics : les valeurs de cette expression sont des exemples de valeurs de contact qui seront ajoutées au profil du répertoire XM du contact de test. Vous pouvez modifier ces valeurs en fonction de vos besoins.
    Attention : nous ne prenons pas en charge les adresses e-mail comme attributs de profil afin de préserver des intercepts Web hautement sécurisés. Vous pouvez ajouter des adresses e-mail manuellement via le répertoire ou via des téléchargements de fichiers et des automatisations SFTP.
12. Cliquez sur le marque-page et vous verrez que l’intercept s’affichera.
    Astuce Qualtrics : l’intercept n’a PAS besoin d’être affiché pour que la création du contact fonctionne. Il faut juste l’évaluer sur la page.
    Astuce Qualtrics : d’autres fonctionnalités du répertoire XM, telles que le ciblage de segment ou les règles de fréquence de contact, ne fonctionneront pas dans le cadre du chargement de la même page que celle dans laquelle le profil de contact a été créé. Cependant, une fois le contact créé, tous les intercepts ultérieurs évalueront la fréquence des contacts et les règles de ciblage des segments.
13. Accédez au répertoire XM indiqué dans la liste déroulante de l’étape 3 et vérifiez que le contact a été créé avec les valeurs saisies à l’étape 9.

Astuces relatives à la résolution de problèmes

Un nouvel utilisateur a été ajouté aux segments, mais il ne voit pas d’intercept ciblé sur son segment.

Les segments sont recréés quotidiennement dans le répertoire XM. Par conséquent, il est possible que le nouvel utilisateur n’ait pas encore été comptabilisé comme membre du segment.

La fenêtre du débogueur d’Intercept n’affiche pas les noms des segments.

Pour des raisons de sécurité, nous n’affichons pas le nom du segment dans la fenêtre du débogueur pour toute logique de ciblage comportant des segments. Nous allons afficher l’ID du segment. Pour mapper un ID de segment au nom du segment, modifiez votre segment dans le répertoire XM Directory et examinez l’URL. L’URL aura l’identifiant de segment, qui est mis en surbrillance dans l’exemple d’URL suivant : https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

, vous pouvez ouvrir directement un Intercept et examiner la logique de ciblage pour voir quels segments sont ciblés.

L’intercept tarde à s’afficher pour la première fois des utilisateurs.

Pour des raisons de performance, nous stockons temporairement les membres de segments en mémoire et nous les mettons à jour uniquement si nécessaire. Si un utilisateur n’est pas encore dans notre stockage temporaire, l’intercept de cet utilisateur peut prendre un peu plus de temps pour s’afficher initialement.