ⓘ Ceci est une intégration Bêta en accès anticipé.

Catégorie : Analytics

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 quel points du parcours utilisateurs avec vos segments de Piano Analytics. Contentsquare vous donne la possibilité d'utiliser vos segments de Piano Analytics dans n'importe lequel de ses modules (Parcours de navigation, Comparateur de pages, Données de zones, Session Replay).

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

Ce que nous collectons

Variables dynamiques

Key	Value	Type de données
cs_matching_key	{csMatchingKey}	Texte

csMatchingKey

correspond à la valeur unique utilisée pour recouper les segments Piano avec les sessions Contentsquare.

Implémentation

Étapes d'implémentation

ⓘ Pré-requis : Si vous avez une politique en matière de cookies qui exige que nos cookies soient d'abord acceptés avant d'être injectés, il vous appartient de veiller à ce que le code ci-dessous soit intégré dans la logique de votre politique de consentement en matière de cookies.

Il existe de nombreuses manières d'intégrer le code mais nous couvrirons seulement les options suivantes :

Implémentation de HTML / JavaScript personnalisé
Google Tag Manager - Modèle de Piano Analytics

Implémentation de HTML / JavaScript personnalisé

Ceci peut être utilisé pour toute implémentation de code personnalisé comme dans les tags HTML personnalisés dans le GTM ou tout autre gestionnaire de tags utilisant du HTML / JavaScript personnalisé. Il peut également aidé avec du code placé en ligne.

Vous devrez ajouter le code suivant à la configuration existante de Piano Analytics, avant la commande Piano Analytics pa.sendEvent("page.display", {}).

Par exemple :

Notez que si vous donnez à la propriété CS matching key un nom différent de celui qui est par défaut dans le code, à savoir cs_matching_key, vous devrez également le modifier dans le code dans cette section :

Implémenter du code pour les implémentations de HTML / JavaScript personnalisé :

Avant d'utiliser cette méthode, vous devrez d'abord déterminer quelle version du SDK de Piano Analytics vous utilisez :

Si vous utilisez la bibliothèque suivante pour Piano Analytics, alors vous utilisez la dernière version du SDK :

<script src="https://tag.aticdn.net/piano-analytics.js"></script>

Si vous utilisez la bibliothèque SmartTag, alors c'est l'ancienne version que vous utilisez.

<script src="https://tag.aticdn.net/[siteid]/smarttag.js"></script>

Le code qui suit est destiné à la dernière version du SDK :

/*
 *Name: Piano Analytics CS Integration
 *Version: 1.0.0
 */
(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("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

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

    var cmk = null;
    var cn = "_cs_mk_pa";

    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";
        }

        if (window.pa && typeof pa.setProperty === "function") {
            pa.setProperty("cs_matching_key", cmk, {
                persistent: true,
            });
        }

        _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);
        }
    }
})();
//Piano Analytics CS Integration End

Et le suivant est conçu pour l'ancienne version du SDK :

/*
 *Name: Piano Analytics CS Integration
 *Version: 1.0.0 (Legacy)
 */
(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("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

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

    var cmk = null;
    var cn = "_cs_mk_pa";

    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";
        }

        //Replace "tag" with the name of your AT Internet Track Tag
        tag.setProp("cs_matching_key", cmk, true);

        _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);
        }
    }
})();
//Piano Analytics CS Integration End

Google Tag Manager - Modèle de Piano Analytics

1. Dans le GTM, créez une "Variable définie par l'utilisateur" dans la section "Variables".

2. Cliquez sur "JavaScript personnalisé" pour ajouter une variable de page JavaScript personnalisée.

3. Donnez à la variable un nom en rapport avec l'intégration et copiez-collez le code ci-dessous dans l'éditeur de code JavaScript personnalisé.

/*
 *Name: Piano Analytics CS Integration
 *Version: 1.0.0 (csMatchingKey + GTM)
 */

function paCSintegration() {
    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("Piano Analytics - v" + version);
            }
        }
    }

    var disableCallback = false;

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

    var cmk = null;
    var cn = "_cs_mk_pa";

    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";
        }

        if (window.pa && typeof pa.setProperty === "function") {
            pa.setProperty("cs_matching_key", cmk, {
                persistent: true,
            });
        }

        _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);
        }
    }

    return cmk;
}
//Piano Analytics CS Integration End

Note : Si vous donnez à la propriété CS matching key un nom différent de celui qui est par défaut dans le code, à savoir cs_matching_key, vous devrez également le modifier dans le code de cette section :

4. Cliquez sur "Enregistrer" et vous obtiendrez quelque chose comme l'exemple ci-dessous dans vos variables définies par l'utilisateur :

5. Rendez-vous dans votre conteneur de tags Piano Analytics et choisissez l'option "Définir les propriétés" dans le menu des actions.
6. Insérez la key que vous avez définie, la valeur par défaut dans le code est cs_matching_key. Si vous modifiez le nom par défaut de cette key, vous devrez également le modifier dans le code et informer l'équipe CS du nom personnalisé.
7. Sélectionnez ensuite la valeur comme étant la nouvelle variable définie par l'utilisateur que vous avez créée.
8. Cochez la case "Persistant".

9. Enregistrez les changements et publiez le code.

Vérifier que ça fonctionne

1. Vous devriez voir la valeur cs_matching_key être envoyée à Contentsquare comme ceci :

2. Vous pouvez aussi voir la valeur dans la requête réseau envoyée à Piano Analytics :

Compléter votre implémentation

Pour compléter votre implémentation de Pianos Analytics, suivez les instructions de ce document.

Articles dans cette section

Piano Analytics - Code & Configuration