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 1 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 projet numérique et un répertoire 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é.

Liaison du répertoire XM au site Web &amp ; projet App Insight

1 site Web &amp ; le projet App Insight peut uniquement être lié à 1 répertoire. 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 lier un projet Site Web ; App Insight à un répertoire, accédez à l’onglet Paramètres du projet, activez Lier au répertoire XM et sélectionnez le répertoire dans la liste déroulante.

Une fois le projet lié à un répertoire, vous pouvez lier un intercept à un répertoire en accédant à Options d’intercept et en sélectionnant Lier cet intercept au répertoire XM.

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 site Web &amp de Qualtrics ; code de déploiement de projet App Insights sur eux. Cette option permet d’ajouter des contacts automatiquement lorsque le code de déploiement du projet Site Web & App Insights s’exécute sur la page Web, éliminant ainsi le besoin de chargements de fichiers manuels ou d’automatisations basées sur SFTP.

Pour activer la création automatique de contacts, vous devez d’abord lier le projet Site Web ; App Insights au répertoire XM dans l’onglet Paramètres du projet. Ensuite, cliquez sur la coche en regard de l’option indiquant Si le contact n’existe pas dans votre répertoire, ajoutez-le automatiquement.

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 un projet d’avis sur le site Web/l’application existant ou créez un nouveau projet.
2. Ouvrez un intercept existant ou créez-en un nouveau.
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. Confirmez le répertoire sélectionné qui est défini à partir de la page Paramètres.
6. Activez les règles de fréquence de contact.
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. Confirmez le répertoire sélectionné qui est défini à partir de la page Paramètres.
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 un projet d’avis sur le site Web/l’application existant.
2. Accédez aux Options.
   
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 dans votre répertoire, ajoutez-le automatiquement.
6. Cliquez sur Appliquer les modifications.
7. Suivez les instructions de l’onglet Déploiement pour copier l’extrait de code de déploiement.
8. Accédez à une page Web que vous souhaitez utiliser à des fins de test.
9. 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.
10. 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.
11. 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.
12. Collez l’extrait de code de déploiement dans la Console, puis appuyez sur Entrée.
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.