Données intégrées dans Visibilité sur le site Web/l’application

À propos des données intégrées dans les informations sur le site Web/l’application

Toutes les informations qui peuvent être suivies par le site Web/App Insights peuvent également être envoyées à votre site Web cible ou à votre enquête cible. Par exemple, si votre cible est une enquête de satisfaction sur le site Web, vous pouvez choisir d’enregistrer des informations sur la durée pendant laquelle le participant était sur le site Web ou sur le nombre de pages visitées. Ces informations ne sont pas enregistrées dans l’intercept ou le créatif lui-même, mais sont transmises à votre site Web ou à votre enquête.

Vous pouvez transmettre des informations à des enquêtes ou à votre site en définissant des données intégrées. Les données intégrées sont des variables personnalisées qui peuvent être nommées et définies comme égales à toutes les valeurs que vous souhaitez. Par exemple, vous pouvez avoir des données intégrées nommées Emplacement qui peuvent avoir une valeur de États-Unis, Canada, Irlande, etc.

Quand les données intégrées sont-elles capturées ?

Par défaut, les données intégrées sont capturées immédiatement avant que l’enquête ne soit présentée au répondant.

Cependant, certains types et configurations de créatifs modifient ce comportement :

• Bouton d’avis: les données intégrées sont collectées lorsque le visiteur du site clique sur le bouton de feedback.
• Dialogue réactif: l’option « Afficher l’enquête directement dans la boîte de dialogue » modifie la manière dont les données intégrées sont collectées :
  • Lorsque cette option est activée, l’enquête est intégrée directement au créatif et les données intégrées sont capturées dès que le créatif se charge.
  • Lorsque cette autorisation est désactivée, le créatif affiche un bouton permettant d’ouvrir une nouvelle fenêtre pour l’enquête et les données sont capturées lorsque cette nouvelle fenêtre se charge.
• Cibles créatives : Pour les commentaires intégrés personnalisés, les créatifs pop over, les créatifs pop under, les créatifs de curseur et les créatifs de barre d’informations, la cible du créatif contrôle la manière dont les données intégrées sont collectées :
  • Enquête intégrée : lorsque l’enquête est intégrée au créatif, les données intégrées seront capturées dès que le créatif sera affiché.
  • Enquête liée : lorsque l’enquête est ouverte par un lien ou un bouton, les données intégrées seront capturées lorsque vous cliquerez sur le lien ou le bouton.
    Astuce Qualtrics : pour les créatifs, si la session d’enquête commence au changement de page ou à la sortie du site, les données intégrées seront capturées avant l’ouverture de la fenêtre contextuelle.
• ModèleimbriquéCommentaire sur : dès que la première question du créatif d’avis intégré avec modèle est soumise, les données intégrées sont capturées. Par exemple, un créatif d’avis intégré qui pose une question « Est-ce utile ? » suivie d’une question à saisie libre capturera des données intégrées une fois que l’utilisateur aura cliqué sur « Oui » ou « Non » pour la première question.

Mettre à jour les données intégrées après l’ouverture de l’enquête

Certains créatifs mettront continuellement à jour les données intégrées si elles sont mises à jour sur votre site Web pendant que l’enquête d’intercept est ouverte. Par exemple, si l’intercept déclenche l’ouverture d’une enquête dans une nouvelle fenêtre et que le visiteur du site accède à une nouvelle page de votre site, les données intégrées associées à cette session d’enquête ouverte seront mises à jour pour refléter cette nouvelle page.

En outre, les intercepts ne sont pas le seul moyen de collecter des données intégrées. Les valeurs de données intégrées sont collectées dans l’ordre suivant :

1. Les données intégrées d’Intercept sont collectées en premier. Consultez la section Quand les données intégrées sont-elles capturées ? section pour des informations spécifiques en fonction du créatif de l’intercept.
2. Les données intégrées du flux d’enquête sont collectées après la soumission de la réponse à l’enquête. Pour plus d’informations, voir Données intégrées.
3. Les données intégrées du répertoire XM sont appliquées en dernier si l’intercept est lié au répertoire XM et que le contact existe déjà dans le répertoire.

S’il existe des clés de données intégrées identiques au cours de ces 3 étapes, les valeurs collectées en dernier seront enregistrées dans la réponse à l’enquête. Par exemple, si un champ appelé « customerId » est défini par l’intercept, le flux d’enquête et le répertoire XM, la valeur de contact du répertoire XM sera enregistrée pour le « customerId » dans la réponse de l’enquête.

Définir les données intégrées

En règle générale, vous indiquez des données intégrées pour les actions individuelles dans votre intercept. Par exemple, supposons que vous randomisiez deux ensembles d’actions différents. À une action, vous pouvez ajouter un champ de données intégrées appelé “Condition” avec une valeur de “Version 1”, et dans une autre action, vous pouvez ajouter un champ de données intégré appelé “Condition” avec la valeur “Version 2”.

Pour définir des données intégrées sur n’importe quelle action

1. Sur n’importe quelle action, cliquez sur Options.
   
2. Sélectionnez Données intégrées.
3. Saisissez un nom pour votre premier champ de données intégrées.
   
4. Sélectionnez le type de valeur.
   Astuce Qualtrics : une Valeur statique signifie que la valeur du champ de données intégrées sera la même pour chaque visiteur qui reçoit cette action (par exemple, affecter 1 action “Condition” avec une valeur de 1 et l’autre “Condition” avec une valeur de 2). Les autres options de valeur de données intégrées sont dynamiques, ce qui signifie qu’elles s’ajusteront en fonction du visiteur particulier (par exemple, quelle page le visiteur consultait lorsqu’il a vu le Creative).
5. Si un champ est fourni, saisissez une valeur pour vos données intégrées.
   
6. Si vous souhaitez ajouter des champs de données intégrées supplémentaires, cliquez sur le signe plus (+) à droite de votre premier champ et répétez les étapes 4 à 6.
7. Cliquez sur Enregistrer.

Plusieurs champs de données intégrées

L’enregistrement des données intégrées est limité à 20 Ko. Certains champs (comme Historique du site enregistré) occuperont plus de cet espace que d’autres. S’il n’y a pas assez de place pour envoyer tous les champs de données intégrées au site Web cible, les champs en haut de la liste seront classés par ordre de priorité.

Vous pouvez définir la priorité des champs de données intégrées simplement en cliquant sur les points à gauche de n’importe quel champ et en déplaçant l’élément vers le haut ou vers le bas de la liste.

Définir des données intégrées dans un Creative

Les étapes ci-dessus décrivent comment enregistrer des données intégrées pour une action spécifique. Cependant, si vous souhaitez que toutes les actions utilisant un créatif donné aient les mêmes données intégrées, vous pouvez également définir des données intégrées sur le Creative lui-même. Les étapes seront exactement les mêmes, mais vous trouverez le menu des données intégrées en cliquant avec le bouton droit de la souris sur la cible de votre créatif, en cliquant sur la flèche déroulante dans la barre d’outils ci-dessus et en sélectionnant Données intégrées.

Vous pouvez également le trouver dans la section Modifier de votre créatif.

Définition de données intégrées pour plusieurs cibles avec JavaScript

Parfois, vous pouvez vouloir définir des valeurs de données intégrées sur plusieurs images ou cibles dans votre Creative. Cependant, le champ de données intégrées ne peut pas avoir plusieurs cibles dans le Creative. Ce que vous pouvez faire pour capturer et transmettre des informations, c’est utiliser JavaScript pour créer plusieurs champs de données intégrées qui ont chacun leur propre valeur.

<div onclick="window._qLastClicked = 'Happy';">

Afin d’offrir la plus grande flexibilité lors du transfert de données intégrées et du choix des conditions de ciblage pour l’affichage des intercepts, Qualtrics exploite la fonctionnalité intégrée du navigateur pour les expressions JavaScript. Si la politique de sécurité de votre site ne permet pas l’utilisation d’eval, vous pouvez voir une erreur telle que “Refusé pour évaluer une chaîne comme JavaScript car “unsafe-eval” n’est pas une source autorisée de script dans la directive de politique de sécurité de contenu suivante” dans votre console de navigateur.

Si vous voyez cette erreur et que vous ne parvenez pas à mettre à jour les paramètres de la politique de sécurité du contenu de votre site, vous devrez collaborer avec votre équipe d’ingénierie pour exécuter le bloc de code suivant avant le chargement de Qualtrics :

window.QSI = window.QSI || {} ;
window.QSI.config = window.QSI.config || {} ;
window.QSI.global = window.QSI.global || {} ;
window.QSI.config.enableSecureVariables = true ;
window.QSI.global.enableJSSanitization = true;

Après avoir exécuté ce bloc de code, vous pourrez utiliser un sous-ensemble limité de JavaScript dans vos conditions de ciblage et vos champs de données intégrées. Ce sous-ensemble de JavaScript autorise uniquement l’accès variable à l’aide des opérateurs point («. ») et parenthèse (« [] »), ce qui vous permettra de rassembler le contexte variable sans vous soucier des problèmes de sécurité autour de l’exécution de la fonction. Vous ne pouvez pas utiliser d’appels de fonction, tels que document.querySelector().

Types de valeur des données intégrées

Lorsque vous définissez la valeur de vos données intégrées, vous pouvez choisir le type de variable de ces données intégrées. Vous trouverez ci-dessous une explication de ce que chaque type de données intégrées capture et des conditions d’interception associées.

• Statique : créez des données intégrées personnalisées et définissez leurs valeurs.
• ID de l’intercept : cette action capture l’ID interne de l’intercept. Cet ID peut être utilisé pour voir quel intercept un visiteur a vu si vous avez plusieurs intercepts renvoyant au même site/enquête.
• ID du créatif : capture l’ID interne du créatif. Cet ID peut être utilisé pour voir quel créatif a été vu par un visiteur si vous avez plusieurs créatifs qui renvoient au même site/enquête.
• Historique du site enregistré : cette fonction capture tous les sites visités par votre visiteur qui ont le code projet sur la page. Ces informations sont stockées dans un cookie, que le site Web/App Insights place sur le navigateur.
  Astuce Qualtrics : la quantité d’historique enregistrée dépend des limites placées sur ce cookie. La limite est définie sur la page Admin.
• Suivi des événements : vous permet de configurer le suivi des événements.
• Adobe Analytics : voir Adobe Analytics.
• Adobe Experience ID : voir Adobe Analytics.
• Nombre de pages visitées uniques : cette fonction enregistre le nombre de pages visitées par l’utilisateur sur votre site. Par exemple, visiter la même page compte deux fois pour 1 page. Voir Conditions de comptage de pages.
• Nombre total de pages visitées : cette fonction capture le nombre total de pages visitées par l’utilisateur sur votre site. Voir Conditions de comptage des pages.
• Temps passé sur site : le temps passé sur site enregistre 2 métriques : le temps passé sur site et le temps consacré au site. Le Temps passé sur le site fait référence à la durée pendant laquelle le visiteur a ouvert votre site Web dans une fenêtre de navigateur. Time Focused On Site fait référence à la durée pendant laquelle le visiteur a vu votre site ouvert comme la fenêtre avant, “in-focus” sur son ordinateur.  Voir Temps passé sur le site ou Temps focalisé sur le site.
  Astuce Qualtrics : dans vos données, le temps passé sur site et le temps consacré au site seront sauvegardés ensemble sous la forme de 2 numéros séparés par une ligne verticale. Le nombre sur le côté gauche de la ligne est Time Passent On Site tandis que le numéro à droite de la ligne est Time Focused On Site.
  
• URL de la page actuelle : page sur laquelle se trouve le visiteur lorsque l’Intercept apparaît. Voir URL de la page actuelle.
• HTML sur le site : indiquez le code HTML sur la page pour laquelle vous souhaitez capturer la valeur. Par exemple, vous pouvez avoir un élément pour votre panier et vous souhaitez connaître le nombre d’articles dans le panier du visiteur. Voir HTML sur le site.
• Valeur du cookie : capturez la valeur d’un cookie spécifique sur votre site. Par exemple, vous pouvez avoir un cookie nommé return_visitor qui capture si quelqu’un a visité votre site avant ou non. Voir Condition des cookies.
• Paramètre URL : si des paramètres sont ajoutés aux URL sur votre site Web, cette option vous permet de capturer la valeur du paramètre de votre choix.
• URL Regex : capture du codage Regex.
  Astuce Qualtrics : Regex est une fonctionnalité de codage personnalisée. Malheureusement, le support de Qualtrics ne peut pas vous conseiller sur le codage personnalisé. Vous pouvez plutôt tenter de vous adresser à notre communauté d’utilisateurs dédiés.
• Valeur de JavaScript : cette option capture le JavaScript personnalisé de votre site. La valeur indiquée doit être une expression/un appel JavaScript.
  Astuce Qualtrics : JavaScript est une fonctionnalité de codage personnalisée. Malheureusement, le support de Qualtrics ne peut pas vous conseiller sur le codage personnalisé. Vous pouvez plutôt tenter de vous adresser à notre communauté d’utilisateurs dédiés.
• Référent de page : La page sur laquelle se trouvait le visiteur avant d’arriver sur la page avec votre intercept. Voir Référent de page.
• Référent du site : Le site web sur lequel se trouvait le visiteur avant d’arriver sur votre site. Voir Référent du site.
• Critère de recherche : capture le terme que le visiteur a recherché pour arriver sur votre site Web. Voir Critère de recherche.
• Valeur de la couche de données Google : cette option capture les variables de couche de données Google personnalisées sur votre site. Voir Utilisation de Google Analytics dans Web/App Insights.

Enregistrer des données intégrées dans une enquête Qualtrics

Si votre cible est une enquête Qualtrics, les données intégrées qui lui sont envoyées pourront être utilisées dans la logique d’enquête sans action supplémentaire nécessaire. Cependant, si vous souhaitez enregistrer ces données intégrées dans les résultats de l’enquête, vous devrez les ajouter à votre flux d’enquête.

Suivez les étapes de la page d’assistance sur les données intégrées pour l’ajouter à votre flux d’enquête. Pour la valeur du champ, laissez-la comme Valeur sera définie à partir du panneau ou de l’URL.

Utilisation de données intégrées avec d’autres cibles

Même si votre cible n’est pas une enquête Qualtrics, vous pouvez toujours exploiter les données intégrées et transmettre les informations, comme vous le feriez avec une enquête Qualtrics. Les données intégrées seront transmises dans le corps de la demande (méthode POST), afin que vous puissiez capturer et envoyer plusieurs éléments de données intégrées à la plateforme Qualtrics XM sans avoir à les voir dans l’URL visible de l’enquête.

Tester la collecte de données intégrées

Vous pouvez tester les données intégrées qui ont été collectées en exécutant cet extrait de code dans la console du développeur lorsque vous vous attendez à ce que les valeurs de données intégrées soient collectées par l’intercept :

window.QSI.EmbeddedData.getEmbeddedData('YOUR_INTERCEPT_ID')

Si les valeurs collectées ne correspondent pas à vos attentes ou sont vides, la correction des erreurs dépend du type de données intégrées que vous attendez de collecter :

1. Statique : s’il manque des champs de données intégrées statiques ou qu’ils sont incorrects, vous devrez peut-être publier la dernière version de l’intercept.
2. Google Data Layer: Si des champs de données intégrés à Google Data Layer sont manquants ou incorrects, il se peut que vous ayez la mauvaise expression de couche de données. Sinon, la valeur peut avoir été écrasée par une mise à jour ultérieure de la couche de données. Qualtrics effectue uniquement le suivi de la valeur la plus récente dans la couche de données. Pour plus d’informations sur l’intégration de la couche de données Google à un intercept, voir Utilisation de Google Analytics avec Site Web/App Insight.
3. JavaScript : s’il manque des champs de données intégrées JavaScript incorrects, il se peut que vous ayez la mauvaise expression. Contactez votre équipe de développement pour confirmer que la variable que vous recherchez est présente sur la page que vous testez.

Dépannage des données intégrées vides ou incorrectes dans les réponses à l’enquête

Si les variables apparaissent lors du test, mais pas dans la réponse réelle de l’enquête, il peut y avoir un problème de minutage entre le moment où Qualtrics saisit les données et le moment où les données sont réellement disponibles sur la page.

Suivez les étapes ci-dessous pour résoudre le problème :

1. Rechargez la page, puis testez vos données intégrées à l’aide de l’extrait de code dans la section ci-dessus.
2. Exécutez le code suivant dans la console de votre navigateur :
   QSI.API.unload() ;
QSI.API.load().then(QSI.API.run);
3. Répondez à l’enquête.
4. Une requête HTTPS apparaîtra dans le journal réseau du site Web lorsqu’une session d’enquête commencera via un intercept. Cette demande comprend l’ID de l’enquête et toutes les données intégrées mappées de la configuration de l’intercept. La vérification des données utiles de cette demande peut vous aider à vérifier si la session a commencé avec des données intégrées.

Si les valeurs correctes sont maintenant transmises, il s’agit probablement d’un problème de minutage et vous devrez déclencher votre intercept une fois les valeurs de données renseignées sur votre page. Cette opération peut être effectuée via les appels QSI.API ou à l’aide d’un gestionnaire de balises. Voir Code de déploiement de projet pour plus d’informations.

Afficher les données intégrées d’Intercept dans un tableau de bord

Il se peut que vous souhaitiez afficher vos analyses Web/d’applications dans un tableau de bord expérience client. Cette section décrit les étapes générales d’affichage de vos données intégrées dans un format lisible.

1. Dans votre logique d‘intercept, ajoutez les champs de données intégrées que vous souhaitez afficher dans votre tableau de bord.

   Astuce Qualtrics : les champs communs incluent :

   • ID de l’intercept : pour afficher l’ID ou le nom de l’intercept.
   • ID du créatif : pour afficher l’ID ou le nom du créatif.
   • Valeur de JavaScript : permet d’afficher les données d’une expression JavaScript.
   • Variables Adobe Analytics : pour afficher les données des eVars personnalisés Adobe Analytics.
   • Valeur statique : pour transmettre une valeur personnalisée, telle que le nom de l’intercept, le nom du créatif ou des informations sur votre site Web.
2. Dans l’enquête affichée dans votre intercept, ajoutez des champs de données intégrées qui correspondent à vos champs d’intercept.
   
3. Mappez votre enquête à un tableau de bord expérience client, en vous assurant d’inclure vos champs de données intégrées.
4. Si vous affichez un champ tel que Identifiant de l’Intercept ou Identifiant du Creative, vous pouvez recoder votre identifiant pour qu’il affiche l’intercept ou le nom du créatif à la place.
   Exemple : dans l’exemple ci-dessus, nous affichons les données de 2 créatifs différents dans le même tableau de bord. Pour rendre l’affichage des données pour les créatifs individuels convivial, nous avons ajouté l’ID du Creative en tant que champ de données intégrées et recodé les valeurs d’ID individuelles pour qu’elles correspondent aux noms des créatifs. Nous pouvons ensuite ajouter ce champ comme filtre de tableau de bord et utiliser ce champ dans les widgets.

FAQ