Documentation technique sur les informations sur les sites Web/applications

Qu’est-ce qu’un projet Website / App Insights, et pourquoi l’utilisons-nous sur notre site ?

Qualtrics Website/App Insights aide les organisations à mesurer et à améliorer l’expérience d’un visiteur sur son support numérique. Avec un projet d’informations sur le site Web/l’application, vous pouvez présenter des graphiques sympas sur votre site Web avec des liens et des enquêtes intégrées pour obtenir des avis sur l’expérience de vos visiteurs, les informer de vos dernières offres et promotions, et plus encore !

Vous et vos collègues avez un pouvoir sur l’apparence du graphique (également appelé Creative), les conditions dans lesquelles il apparaît (l’intercept) et le code utilisé pour le déployer.

Dès que le code de votre projet est ajouté à votre site Web, vous pouvez apporter toutes sortes de modifications sans même avoir à changer le code ou à alerter votre équipe informatique. Il suffit de faire le travail dans Qualtrics, et les créatifs et intercepts de vos sites Web changeront en conséquence.

Est-ce sécurisé ?

Nous ne transmettons aucune donnée aux serveurs Qualtrics à moins que cela ne soit nécessaire pour la logique de ciblage. Cela dit, nous ne stockons aucune de ces données dans notre système.

Pour sécuriser ces données sur le réseau et les protéger contre les attaques de l’homme du milieu, Qualtrics utilise toujours le protocole HTTPS. Celui-ci fait référence à la manière dont le contenu est transmis au navigateur des visiteurs.

Où puis-je trouver le code de déploiement du projet ?

Le code de
déploiement (ou code de déploiement du projet) peut être trouvé en accédant à l’onglet Déploiement de votre projet. Vous pouvez simplement copier le code et l’envoyer à votre équipe de développement Web pour le mettre en œuvre. Aucune modification ne doit être apportée au code.

Le code de déploiement affiche tout intercept qui a été créé dans l’intégralité du projet.

Comment fonctionne le code ?

Le code de déploiement est asynchrone, c’est-à-dire qu’il ne s’exécute qu’après le chargement de tout le contenu de la page. Autrement dit, le code de déploiement n’empêchera aucun autre aspect de votre page de se charger, car il ne s’exécutera qu’une fois l’événement onLoad déclenché.

Examinons le processus de ce qui se passe lorsqu’un visiteur affiche une page dans son navigateur qui contient le code de déploiement :

• Le code de déploiement (généralement placé dans l’en-tête HTML) s’exécute immédiatement au chargement de la page et insère une autre balise <script> à la fin du corps HTML lorsque l’événement Page onLoad est déclenché.
• Cette balise <script> demande le code JavaScript (Orchestrator) des serveurs Qualtrics mis en cache dans un réseau de diffusion de contenu (CDN).
• L’Orchestrateur effectue un appel de ciblage aux serveurs Qualtrics pour déterminer les créatifs à afficher. Cet appel n’est pas mis en cache dans le CDN.
  • Si nécessaire, une deuxième requête de ciblage est envoyée aux serveurs pour obtenir les données requises (ex : expression JavaScript ou ciblage de cookie).
  • Qualtrics obtient la définition de Site Web/Informations sur les applications à partir de la base de données et crée le code de manière appropriée.
• En fonction de la réponse de ciblage, l’Orchestrateur effectue des appels supplémentaires afin d’obtenir les différents contenus nécessaires pour fournir la page. Le nombre de demandes effectuées varie en fonction du nombre de créatifs pour montrer cette logique de ciblage. Tout ce contenu est mis en cache dans le CDN afin qu’il se charge rapidement.
• Le(s) Creative(s) apparaît(nt) sur la page.

Le code de déploiement est dynamique, ce qui signifie que les modifications apportées aux intercepts et aux créatifs à partir de l’interface du projet Site Web/App Insights n’entraîneront pas la modification du code lui-même. Ainsi, des modifications peuvent être apportées aux projets Website / App Insights à partir d’un compte, et le code n’aura pas besoin d’être échangé sur le site Web pour que les modifications soient visibles.

Comment déployer un projet Website/App Insights ?

1. Ajouter directement du code à vos pages Web

Le code de déploiement peut être ajouté n’importe où sur une page Web. Étant donné que le code s’exécute de manière asynchrone, il ne commencera à se charger qu’une fois que la page Web a complètement chargé tout le contenu (y compris les images, les fichiers scripts, les fichiers CSS, etc.).

Nos demandes commencent à se produire une fois l’événement onLoad déclenché : https://www.w3schools.com/jsref/event_onload.asp

De plus, l’emplacement où les créatifs apparaissent réellement sur la page Web est déterminé par les paramètres déterminés dans l’interface Qualtrics. (Voir les informations sur la position personnalisée.) Ainsi, l’emplacement du code dans la page n’affecte pas l’emplacement du contenu de la page.

2. En-tête/Pied de page global (recommandé)

Nous vous recommandons d’ajouter le code de déploiement dans l’en-tête ou le pied de page global. Le code pourra ainsi être appliqué globalement sur tout le site en une seule fois. Cette méthode est le moyen le plus simple de déployer car vous n’avez pas besoin d’ajouter plusieurs fois du code à d’autres pages au fur et à mesure, ce qui peut être un processus long. Si le code a été ajouté globalement à votre site de cette façon, vous pouvez alors utiliser la logique URL actuelle dans un intercept pour contrôler sur quelles pages un intercept apparaît réellement.

3. Utiliser les gestionnaires de balises

Une autre option consiste à ajouter le code de déploiement à un système de gestion des balises, au lieu de l’appliquer directement au code du site. Le code peut être copié et collé depuis l’interface Qualtrics directement dans un Gestionnaire de balise.

Les systèmes communs de gestion des balises que nos clients utilisent conjointement avec Website / App Insights sont Adobe Launch, Tealium, Ensighten et Google Tag Manager. Tealium en particulier a un assistant construit qui permet une implémentation facile de Website / App Insights. Vous aurez simplement besoin de l’ID de zone du projet que vous mettez en œuvre et de votre ID d’organisation.

L’ID d’organisation peut être obtenu en accédant aux Paramètres du compte et en sélectionnant l’onglet ID Qualtrics.

L’ID de zone commencera par ZN_ et se trouve :

1. Dans l’URL du projet lorsque vous êtes dans celui-ci, ou
   
2. Dans le code de déploiement du projet.
   

Qui est généralement impliqué dans la mise en œuvre de Website/App Insights ?

Quiconque de votre organisation pouvant ajouter du contenu au site Web de votre entreprise. Il s’agit généralement de personnes faisant partie d’une équipe informatique, d’une équipe de contenu Web, etc.

Le site Web/l’analyse des applications ralentira-t-il notre site ?

Le code de déploiement est asynchrone, c’est-à-dire qu’il ne s’exécute qu’après le chargement de tout le contenu de la page. Autrement dit, le code de déploiement n’empêchera aucun autre aspect de votre page de se charger, car il ne s’exécutera qu’une fois l’événement onLoad déclenché.

Que faire si Qualtrics ne fonctionne plus ? Y aura-t-il des problèmes avec notre site Web ?

Si Qualtrics rencontre des pannes ou des problèmes, les intercepts ne s’afficheront tout simplement pas sur la page. Au-delà, il n’y aura pas d’impact sur l’expérience du visiteur sur vos sites.

Combien de temps faut-il au code pour s’exécuter sur mon site Web ?

Nous nous attendons à ce que le code de déploiement se charge en 300 millisecondes pour plus de 50 % des demandes et en 750 millisecondes pour plus de 90 % des demandes. La vitesse varie en fonction de l’emplacement géographique de l’utilisateur et du nombre d’intercepts et de créatifs d’un projet.

Ouverture de la fenêtre de débogage

Vous pouvez utiliser la fenêtre de débogage pour diagnostiquer pourquoi un intercept ne s’est pas affiché sur une page Web spécifique. Cette fenêtre affiche toutes les conditions requises pour que l’intercept apparaisse et si les conditions ont réussi ou échoué.

La façon dont vous ouvrez la fenêtre de débogage dépend du moment où votre intercept a été implémenté.

Intercepts mis en œuvre avant mars 2019

Pour les intercepts dont le code de déploiement a été implémenté avant mars 2019, vous pouvez activer la fenêtre de débogage en ajoutant la chaîne de requêteQ_DEBUG à l’URL. Cette chaîne de requête doit être ajoutée avec un ? ou &, comme illustré dans les exemples ci-dessous :

Intercepts mis en œuvre après mars 2019

Pour les intercepts dont le code de déploiement a été implémenté après mars 2019, suivez ces étapes pour ouvrir la fenêtre de débogage :

1. Ouvrez les outils de développement de votre navigateur.
2. Exécutez la commande JavaScript suivante :
   QSI.API.unload();
QSI.isDebug = vrai ;
QSI.API.load() ;
QSI.API.run();

Astuces relatives à la résolution de problèmes

Logique d’interception et logique d’ensemble d’actions

• Assurez-vous que les valeurs sont correctes.
• Examinez votre utilisation de « Is » vs. “Contient.”
• Examinez votre utilisation de la logique Et/Ou.
• Faites attention aux espaces dans les valeurs.

Historique des révisions

Assurez-vous que la version publiée est la plus récente (ou la version à laquelle vous vous attendez).

Regarder la demande du réseau Insights du site Web/de l’application

1. Ouvrez Outils de développement dans votre navigateur.
2. Consultez la demande de réseau pour ?Q_ZID, etc.
   • Aucune demande de réseau : l’implémentation ne fonctionne pas.
   • Demande de réseau : vérifiez que les paramètres de la demande ne comportent pas d’incohérences. Parfois, le code est mis en œuvre grâce à un système de gestion des balises. Dans certains cas, cette mise en œuvre dérègle les paramètres de notre demande d’URL actuelle, etc.
   • Demande de réseau avec une erreur : vérifiez si votre projet est activé.

Rechercher d’autres requêtes de script pendantes qui peuvent interférer avec notre script

1. Faites un clic droit n’importe où dans votre navigateur.
2. Sélectionnez Contrôler élément.
3. Sélectionnez Console (c’est là qu’apparaissent les erreurs).

FAQ