Traduit de l'anglais à l'aide de l'IA

Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez des doutes sur une information, veuillez vous référer à la version anglaise.

Cet article s'applique aux clients de nos plans Pro et Enterprise.

Catégorie : Analytique

Cette intégration est uniquement disponible pour les projets Web

À quoi s'attendre

Cette intégration vous permettra d'analyser des 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 (Journey Analysis, Page Comparator, Zoning Analysis, Session Replay).

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

Clé	Valeur	Type de Donnée
csMatchingKey	{csMatchingKey}	Texte

csMatchingKey

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

Mise en œuvre

Étapes de Mise en Œuvre

Créer un eVar

Veuillez configurer un eVar Contentsquare dédié 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, veuillez plutôt utiliser la 3ème option de la liste 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 DE CODE PERSONNALISÉ et appuyez sur le Ouvrir l'Éditeur bouton.

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 enregistrez-le puis publiez les modifications

Adobe Launch - Extension Adobe Experience Platform Web SDK

Dans Adobe Launch, accédez à l'Extension Adobe Experience Platform Web SDK 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 avant l'envoi de l'événement. 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 enregistrez-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 de Tealium Tag Manager

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

Allez dans votre conteneur 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éfini 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 la portée 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 cookies 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 Adobe Analytics CS
 *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 Adobe Analytics CS

Adobe Launch - Extension Web Adobe Experience Platform

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 Adobe Analytics CS
 *Version : 1.0.0 (Adobe Launch / Extension Web Adobe Experience Platform)
 */
(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 Adobe Analytics CS

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

Pour vérifier l'implémentation, ajoutez cette extension dans Chrome Adobe Experience Cloud Debugger.

Accédez à votre site web, activez l'extension Adobe Experience Cloud Debugger et ouvrez l'onglet Réseau dans la fenêtre contextuelle de l'extension. Vous devriez voir quelque chose de similaire à l'image ci-dessous. Sinon, l'implémentation a échoué.

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 d'Adobe: lorsque une variable atteint 500 000 valeurs uniques, les données sont regroupées sous "Low Traffic", ce qui signifie que les identifiants tombant dans ce groupe ne peuvent pas être utilisé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à du seuil 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 par rapport à Contentsquare pour un segment donné.

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

Articles dans cette section

Adobe Analytics - Code et Configuration