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.

ⓘ Il s'agit d'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 où dans le parcours client en utilisant vos segments Piano Analytics. Contentsquare vous permet d'utiliser vos Piano segments Analytics dans chaque fonctionnalité de Contentsquare (Journey Analysis, Page Comparator, Zoning Analysis, Session Replay).

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

Ce que nous collectons

Variables Dynamiques

Clé	Valeur	Type de Données
cs_matching_key	{csMatchingKey}	Texte

csMatchingKey

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

Mise en œuvre

Étapes de Mise en Œuvre

ⓘ Prérequis : Si vous avez une politique de cookies qui exige que nos cookies soient acceptés d'abord, 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.

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

Implémentation HTML / Javascript personnalisée
Google Tag Manager - Modèle Piano Analytics

Implémentation HTML / Javascript Personnalisée

Cela peut être utilisé pour toute implémentation de code personnalisé, comme dans les balises HTML personnalisées de GTM ou tout autre gestionnaire de balises utilisant HTML / Javascript personnalisé. Cela peut également être pour du code placé en ligne.

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

Par exemple :

Veuillez noter que si vous nommez la propriété de la clé de correspondance CS avec un nom différent de celui par défaut dans le code qui est cs_matching_key, vous devez également le changer dans le code dans cette section :

Comment implémenter le code pour des implémentations HTML / Javascript personnalisées :

Avant d'utiliser cette méthode, vous devrez d'abord déterminer quelle version du SDK Analytics de Piano 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 vous utilisez la version héritée.

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

Le code suivant est pour la dernière version du SDK :

/*
 *Nom: Intégration Piano Analytics CS
 *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;Sûr";
                }
                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;Sûr";
        }

        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);
        }
    }
})();
//Intégration Piano Analytics CS Fin

Le code suivant est pour la version SDK héritée :

/*
 *Nom : Intégration Piano Analytics CS
 *Version : 1.0.0 (Héritée)
 */
(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";
        }

        //Remplacez "tag" par le nom de votre tag de suivi AT Internet
        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);
        }
    }
})();
//Fin de l'intégration Piano Analytics CS

Google Tag Manager - Template Piano Analytics

1. Dans 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. Nommez la variable quelque chose en rapport avec l'intégration et collez le code ci-dessous dans l'éditeur de code JavaScript personnalisé.

/*
 *Nom: Intégration Piano Analytics CS
 *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;
}
//Intégration Piano Analytics CS Fin

Note : Si vous nommez la propriété de la clé de correspondance CS avec un nom différent de celui par défaut dans le code qui est cs_matching_key, alors vous devez également le changer dans le code dans cette section :

4. Cliquez sur 'Enregistrer' et vous verrez quelque chose comme l'exemple ci-dessous dans vos Variables Définies par l'Utilisateur :

5. Accédez à votre container de tag Piano Analytics et choisissez l'option 'Définir les Propriétés' dans le menu des actions.

6. Insérez la clé que vous avez définie, la valeur par défaut dans le code est cs_matching_key. Si vous changez ce nom de clé par rapport à la valeur par défaut, vous devez également le changer dans le code et vous devez informer l'équipe CS du nom personnalisé.

7. Ensuite, sélectionnez la Valeur pour être la nouvelle Variable Définie par l'Utilisateur que vous avez créée.

8. Autorisez la case à cocher pour 'Persistant'.

9. Enregistrez les modifications et publiez le code.

Vérifier que ça fonctionne

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

2. Vous pouvez également 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 Piano Analytics, suivez les instructions dans ce document.

résultats du centre d'aide

documentation technique

Articles dans cette section

Piano Analytics - Code et Configuration 🧪