Onglet Déploiement
Contenus de cette page
Astuce : Si vous n’avez pas accès à l’une des fonctions décrites sur cette page, contactez votre Commercial. Pour plus d’informations sur les différences entre Digital Feedback et CustomerXM for Digital, voir Digital Feedback vs. CustomerXM pour Digital.
À propos de l’onglet Déploiement
Lorsque vous êtes enfin prêt à déployer votre projet Website / App Insights sur votre site web, rendez-vous dans l’onglet Déploiement pour récupérer le code que vous allez mettre en œuvre sur votre site web.
Attention : N’apportez aucune modification à votre code de déploiement. Le support de Qualtrics ne peut pas résoudre les problèmes liés à l’édition du code de déploiement.
Code de déploiement du projet
Le code du projet contient tous les intercepts actifs et leurs créatifs dans le projet.
Mise en œuvre du code du projet
Le code du projet peut être placé sur n’importe quelle page où vous souhaitez afficher des créatifs à vos visiteurs. En outre, vous voudrez également placer le code sur toutes les pages pour lesquelles vous souhaitez que le projet Website / App Insights suive ou collecte des informations.
Attention : Si vous créez plusieurs projets Website / App Insights dans Qualtrics, chaque projet aura son propre extrait de code de déploiement Javascript. Vous pouvez créer plusieurs projets et les utiliser sur différents sites web, sous-sites, ou même pour le déploiement vers les tests et la mise en scène. Toutefois, nous vous recommandons vivement de ne pas déployer plusieurs extraits de code Javascript provenant de projets distincts et de les faire fonctionner simultanément sur les mêmes sections ou pages de votre site web. Cela peut entraîner des problèmes de chronomètre et de chargement, en particulier si vous faites des appels à l’API Javascript de QSI.
Attention : Si votre projet s’inscrit dans notre environnement FedRAMP et que le domaine de votre site web ne se termine pas par .gov, vous devrez contacter le support FedRAMP pour demander que votre domaine soit inscrit sur la liste d’autorisation. Si vous tentez d’exécuter un intercept avant de le faire, vous rencontrerez une erreur de console “No Access-Control-Allow-Origin”. Cette mesure de sécurité renforcée devra également être appliquée à tout sous-domaine ne se terminant pas par .gov.
Exemple : L’affichage d’une pop-over pour tous les visiteurs de la page d’accueil ne nécessite que l’insertion d’un code sur la page d’accueil. Cependant, l’affichage de ce pop-over aux seuls visiteurs de la page d’accueil qui se sont précédemment rendus sur la page du panier d’achat nécessite que le projet Website / App Insights sache qu’un visiteur a consulté le panier d’achat. Par conséquent, le code doit également être placé sur la page du panier d’achat.
Ajouter l’extrait de code à votre site par vos propres moyens
Astuce : pour une mise en œuvre plus facile, nous recommandons de placer le code dans un en-tête ou un pied de page global, de sorte qu’il se charge sur toutes les pages du site web. Il s’agit de l’implémentation la plus flexible et la plus utile, car elle vous permet d’exécuter des intercepts sur n’importe quelle page de votre site. Toutefois, cette méthode entraînera également un niveau d’utilisation plus élevé, puisque chaque fois que le code s’exécutera sur une page, il sera considéré comme une page vue. Veillez à vérifier que votre licence est adaptée à ce volume d’utilisation.
Envoi de l’extrait de code à votre développeur de site web
Au lieu de mettre à jour le code du site web vous-même, vous pouvez également choisir de demander à votre développeur de site web de le faire pour vous. Dans ce cas, il suffit de copier l’extrait de code et de l’envoyer par courriel à l’équipe de développement de votre site web.
Votre développeur peut placer le code dans l’en-tête ou le pied de page de chaque page HTML, ou dans l’en-tête ou le pied de page global, de sorte qu’il se charge sur toutes les pages du site web.
Utilisation d’une solution tierce de Tag Management
Une autre option pour mettre en œuvre les projets Website / Appliquer sur votre site consiste à l’ajouter à un système de gestion des balises au lieu de l’appliquer directement au code du site. Le code peut être copié et collé de l’interface Qualtrics directement dans un manager de tags. Pour plus d’informations, consultez notre page sur l ‘utilisation des gestionnaires de balises.
Les systèmes de gestion des balises couramment utilisés par nos clients dans le cadre de projets Website / App Insights sont Tealium, Adobe, Google Tag Manager et Ensighten. Tealium a construit un assistant qui permet une mise en œuvre facile des projets Website / App Insights.
Astuce : Le support de Qualtrics n’est pas en mesure de résoudre les problèmes liés au code appliqué aux gestionnaires de balises car nous ne pouvons pas voir ou ajuster les paramètres qui ont été activés de votre côté. Veuillez consulter notre page sur l ‘utilisation des gestionnaires de balises.
Tester le code de votre projet
Vous pouvez tester votre code avant de l’ajouter à votre site web ou de publier vos modifications. Pour plus d’informations, voir Test des modifications non publiées.
FAQs
J'ai activé mon système d'interception, mais il n'apparaît pas sur mon site. Pourquoi ?
J'ai activé mon système d'interception, mais il n'apparaît pas sur mon site. Pourquoi ?
- Logique: la logiquede ciblage par interception et l’ensemble d’actions correspondent aux conditions qui doivent être remplies pour qu’une interception s’affiche à un visiteur. Discover this logic will be helpful in discovering why the Intercept is not displaying on a page actuelle.
- Ensembles logiques utilisant « Contient » : une cause fréquente d'erreur logique réside dans l'utilisation de « Contient » par opposition à "Est" Dire qu'une condition "contient" signifie que le paramètre sur lequel vous basez la logique (c'est-à-dire l'URL actuelle) aura la valeur spécifiée présente en plus d'autres informations. Par exemple, si j'avais une logique qui disait que l'URL actuelle contient "qualtrics", l'intercept s'afficherait sur toute URL contenant le mot "qualtrics". L'autre possibilité qui s'offre à vous est d'utiliser l'URL actuelle [URL]. Cette condition dépend de la correspondance exacte de l'URL visitée. Toute différence ou caractère supplémentaire empêchera la logique d'intercept de passer.
- Modifications des interceptions: lorsque vous modifiez des interceptions, les changements ne sont effectifs qu'une fois l'interception publiée. Lorsqu'un Intercept est publié, une version de l'Intercept, ou "révision", est sauvegardée. L'évaluation des révisions effectuées est très utile pour identifier les changements qui ont pu soudainement empêcher l'intercept d'apparaître.
- Fenêtre de débogage: La fenêtre de débogage est un outil précieux pour déterminer pourquoi une interception ne s'affiche pas sur une page donnée.
Pour les intercepts dont le code de déploiement a été mis en œuvre avant mars 2019, pour activer la fenêtre de débogage, ajoutez à toute URL donnée une chaîne de requête appelée Q_DEBUG. Il doit être précédé d'un « ? » ou d'un « & », comme dans les exemples suivants : https://www.qualtrics.com?Q_DEBUG, https://www.qualtrics.com/blog?item=value&Q_DEBUG.
Pour les intercepts dont le code de déploiement a été mis en place après mars 2019, exécutez l'extrait de code JavaScript suivant dans la console de votre page Web :La fenêtre de débogage décompose toutes les conditions requises pour que les intercepts en cours d'exécution sur l'URL apparaissent. Si vous constatez qu'un intercept n'apparaît pas, localisez-le dans la fenêtre de débogage et identifiez les éventuels avertissements d'échec en rouge.
QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();Astuce : le débogueur de Website Insights ne fonctionne pas si le code a été mis en place à l'aide d'un gestionnaire de balises. De plus, si l'URL contient déjà une chaîne de requête commençant par un « ? », le débogueur exigera alors un « & » à la place. - Requêtes réseau: la plupart des navigateurs disposent d'un menu « Outils de développement » qui permet à l'utilisateur de consulter le code source d'un site, ses ressources, ses cookies et ses requêtes réseau. Website Insights possède une présence distincte dans la section Réseau de ces outils. Pour vérifier l'exécution de ces scripts, ouvrez les outils de développement et naviguez jusqu'à la section Réseau. Une fois cette étape franchie, rechargez la page web et le menu devrait commencer à s'enrichir de toutes les requêtes réseau effectuées par le site web. Pour identifier le code de Website Insights, recherchez les appels qui commencent par ?Q_ZID ou ?Q_SID. Il s'agit du code lui-même qui effectue des contrôles sur la logique d'affichage. Si vous ne trouvez rien qui corresponde à ce format, c'est qu'il y a un problème dans la mise en œuvre du code de votre projet. Vous pouvez consulter notre page d'assistance sur la mise en œuvre pour obtenir des conseils sur l'endroit le plus approprié pour placer le code.
- Problèmes liés à la politique de sécurité du contenu(CSP): si vous recevez un message de journal de la console indiquant une violation de la politique de sécurité du contenu, cela signifie très probablement qu'une restriction appliquée à votre site web empêche le déploiement de nos interceptions. Nous vous recommandons de contacter votre équipe de développement web pour résoudre ce problème. Pour garantir le bon fonctionnement de vos interceptions, nous vous recommandons généralement d'ajouter les éléments suivants à la liste blanche dans les en-têtes de votre politique de sécurité du contenu (CSP) :
- connect-src https://*.Qualtrics.com
- frame-src https://*.Qualtrics.com
- img-src https://siteintercept.qualtrics.com
- script-src https://*.Qualtrics.com
- Gestion des URL dans les applications monopages (SPA ) : si votre site utilise un framework d'application monopage (SPA), assurez-vous que votre code appelle la fonction `history.pushState()` lors de la navigation entre les vues. Certains frameworks peuvent réafficher ou mettre à jour l'URL sans pousser une nouvelle entrée dans l'historique, ce qui peut empêcher les intercepts de se déclencher. Si vous utilisez useEffect ou des hooks de Lifecycle similaires, assurez-vous que votre logique d'interception s'exécute une fois la navigation terminée.
Quelle est la différence entre un code de zone et un code d'interception ? Maintenant que cela s'appelle « code du projet » dans la nouvelle interface, qu'est-ce que cela signifie ?
Quelle est la différence entre un code de zone et un code d'interception ? Maintenant que cela s'appelle « code du projet » dans la nouvelle interface, qu'est-ce que cela signifie ?
Les zones (désormais appelées « Projets ») servent de regroupements pour plusieurs créations et interceptions. Les codes de zone regroupent toutes les intersections de la zone. Cela vous permet d'intégrer un seul code sur votre site, plutôt que d'ajouter sans cesse des codes pour chaque interception. Cela peut vous faire gagner beaucoup de temps, car chaque fois que vous activez du contenu dans la zone, celui-ci est automatiquement ajouté au code, sans qu'aucune modification ne soit nécessaire.
Les projets correspondent aux zones ; le code de déploiement d'un projet correspond donc aux anciens codes de zone.
J'ai mis au point mon système d'interception, mais j'aimerais le tester avant de le mettre en service. Comment puis-je faire ça ?
J'ai mis au point mon système d'interception, mais j'aimerais le tester avant de le mettre en service. Comment puis-je faire ça ?
Lorsque je déploie mon intercept, l'erreur "No Access-Control-Allow-Origin" s'affiche. Comment réparer ça ?
Lorsque je déploie mon intercept, l'erreur "No Access-Control-Allow-Origin" s'affiche. Comment réparer ça ?
Si votre projet se trouve dans notre environnement FedRAMP et que le domaine de votre site Web ne se termine pas par .gov, vous devrez contacter le support de FedRAMP pour demander que votre domaine soit sur liste blanche. Si vous tentez d'exécuter un intercept avant de le faire, vous obtiendrez une erreur de console "No Access-Control-Allow-Origin". Cette mesure de sécurité renforcée devra être effectuée pour tout sous-domaine qui ne se termine pas par .gov également.
C'est génial! Merci pour votre avis!
Merci pour votre avis!