Catégorie : Analytics

Cette intégration est uniquement disponible pour les projets Web

À quoi s'attendre

Cette intégration vous permettra d'analyser les données de n'importe où dans le parcours client en utilisant vos segments Adobe Analytics. Contentsquare vous permet d'utiliser vos segments Adobe Analytics dans chaque fonctionnalité de Contentsquare (analyse de parcours, Page Comparator, analyse de zoning, replay de session).

Pour importer vos segments, vous devez ajouter un extrait de code à votre configuration de code Adobe. Ce code envoie un identifiant unique à Adobe Analytics. Il nous aide à faire correspondre les sessions Adobe Analytics avec celles de Contentsquare.

Ce que nous collectons

Variables Dynamiques

csMatchingKey

Fait référence à la valeur unique utilisée pour faire correspondre les segments Adobe avec les sessions Contentsquare.

Implémentation

Étapes d'Implémentation

Créer un eVar

Veuillez configurer un eVar dédié à Contentsquare avec les paramètres suivants définis comme vous le voyez ci-dessous :

Il existe plusieurs façons d'intégrer le code, mais nous allons couvrir les options suivantes :

• Adobe Launch - Extension Adobe Analytics
• Adobe Launch - Extension Adobe Experience Platform Web SDK
• fonction doPlugins (configurations héritées d'Adobe Analytics)
• Tealium Tag Manager

Adobe Launch - Extension Adobe Analytics

Dans Adobe Launch, ouvrez votre extension Adobe Analytics et appuyez sur Configurer

Si vous utilisez l'une de ces options supplémentaires montrées ici, PUIS veuillez plutôt utiliser la 2ème option ci-dessus > fonction doPlugins (Adobe Site Catalyst - configurations héritées)

Pour que cela fonctionne, vous devez utiliser l'option Gérer la bibliothèque pour moi

Faites défiler vers le bas pour CONFIGURER LE TRACKER À L'AIDE D'UN CODE PERSONNALISÉ et appuyez sur le bouton Ouvrir l'Éditeur.

Récupérez le code pertinent ci-dessous dans la section de code et collez-le dans la boîte de l'éditeur de code ouverte et économisez-le puis publiez les modifications

Adobe Launch - Extension SDK Web de la plateforme Adobe Experience

Dans Adobe Launch, accédez à l'extension SDK Web de la plateforme Adobe Experience et appuyez sur Configurer.

Faites défiler vers le bas jusqu'à la section Collecte de données et recherchez la section Fournir le code de rappel d'envoi d'événement avant. Cliquez dessus.

Récupérez le code pertinent ci-dessous dans la section de code et collez-le dans la boîte de l'éditeur de code ouverte et économisez-le puis publiez les modifications.

fonction doPlugins (configurations héritées d'Adobe Analytics)

Récupérez le code pertinent ci-dessous dans la section de code puis accédez à votre fichier de code s Adobe Analytics et collez-le dans la fonction doPlugins.

Tout d'abord, modifiez la ligne de code ci-dessous qui a s.eVarX défini et soit gardez s comme nom d'objet ou renommez-le en votre équivalent mais définissez également X à la valeur de l'eVar dédié.

s.eVarX = cmk;

 

Configuration du gestionnaire de balises Tealium

Dans votre compte Tealium, accédez à la section Data Layer sous la section iQ Tag Management

Cliquez sur Ajouter une variable

Définissez le type sur Variable UDO et faites de la source cs_matching_key ou nommez-le comme vous le souhaitez mais si vous le renommez, modifiez également et utilisez le même nom dans le code.

Enregistrez cela et vous devriez avoir ceci

Accédez à votre container de balises Adobe Analytics sous la section Balises et modifiez vos Variables Mappées

Recherchez la variable que vous avez créée cs_matching_key ou quel que soit le nom que vous lui avez donné, puis sélectionnez-la et appuyez sur Sélectionner la destination.

Cliquez sur eVars puis sélectionnez l'eVar que vous avez définie dans Adobe Analytics et enregistrez cela

Vous devriez alors voir quelque chose comme ceci

Ensuite, allez dans Extensions et créez une extension de code Javascript.

Donnez-lui un nom en rapport avec l'intégration Adobe et Contentsquare et définissez le domaine sur la balise Adobe Analytics.

Récupérez le code pertinent ci-dessous dans la section de code et collez-le là-dedans.

Le Code

Veuillez noter que si vous avez une politique de cookie qui exige que nos cookies soient d'abord acceptés avant l'injection, il vous appartient de vous assurer que le code ci-dessous est enveloppé dans la logique de votre politique de consentement aux cookies.

Adobe Launch - Extension Adobe Analytics & fonction doPlugins

Dans le code ci-dessous, vous devez Modifier s.eVarX et changer X par la valeur eVar que vous avez définie pour cette intégration

s.eVarX = cmk;

/*
 *Nom: Intégration CS Adobe Analytics
 *Version: 1.9.0 (Adobe Launch + csMatchingKey)
 */
(function () {
    var version = "1.9.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Adobe Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_aa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var tld = (function () {
                var i = 0,
                    domain = document.domain,
                    p = domain.split("."),
                    s = "_cs_tld" + new Date().getTime();
                while (i < p.length - 1 && document.cookie.indexOf(s + "=" + s) == -1) {
                    domain = p.slice(-1 - ++i).join(".");
                    document.cookie = s + "=" + s + ";domain=" + domain + ";SameSite=None;Secure";
                }
                document.cookie = s + "=;expires=Thu, 01 Jan 1970 00:00:01 GMT;domain=" + domain + ";";
                return domain;
            })();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=" + tld + ";SameSite=None;Secure";
        }

        s.eVarX = cmk;

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    var cookies = "; " + document.cookie;
    if (cookies) {
        var getCookie = cookies.split("; " + cn + "=");

        if (getCookie.length == 1) {
            init();
        } else {
            var cookieValue = getCookie[1].split(";")[0];
            init(cookieValue);
        }
    }
})();
//Fin de l'intégration CS Adobe Analytics

Adobe Launch - Extension SDK Web de la plateforme Adobe Experience

Dans le code ci-dessous, vous devez Modifier content.xdm. _experience.analytics.customDimensions.eVars.eVarX et changer X par la valeur eVar que vous avez définie pour cette intégration

/*
 *Nom: Intégration CS Adobe Analytics
 *Version: 1.0.0 (Adobe Launch / Extension SDK Web de la plateforme Adobe Experience)
 */
(function () {
    var version = "1.0.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Adobe Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_aa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var tld = (function () {
                var i = 0,
                    domain = document.domain,
                    p = domain.split("."),
                    s = "_cs_tld" + new Date().getTime();
                while (i < p.length - 1 && document.cookie.indexOf(s + "=" + s) == -1) {
                    domain = p.slice(-1 - ++i).join(".");
                    document.cookie = s + "=" + s + ";domain=" + domain + ";SameSite=None;Secure";
                }
                document.cookie = s + "=;expires=Thu, 01 Jan 1970 00:00:01 GMT;domain=" + domain + ";";
                return domain;
            })();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=" + tld + ";SameSite=None;Secure";
        }

        content.xdm. _experience.analytics.customDimensions.eVars.eVarX = cmk;

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    var cookies = "; " + document.cookie;
    if (cookies) {
        var getCookie = cookies.split("; " + cn + "=");

        if (getCookie.length == 1) {
            init();
        } else {
            var cookieValue = getCookie[1].split(";")[0];
            init(cookieValue);
        }
    }
})();
//Fin de l'intégration CS Adobe Analytics

Tealium Tag Manager

/*
 *Nom: Intégration Adobe Analytics CS
 *Version: 1.11.0 (Tealium + csMatchingKey)
 */

(function () {
    var version = "1.11.0";

    function callback() {
        if (!disableCallback) {
            disableCallback = true;

            if (window.CS_CONF) {
                CS_CONF.integrations = CS_CONF.integrations || [];
                CS_CONF.integrations.push("Adobe Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

    window._uxa = window._uxa || [];
    _uxa.push(["afterPageView", callback]);

    var cmk = null;
    var cn = "_cs_mk_aa";

    function init(cookieValue) {
        if (cookieValue) {
            cmk = cookieValue;
        } else {
            cmk = Math.random() + "_" + Date.now();

            var now = new Date();
            var time = now.getTime();
            time += 30 * 60 * 1000;
            now.setTime(time);

            document.cookie = cn + "=" + cmk + "; expires=" + now.toUTCString() + ";path=/;domain=." + utag.cfg.domain + ";SameSite=None;Secure";
        }

        b.cs_matching_key = cmk;

        _uxa.push([
            "trackDynamicVariable",
            {
                key: "csMatchingKey",
                value: cmk,
            },
        ]);
    }

    if (!b["cp._cs_mk_aa"]) {
        init();
    } else {
        var getCookieValue = b["cp._cs_mk_aa"];
        init(getCookieValue);
    }
})();
//Intégration Adobe Analytics CS Fin

Vérification de son fonctionnement

Vous devriez voir la même valeur csMatchingKey envoyée à Contentsquare comme ceci

Configuration du Connecteur Adobe Analytics

Après avoir complété les étapes ci-dessus, vous devrez configurer votre Connecteur Adobe Analytics en utilisant cette documentation. 

 

Limitations

Cette intégration repose sur l'envoi d'un identifiant (le 'csMatchingKey') dans une eVar Adobe. Cet identifiant est ensuite utilisé pour faire correspondre nos sessions et les marquer comme appartenant aux segments Adobe des requêtes. 

Limitation Adobe: lorsque une variable atteint 500 000 valeurs uniques, les données sont regroupées sous "Trafic Faible", ce qui signifie que les identifiants tombant dans ce groupe ne peuvent pas être accédés pour faire correspondre les sessions Contentsquare. Ce mécanisme entraîne une forme d'échantillonnage aléatoire du côté d'Adobe au-delà des seuils de 500 000, et cet échantillonnage devient plus agressif après 1 000 000 de valeurs uniques. Cela peut créer des lacunes dans les données entre le nombre de sessions observées dans Adobe et Contentsquare pour un segment donné. 

Vous pouvez changer le seuil de limite en contactant Adobe, comme suggéré par Adobe dans leur documentation.