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 intercept, mais il ne s'affiche pas sur mon site. Pourquoi ?
J'ai activé mon intercept, mais il ne s'affiche pas sur mon site. Pourquoi ?
- Logique: la logique de ciblage des interceptions et la logique de l'ensemble d'actions sont les conditions qui doivent être remplies pour qu'une interception soit affichée à un visiteur. Discover this logic will be helpful in discovering why the Intercept is not displaying on a page actuelle.
- Les ensembles logiques qui utilisent "Contient" : Une cause fréquente d'erreur de logique est l'utilisation de la fonction "Contient" vs. "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.
- Révisions des intercepts: Lorsque des modifications sont apportées aux intercepts, elles ne sont pas mises en ligne tant que l'intercept n'est pas publié. 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 vérifier pourquoi un intercept ne s'affiche pas sur une page particulière.
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 œuvre après mars 2019, exécutez le snippet JavaScript suivant dans la Console de votre page web :QSI.API.unload() ; QSI.isDebug = true ; QSI.API.load() ; QSI.API.run() ;La fenêtre de débogage décompose toutes les conditions requises pour que les intercepts s'exécutant 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.Astuce: Le débogueur de Website Insights ne fonctionne pas si le code a été implémenté à l'aide d'un gestionnaire de balises. De même, si la chaîne de requête de l'URL contient déjà un ?, le débogueur demandera un & à la place. - Demande de réseau: La plupart des navigateurs possèdent un menu d'outils de développement qui permet à l'utilisateur de voir le code source, les ressources, les cookies et les appels réseau d'un site. 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: Si vous recevez un journal de console qui viole une politique de sécurité du contenu, il y a très probablement une restriction sur votre site Web qui bloque le déploiement de nos intercepts. 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 recommandons généralement d'autoriser les éléments suivants dans les en-têtes de votre politique de sécurité du contenu :
- connect-src https://*.Qualtrics.com
- frame-src https://*.Qualtrics.com
- img-src https://siteintercept.qualtrics.com
- script-src https://*.Qualtrics.com
- Gestion des URL de SPA : Si votre site utilise un cadre d'application à page unique (SPA), assurez-vous que votre code déclenche 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 crochets de cycle de vie similaires, assurez-vous que votre logique d'intercept s'exécute une fois la navigation terminée.
Quelle est la différence entre le code de zone et le code d'interception ? Maintenant qu'elle est appelée « code projet » dans la nouvelle interface, qu'est-ce que cela signifie ?
Quelle est la différence entre le code de zone et le code d'interception ? Maintenant qu'elle est appelée « code projet » dans la nouvelle interface, qu'est-ce que cela signifie ?
Les zones (désormais « Projets ») servent de collections pour plusieurs créatifs et intercepts. Les codes de zone contiennent tous les Intercepts de la zone. Cela vous permet d'implémenter un seul code sur votre site au lieu d'ajouter continuellement des codes pour des intercepts individuels. Cela peut gagner beaucoup de temps, puisque chaque fois que vous activez du contenu sur la zone, il est automatiquement ajouté au code, ce qui ne nécessite aucune modification. Les
projets sont l'équivalent des zones, de sorte que le code de déploiement de projet est l'équivalent des anciens codes de zone.
J'ai créé mon intercept mais je voudrais le tester avant l'activation. Comment puis-je faire ça ?
J'ai créé mon intercept mais je voudrais le tester avant l'activation. 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!