Catégorie : Voice of customer

Cette intégration est uniquement disponible pour les projets Web

À quoi s'attendre

Cette intégration vous permettra de segmenter les répondants de Qualtrics dans Contentsquare en fonction de leurs interactions et réponses aux feedbacks de Qualtrics. De plus, vous pouvez approfondir les réponses des utilisateurs de Qualtrics en explorant leurs liens de replay de session attachés en tant qu'attributs personnalisés.

Ce que nous collectons

Variables Dynamiques

Pages Vues Artificielles

Pour avoir des pages vues artificielles déclenchées pour ces options ci-dessous, vous devrez demander à votre CSM Contentsquare ou au Support d'autoriser une fonctionnalité qui permettra leur envoi. Notez que celles-ci sont spécifiquement destinées à être utilisées dans le module d'analyse de parcours de l'application Contentsquare.

Ce que nous envoyons

Revisionner la session

Pour utiliser correctement la fonctionnalité de revisionnement, vous devez avoir un ratio de collecte de 100 % ou un ETR (revisionnement déclenché par un événement), veuillez en parler à votre CSM à ce sujet.

Limitations

Général

En raison de la politique officielle de WebKit connue sous le nom de ITP (Prévention Intelligente du Suivi) et de la Prévention Améliorée du Suivi de Firefox, certains navigateurs bloquent les cookies tiers dans les iframes par défaut. Si votre sondage apparaît dans un iframe, alors par défaut nous ne pouvons pas prendre en charge les navigateurs ou modes de navigateur suivants :
Safari 12+
Chrome 83+ (uniquement en mode Incognito)
Firefox 67+ (uniquement en mode navigation privée)

La solution consiste à autoriser le Suivi des iFrames pour le Zoning dans les paramètres du projet Contentsquare, parlez-en à votre CSM ou au support à ce sujet.

Notez que si votre sondage est dans une fenêtre popup ou un nouvel onglet, alors ce qui précède ne s'applique pas.

Qualtrics

Si vous utilisez la nouvelle mise en page "Simple" pour vos sondages, alors elle ne prendra pas en charge l'envoi des évaluations et d'autres données question/réponse à Contentsquare. Toutes les autres fonctionnalités sont prises en charge. Si vous souhaitez envoyer toutes ces données à Contentsquare, vous devrez revenir à l'une des autres options de mise en page telles que "Plate" ou "Moderne". C'est une limitation de Qualtrics.

De plus, si vous passez à la mise en page Simple à un moment donné, vous devrez renommer l'article de Données Intégrées dans le flux du Sondage pour qu'il soit : __js_ContentsquareReplayLink

Sondages Intégrés

Les sondages de feedback intégrés ne sont pas pris en charge. 

Déploiement

Étapes de Déploiement

Si vous avez déjà complété l'étape ci-dessus, alors continuez ci-dessous.

Étape 2

Configuration des données intégrées

Selon que vous utilisez le nouveau flux de configuration d'interception ou l'ancien, veuillez consulter les informations pertinentes ci-dessous.

Pour l'ancien flux :

Pour autoriser cette intégration, veuillez accéder à votre section Application Site web & Feedback dans Qualtrics :

Accéder à Interepts

Sélectionnez le sondage pertinent puis cliquez sur le bouton Données intégrées

Définissez un nouvel objet de données intégrées comme ceci :

CSID | Valeur depuis Javascript | sessionStorage.getItem("CSID")

Appuyez sur enregistrer et publiez ces changements.

Pour le nouveau flux :

Si c'est un nouvel intercept alors dans la configuration vous pouvez voir cela, appuyez sur Ajouter des données intégrées :

Ou si vous avez déjà un intercept configuré, modifiez-le simplement ici :

Ensuite, appuyez sur le signe plus si vous avez déjà des données intégrées définies :

Ensuite, insérez les valeurs comme ceci :

Valeur depuis Javascript | sessionStorage.getItem("CSID") | CSID

Configuration du tag de Contentsquare

Veuillez accéder au sondage que vous souhaitez suivre avec Contentsquare.

Ensuite, cliquez sur la section Apparence, puis sur Général et ensuite sur le bouton Modifier sous En-tête.

Vous avez peut-être déjà du contenu dans cette section, mais vous devrez cliquer sur l'icône Source.

Une fois à l'intérieur, et selon que vous ayez déjà du contenu ou non, vous devez ensuite ajouter un extrait de code HTML/Javascript n'importe où, de préférence tout en haut ou tout en bas pour pouvoir le distinguer des autres articles.

Voici le tag de Contentsquare ci-dessous, mais vous devez demander au support CS votre ID de tag CS. Si vous l'avez déjà, reprenez ci-dessous.

Copiez le code ci-dessous et insérez votre ID de tag Contentsquare dans la section pertinente du code qui dit REPLACE_WITH_TAG_ID. Assurez-vous de garder le .js après l'ID du tag. 

<script>
Qualtrics.SurveyEngine.addOnReady(function () {
    (function () {
        if (!window.CS_CONF){
           window._cs_integration_qualtrics_csid = "${e://Field/CSID}";
		     
           var mt = document.createElement("script");
           mt.type = "text/javascript";
           mt.async = true;
           mt.src = "https://t.contentsquare.net/uxa/REPLACE_WITH_TAG_ID.js";
           document.getElementsByTagName("head")[0].appendChild(mt);
        }
    })();
});
</script>

Ensuite, collez le code complet dans la section HTML de l'en-tête.

Après avoir ajouté le code, cela devrait ressembler à quelque chose comme ceci :

Enregistrez cela et Appliquez les modifications.

Assurez-vous de publier ces modifications dans Qualtrics, sinon le script ajouté ne sera pas reflété en production.

 

Configuration du lien de Replay Contentsquare

Accéder à Flux de sondage :

Selon la mise en page du sondage que vous utilisez, cela déterminera quel nom ajouter ici.

Si vous utilisez le sondage avec une mise en page non simple, alors ajoutez un nouvel article de données intégrées appelé ContentsquareReplayLink exactement comme ceci :

Cependant, si vous utilisez le sondage avec une mise en page simple, alors ajoutez un nouvel article de données intégrées appelé __js_ContentsquareReplayLink exactement comme ceci :

Enregistrer et publier ces modifications.

Envoi de variables dynamiques personnalisées depuis le sondage

Si vous souhaitez envoyer des variables dynamiques personnalisées depuis le contexte du sondage avec vos propres paires clé/valeur, il vous suffit de copier et de modifier ce code ci-dessous et de le coller dans les questions de sondage qui vous concernent. Vous pouvez l'ajouter à plusieurs questions, mais assurez-vous que chaque clé est unique.

Tout ce que vous devez modifier ce sont les valeurs de chaîne des 2 variables dans le code :
var csKey
var csValue 

window._uxa = window._uxa || [];
_uxa.push([
    "afterPageView",
    function (context) {
        if (typeof window.CustomEvent === "function") {
            var csKey = "";
            var csValue = "";

            if (csKey && csValue) {
                var evt = new window.CustomEvent("Contentsquare_QT_Integration_Dispatcher", {
                    detail: {
                        key: csKey,
                        value: csValue,
                    },
                });
                window.dispatchEvent(evt);
            }
        }
    },
]);

Vous pouvez ensuite ouvrir la section Javascript des questions concernées et y coller le code :

Veuillez vous assurer de l'ajouter dans la fonction Qualtrics.SurveyEngine.addOnReady.

Cela devrait alors ressembler à quelque chose comme ceci, mais avec vos propres chaînes de clé et de valeur personnalisées. Les clés et les valeurs peuvent également être générées dynamiquement à l'aide de code, comme montré dans l'exemple de la valeur ci-dessous. Nous prenons l'ID du sondage dynamiquement et le définissons comme la valeur (Page.runtime.ED.SurveyID). Notez que nous n'acceptons que des valeurs de chaîne dans ce cas. La longueur maximale de la clé peut être de 50 caractères et la valeur peut être de 255 caractères.

Si vous utilisez les nouveaux sondages avec la mise en page "Simple", pour obtenir l'ID du sondage, vous devrez utiliser ceci (window.q.appData.setup.survey.id) au lieu de ce qui est montré ci-dessus.

Veuillez noter que nous avons une limitation de 50 variables dynamiques par vue de page, donc si vous en envoyez déjà près de ce nombre, vous ne recevrez peut-être pas d'autres que vous créez. Il est préférable de vérifier combien sont envoyées depuis l'ensemble de votre sondage avant d'en ajouter davantage.

Vérification de son fonctionnement

Vous pouvez utiliser l'extension chrome pour vérifier que les résultats sont envoyés à CS

Dans votre compte Qualtrics, vous pourrez voir des liens de replay si vous avez un ratio de collecte suffisant.

Si votre ratio est trop faible, veuillez en discuter avec votre CSM.