Technical Docs Implémentation du tracking web Contentsquare

Implémentation du tracking web Contentsquare

Last updated on

Les instructions suivantes décrivent les étapes essentielles à suivre pour adapter l'implémentation de Contentsquare à vos besoins et commencer à utiliser notre solution.

📚 Pour plus d'information, consultez la documentation de référence du Tag

La balise principale

La balise principale de Contentsquare ou Tag principal est le "pixel" ou "extrait de code" principal qui doit être implémenté sur votre domaine afin de collecter des données d'analyse. Le Tag peut être implémenté via un TMS ou d'après un template. Vous trouverez les instructions pas à pas ci-dessous.

Avant de commencer l'implémentation, vous devez récupérer les informations suivantes :

  • Un Tag Id Contentsquare vous sera donné au début de votre partenariat avec Contentsquare. C'est un identifiant de 13 caractères qui ne peut être utilisé que sur les domaines autorisés -- aucune donnée ne peut être envoyée depuis un autre domaine.

  • Vous pouvez ajouter jusqu'à 20 variables personnalisées (ou Custom Vars) pour enrichir le contexte d'analyse avec des détails sur la page ou sur l'utilisateur. Elles récoltent généralement des informations issues de votre datalayer ou d'objets JavaScript déjà présents sur votre site.

Google Tag Manager (Template)

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur Rechercher dans la galerie.

  3. Recherchez contentsquare et sélectionnez le modèle Contentsquare - Main tag.

  4. Cliquez sur Ajouter à l’espace de travail.

  5. Confirmez le choix en cliquant sur Ajouter.

  6. Dans la section “Balises”, cliquez sur Nouvelle pour ajouter le tag.

  7. Configurez le tag en cliquant sur le bouton d’édition en haut à droite.

  8. Recherchez contentsquare et sélectionnez le template Contentsquare - Main tag précédemment ajouté.

  9. Attribuez un nom au tag and saisissez votre Tag ID dans le champ dédié. Si vous souhaitez configurer des Custom Variables, sélectionnez :

    • Le numéro d’emplacement (indice) de la variable, de 1 à 20;
    • Le nom de la variable;
    • La valeur de cette variable, qui peut être récupérée depuis l’une des variables GTM existantes;

    Sélectionnez ensuite le déclencheur correspondant à vos besoins.

  10. (Optionnel) Masquez les données personnelles dans l'interface GTM.

    Sélectionnez la méthode masquage des données personnelles selon le type d'information :

    • Define CSS Selectors pour les nœuds textuels.
    • CSS Selectors and Data Attributes pour les attributs.

  11. Sauvegardez les modifications et retourner dans l’espace de travail. Vous devriez à présent retrouver le modèle ainsi que la balise.

Google Tag Manager (Custom HTML)

  1. Ajoutez une nouvelle balise sur votre espace de travail.

  2. Cliquez sur "Choisissez un type de tag pour commencer la configuration...".

  3. Dans la liste, choisissez la balise "Custom HTML".

  4. Selon la disponibilité de votre data layer, utilisez les exemples suivants pour :

    • Implémenter le tag et pousser des variables du data layer vers Contentsquare :

      <script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    try {
        window._uxa.push(['setCustomVariable', 1, 'Sample Variable', {{your-GTM-variable-here}}, 3]);
    } catch(e){}
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>

    • Implémenter le tag sans pousser de variables du data layer vers Contentsquare :

      <script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>

  5. Cliquez sur "Choisissez un déclencheur pour cette balise...".

  6. Dans la liste, choisissez le déclencheur "All Pages" qui devra attendre que le dataLayer ait été alimenté avant de déclencher le tag.

  7. Attribuez un nom au Tag (par exemple "Contentsquare Main Tag"), puis cliquez sur "Enregistrer".

Tealium

  1. Ajoutez un nouveau tag à vos conteneurs en choisissant "Content Square UX Analytics"

  2. Ajoutez le "TAG ID" et cliquez deux fois sur "Suivant", en conservant la configuration par défaut.

    Si vous n'avez pas de variables personnalisées, cliquez sur "Terminer".

  3. (Optionnel) Ajoutez les variables personnalisées :

    • Choisissez une variable du datalayer dans la liste et cliquez sur Sélectionner la destination.
    • Cliquez sur Personnaliser.
    • Ajoutez un nom de variable.
    • Cliquez sur Ajouter.
    • Cliquez sur Fermer.

  4. Cliquez sur "Terminer" ou répétez l’ÉTAPE 3 pour ajouter des variables.

Adobe Launch

Installation de l'extension Contentsquare

  1. Recherche Contentsquare dans Extensions puis cliquez sur Installer.

  2. Saisissez votre Tag ID, fourni par l'équipe d'implémenetation Contentsquare.

    Pour envoyer des variables personnalisées, cliquez sur Ajouter une nouvelle variable et remplissez les champs de saisie correspondants. Utilisez Data Elements dans les champs de valeur, car ils constituent la méthode intégrée d'envoi des informations entre les extensions. Vous pouvez également supprimer des variables personnalisées en sélectionnant l’icône "Moins".

  3. (Optionnel) Sélectionnez Masquez les données personnelles.

  4. (Optionnel) Sélectionnez la méthode de masquage des données personnelles selon le type d'information :

    • Masquez les données personnelles textuelles via des sélecteurs CSS : Assurez-vous que les sélecteurs CSS sont valides.

    • S'il s'agit de données personnelles non-textuelles, utilisez le champ ci-dessous et le template :

  5. Enregistrez vos modifications et passez à l'étape suivante.

Déclenchement de la balise principale

Depuis l'onglet Règles, sélectionnez Ajouter une règle.

Configuration d'événement

En fonction de vos besoins, sélectionnez l'événement à utiliser à partir de l'extension principale.

Implémentation par défaut - bas de page et DOM ready

Voici quelques exemples :

Configuration de l'action

  1. Sélectionnez Installation du Tag principal dans l'extension Contentsquare.

  2. Si vous n'avez pas besoin de modifier davantage le chemin ou les requêtes envoyées, cliquez sur "Conserver les modifications".

  3. Si vous devez remplacer le chemin et / ou la requête, sélectionnez l'élément et écrivez le chemin à utiliser comme substitut. Vous pouvez également créer des Data Elements et les utiliser dans ces champs.

    Une fois que vous avez terminé, votre nouvelle règle devrait ressembler à la suivante :

  4. Enregistrez et passez à la règle suivante.

Commanders Act

  1. Ajoutez une nouvelle balise à vos contenursen sélectionnant Contentsquare (Builder).

  2. Définissez le template Contentsquare adéquat en sélectionnant Main.

  3. Saisissez votre Tag ID.

  4. (Optionnel) Pour ajouter des variablers personnalisées, sélectionnez Yes sous "Add customs variables" et renseignez les paramtères :

    • name
    • scope: 2 pour visit, 3 pour page, 4 pour nextPageOnly.
    • value, qui peut être une de vos variables Commanders Act.

  5. Saisissez un nom pour votre Tag - par exemple Contentquare Main Tag, and cliquez sur Save.

Votre tag est prêt à être déployé.

Shopify

Configuration standard

  1. Dans le menu principal, cliquez sur Online Store > Themes, puis cliquez sur le menu déroulant Actions et sélectionnez Edit Code.

  2. Sous Layout, sélectionnez le fichier theme.liquid.

  3. Dans l'éditeur de code, naviguez jusqu'au tag </head> fermant.

  4. Copiez cet extrait de code en remplaçant YOUR_TAG_ID par votre ID Contentsquare :

    <!-- Contentsquare Tags Start -->
<script type="text/javascript">
//Contentsquare Main Tracking Tag
(function() {
    window._uxa = window._uxa || [];
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname + window.location.hash.replace('#', '?__')]);
        var mt = document.createElement("script");
        mt.type = "text/javascript";
        mt.async = true;
        mt.src = "//t.contentsquare.net/uxa/YOUR_TAG_ID.js";
        document.getElementsByTagName("head")[0].appendChild(mt);
    } else {
        window._uxa.push(['trackPageview', window.location.pathname + window.location.hash.replace('#', '?__')]);
    }
})();
</script>
<!-- Contentsquare Tags End -->

  5. Copiez le code avant le tag </head> fermant.

  6. Cliquez sur Save.

Trackez le Checkout flow avec Contentsquare

Si vous n'avez pas de compte Shopify Plus account et souhaitez tracker les commandes traitées, ajoutez le code à la page de remerciement ("thank you page") une fois la transaction terminée. Cela vous permet de capturer les données ecommerce en suivant ces étapes :

  1. Cliquez sur Settings.

  2. Depuis la fenêtre modale, sélectionnez Checkout and accounts.

  3. Scrollez jusqu'à la section Order status page.

  4. Dans le champ Additional scripts, insérez le même code que vous avez ajouté au fichier theme.liquid :

  5. Cliquez sur Save.

Envoyer des custom vars

Pour envoyer des custom vars vers Contentsquare, définissez-les avant le Tag principal.

Modifiez les clés et valeurs selon vos besoins : vous pouvez utiliser des Liquid Objects ou des Liquid Tags dans les valeurs.

<script type="text/javascript">
    //Contentsquare Send Custom Variables
    window._uxa = window._uxa || [];
    window._uxa.push(['setCustomVariable', 1, "Insert Custom Key 1", "Insert Custom Value: " + {{ custom_tag.value1 }}]);
    window._uxa.push(['setCustomVariable', 2, "Insert Custom Key 2", "Insert Custom Value: " + {{ custom_tag.value2 }}]);
    window._uxa.push(['setCustomVariable', 3, "Insert Custom Key 1", "Insert Custom Value: " + {{ custom_tag.value3 }}]);
 
    //Contentsquare Main Tracking Tag
    (function () {
        window._uxa = window._uxa || [];
        if (typeof CS_CONF === 'undefined') {
            window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
            var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
            mt.src = '//t.contentsquare.net/uxa/769238b6e1309.js';
            document.getElementsByTagName('head')[0].appendChild(mt);
        }
        else {
            window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
        }
})();
</script>

Pour plus d'informations, reportez-vous à la documentation de la commande setCustomVariable.

Envoyer des dynamic vars

Vous pouvez envoyer des dynamic vars à n'importe quel étape du pageview, il n'est pas nécessaire de les définir avant le tag Contentsquare.

Modifiez les clés et valeurs selon vos besoins : vous pouvez utiliser des Liquid Objects ou des Liquid Tags dans les valeurs.

<script type="text/javascript">
    // Contentsquare Send Artificial Pageviews
    document.getElementById("AddToCart").addEventListener('click', function() {
        window._uxa = window._uxa || [];
        window._uxa.push(["setPath", "Added_to_cart_" + {{ custom_tag.value }}]);
        window._uxa.push(["trackPageview"]);
 
        window._uxa = window._uxa || [];
        window._uxa.push(["trackDynamicVariable", {key: "Added to cart", value: {{ custom_tag.value }}}]);
    });
</script>

Pour plus d'informations, reportez-vous à la documentation de la commande trackDynamicVariable.

HTML personnalisé

Afin de collecter des variables personnalisées à partir de votre datalayer, consultez l'exemple de code suivant :

<script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    try {
        if (typeof dataLayer !== 'undefined') {
            for (var i = 0; i < dataLayer.length; i++) {
               window._uxa.push(['setCustomVariable', 1, 'Sample Variable', dataLayer[i].sampleVariable, 3]);
            }
        }
    } catch(e){}
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>

Si vous n’avez pas de datalayer ou n’avez pas besoin d’envoyer des variables personnalisées, consultez l’exemple suivant :

<script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>

Le tag doit être chargé le plus tôt possible, après que les variables ont été renseignées.

Reportez-vous à la documentation de référence du Tag, pour plus d'informations.

Les pages vues artificielles

Les pages artificielles doivent être déclenchées lorsque :

  • Une action modifie complètement le contenu affiché sur la page sans l'actualiser ni en modifier l'URL (demandes Ajax).
  • L'utilisateur est redirigé vers une autre étape d'un tunnel sans actualiser la page.
  • Votre site réachemine toutes les modifications d'URL sans actualiser la page.
  • Votre site est construit avec une application de page unique (SPA) et tous les cadres associés (par exemple, React, Angular).
  • Votre site est conçu en tant qu'application web progressive (PWA).
  • Les fenêtres modales (popin) / (popup) sont affichées.

Accédez à la documentation sur le déclenchement des pages vues artificielles.

URLs stables - Suivi des fenêtres modales et des pages vues artificielles

Selon la procédure de suivi des fenêtres modales ou des événements qui ne changent pas la structure de l’URL, vous devez utiliser la fonctionnalité Contentsquare Trackpageview en suivant ces méthodes et en les liant à la bonne action (clic sur le bouton ou déclencheur d'événement).

URLs dynamiques - Single Page Application (SPA) et changement d'historique

Au cas où l'URL serait modifiée sans recharger la fenêtre, vous pouvez traquer ces changements en déclenchant une nouvelle fois le Tag principal: le Tag détectera automatiquement qu'il a déjà été mis en place sur le site et déclenchera un nouveau pageview à la place.

Google Tag Manager (Template)

[tab] URLs stables

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur Rechercher dans la galerie.

  3. Saisissez contentsquare et sélectionnez l'option Contentsquare - Artificial Pageview

  4. Cliquez sur Add to workspace

  5. Cliquez sur Add pour confirmer

  6. Naviguez dans la section Tags et sélectionnez New pour créer un nouveau Tag.

  7. Sélectionnez le bouton en haut à droite pour accéder à la configuration

  8. Saisissez contentsquare et sélectionnez l'option Contentsquare - Artificial Pageview

  9. Sélectionnez le tag et configurez-le :

    • Sélectionnez l'option Free text option et saisissez la valeur sous Artificial Pageview value.
    • Si votre site web comporte des pop-ups et que vous devez déployez les pageviews artificielles, sélectionnez Use for the opening of a popup dans la liste déroulante.

[tab] URLs dynamiques

  1. Modifier la configuration de la balise principale en ajoutant un nouveau déclencheur.

  2. Créer un nouveau déclencheur.

  3. Cliquez sur "Choisissez un type de déclencheur pour commencer la configuration...".

  4. Dans la liste, sélectionnez le déclencheur "History Change".

  5. Enregistrez votre déclencheur.

  6. Cliquez sur le bouton "Enregistrer" en haut à droite.

Google Tag Manager (Custom HTML)

[tab] URLs stables

  1. Cliquez sur "Choisissez un type de tag pour commencer la configuration ...".

  2. Dans la liste, choisissez la balise "Custom HTML".

  3. Écrivez l'extrait à envoyer dans le champ HTML. Cela devrait ressembler à ceci :

    <script type="text/javascript">
    window._uxa.push(['setQuery', location.search + (location.search ? '&' : '?') + 'cs-popin-dedicated_query_string']);
    window._uxa.push(['trackPageview', window.location.pathname + window.location.hash.replace('#', '?__')]);
    window._uxa.push(['setQuery', location.search]);
</script>

  4. Cliquez sur "Choisissez un déclencheur pour que cette balise se déclenche ...".

  5. Créer un nouveau déclencheur pour que cette balise se déclenche.

  6. Cliquez sur "Choisissez un type de déclencheur pour commencer la configuration ...".

  7. Dans la liste, sélectionnez le déclencheur "Tous les éléments".

  8. Cochez "Quelques clics"

  9. Sélectionnez "Elément de clic", "correspond au sélecteur CSS" et entrez un filtre valide CSS correspondant à l'élément que vous souhaitez suivre.

    Par exemple le CSS valide pour :

    <button class="btn btn primary"> Submit </button>

    sera :

    .btn.btn.primary

[tab] URLs dynamiques

  1. Modifier la configuration de la balise principale en ajoutant un nouveau déclencheur.

  2. Créer un nouveau déclencheur.

  3. Cliquez sur "Choisissez un type de déclencheur pour commencer la configuration...".

  4. Dans la liste, sélectionnez le déclencheur "History Change".

  5. Enregistrez votre déclencheur.

  6. Cliquez sur le bouton "Enregistrer" en haut à droite.

Tealium

[tab] URLs stables

Attribuez l'événement que vous avez peut-être déjà mis place à un extrait de code HTML personnalisé et définissez-le comme déclencheur. Cela devrait ressembler à ceci :

<script type="text/javascript">
    window._uxa.push(['setQuery', location.search + (location.search ? '&' : '?') + 'cs-popin-dedicated_query_string']);
    window._uxa.push(['trackPageview', window.location.pathname + window.location.hash.replace('#', '?__')]);
    window._uxa.push(['setQuery', location.search]);
</script>

[tab] URLs dynamiques

Attribuez l'événement que vous avez peut-être déjà mis en place à l'extension Contentsquare, afin qu'elle soit déclenchée à nouveau à chaque changement d'historique ou réacheminement de la vue.

Adobe Launch

[tab] URLs stables

Pages vues artificielles

Lors de la configuration de la règle, assurez-vous de cibler l'événement ou la condition nécessaire. Par exemple, pour une action d'ajout au panier, vous pouvez suivre l'itinéraire par clic :

Ou l'itinéraire d'événement personnalisé :

Une fois que vous avez choisi l'événement souhaité, vous pouvez sélectionner l'action de suivi de vue de page artificielle à partir de l'extension Contentsquare.

En fonction de la page consultée, vous pouvez:

  • Spécifier la requête à transmettre aux serveurs Contentsquare.

  • Capturer automatiquement l’URL courante, en laissant le champ de saisie vide.

[tab] URLs dynamiques

Dans le cas d'une implémentation de SPA, si votre chemin d'url est automatiquement modifié à chaque réacheminement, il vous suffira d'utiliser l'événement de changement d'historique intégré afin de déclencher notre balise sur chacune de ces occurrences.

Commanders Act

  1. Pour ajouter un nouvel événement, allez à l'étape “MODIFIER” et cliquez sur “AJOUTER UN ÉVÉNEMENT” (1) :

    Une fenêtre de configuration apparaîtra, avec plusieurs champs :

    • (1) “Nom“ : Nom de l'événement que vous souhaitez ajouter
    • (2) “Id“ : l’identifiant de l’événement (à compléter uniquement si vous le connaissez et souhaitez déclencher l’événement en fonction de son identifiant; sinon, laissez le champ vide et il sera généré automatiquement par Commanders Act)
    • (3) Code JavaScript : zone dans laquelle le code JavaScript de l’événement est saisi.
    • (4) «Utiliser le nettoyeur de balises» : fonctionnalité permettant de «corriger» l’événement (le réécrit afin d’éviter les erreurs JavaScript et le rendre compatible avec le code du conteneur).

  2. Cliquez sur «Ajouter» pour ajouter votre événement au conteneur.

  3. Aller à la bibliothèque de balises. Une fois là :

    1. Écrivez «Event Injection» dans le moteur de recherche.
    2. Sélectionnez le tag.
    3. Ajoutez le tag.

En cas de suivi des pages vues artificielles avec Contentsquare, le code à déployer doit suivre ces instructions :

window._uxa = window._uxa || [];
window._uxa.push(['trackPageview', <PATH_A_ENVOYER> ]);

(4) allez sur votre site web; Placez le curseur sur l'élément sur lequel vous souhaitez placer un événement et faites un clic droit. Dans le menu qui s’ouvre, sélectionnez «Inspecter l’élément». (5) Dans la console, une fois l'élément mis en surbrillance, cliquez à nouveau avec le bouton droit de la souris. (6) Choisissez «copier» dans le menu. (7) «Sélecteur de copie».

(8) Si vous connaissez l’ID de l’élément (en commençant par un #, copiez-le et collez-le dans le champ #CSS_PATH#).

(9) Si vous ne connaissez pas ou ne trouvez pas l’ID, copiez et collez les informations sur l’élément en commençant par “#” et remplacez “>“ (espace> espace) par un seul espace dans la ligne de code.

(10) Copiez et collez la ligne dans le champ #CSS_PATH# de l’interface.

Entrez maintenant l'ID de l'événement que vous souhaitez appeler dans le champ correspondant.

Passez à l'étape de déploiement comme vous le faites avec d'autres balises.

Shopify

  1. Dans le menu principal, cliquez sur Online Store > Themes, puis cliquez sur le menu déroulant Actions et sélectionnez Edit Code.

  2. Ouvrez le fichier Liquid ou vous souhaitez déclencher une pageview artificiel, d'après votre logique JavaScript. Vous pouvez déclencher le pageview artificiel depuis theme.liquid ou un autre fichier Liquid.

    Si vous souhaitez déclencher un pageview artificiel conditionnellement, par exemple seulement quand un article est ajouté au panier, vous devez entourer ce code dans votre propre condition, fonction callback, ou event listener.

  3. Dans l'extrait ci-dessous, remplacez *path_to_send* par votre chemin unique.

    window._uxa = window._uxa || [];
window._uxa.push(['trackPageview', *path_to_send* ]);

    Vous pouvez hardcoder une valeur statique pour le path comme par exemple Added_to_cart ou utiliser les Liquid Objects/Liquid Tags Shopify, pour récupérer les données dynamiquement, comme ci-dessous :

    <script type="text/javascript">
// Contentsquare Send Artificial Pageviews
document.getElementById("AddToCart").addEventListener('click', function() {
    window._uxa = window._uxa || [];
    window._uxa.push(["trackPageview", "Added_to_cart_" + {{ custom_tag.value}}])
});
</script>

  4. Insérer ce code après le block du Tag principal.

    Voici un aperçu du résultat final dans le fichier Liquid :

    <!-- Contentsquare Tags Start -->
<script type="text/javascript">
// Contentsquare Main Tracking Tag
(function() {
    window._uxa = window._uxa || [];
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement("script");
        mt.type = "text/javascript";
        mt.async = true;
        mt.src = "//t.contentsquare.net/uxa/769238b6e1309.js";
        document.getElementsByTagName("head")[0].appendChild(mt);
    } else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
});
</script>
 
<script type="text/javascript">
// Contentsquare Send Artificial Pageviews
document.getElementById("AddToCart").addEventListener('click', function() {
    window._uxa = window._uxa || [];
    window._uxa.push(["trackPageview", "Added_to_cart_" + {{ custom_tag.value}}])
});
</script>

  5. Pour modifier le chemin complet envoyé, utilisez la commande setPath :

    <script type="text/javascript">
    // Contentsquare Send Artificial Pageviews
    document.getElementById("AddToCart").addEventListener('click', function() {
        window._uxa = window._uxa || [];
        window._uxa.push(["setPath", "Added_to_cart_" + {{ custom_tag.value }}]);
        window._uxa.push(["trackPageview"]);
    });
</script>

    Pour plus d'informations, reportez-vous à la documentation de la commande setPath.

  6. Pour modifier seulement la query string, utilisez la commande setQuery :

    <script type="text/javascript">
    // Contentsquare Send Artificial Pageviews
    document.getElementById("AddToCart").addEventListener('click', function() {
        window._uxa = window._uxa || [];
        window._uxa.push(["setQuery", "Added_to_cart_" + {{ custom_tag.value }}]);
        window._uxa.push(["trackPageview"]);
    });
</script>

    Pour plus d'informations, reportez-vous à la documentation de la commande setQuery.

HTML personnalisé

[tab] URLs stables

Par exemple, si vous souhaitez garder la trace de la fenêtre contextuelle apparaissant lors de l'ajout d'un article au panier :

<script type="text/javascript">
    window._uxa.push(['setQuery', location.search + (location.search ? '&' : '?') + 'cs-popin-dedicated_query_string']);
    window._uxa.push(['trackPageview', window.location.pathname + window.location.hash.replace('#', '?__')]);
    window._uxa.push(['setQuery', location.search]);
</script>

[tab] URLs dynamiques

Avec des variables personnalisées
<script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    try {
        if (typeof dataLayer !== 'undefined') {
            for (var i = 0; i < dataLayer.length; i++) {
               window._uxa.push(['setCustomVariable', 1, 'Sample Variable', dataLayer[i].sampleVariable, 3]);
            }
        }
    } catch(e){}
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>
Sans variables personnalisées
<script type="text/javascript">
(function () {
    window._uxa = window._uxa || [];
    if (typeof CS_CONF === 'undefined') {
        window._uxa.push(['setPath', window.location.pathname+window.location.hash.replace('#','?__')]);
        var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true;
        mt.src = '//t.contentsquare.net/uxa/{{YOUR_TAG_ID}}.js';
        document.getElementsByTagName('head')[0].appendChild(mt);
    }
    else {
        window._uxa.push(['trackPageview', window.location.pathname+window.location.hash.replace('#','?__')]);
    }
})();
</script>

Le tag Dynamic variables

Les dynamic vars sont des informations additionnelles sur la session qui peuvent être utilisées pour segmenter les utilisateurs.

Elles peuvent, par exemple, contenir des informations sur la variation d'A/B Test affichée à l'utilisateur.

Contrairement aux custom vars, les dynamic vars peuvent être envoyées à n'importe quel moment au cours de la session et ne nécessitent pas l'envoi d'une pageview.

Pour plus d'information, voir Dynamic vars.

Google Tag Manager (Template)

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur Rechercher dans la galerie.

  3. Recherchez Contentsquare et sélectionnez le modèle Contentsquare - Dynamic variables.

  4. Cliquez sur Ajouter à l’espace de travail.

  5. Confirmez le choix en cliquant sur Ajouter.

  6. Dans la section “Balises”, cliquez sur Nouvelle pour ajouter le tag.

  7. Configurez le tag en cliquant sur le bouton d’édition en haut à droite.

  8. Recherchez contentsquare et sélectionnez l'option Contentsquare - Dynamic variables.

  9. Attribuez un nom au tag and saisissez votre Tag ID dans le champ dédié.
    Pour chaque variable dynamique, saisissez :

    • La clé
    • La valeur
    • Le type- Number ou String.

    Sélectionnez ensuite le déclencheur correspondant à vos besoins.

  10. Sauvegardez les modifications et retourner dans l’espace de travail. Vous devriez à présent retrouver le modèle ainsi que la balise.

Adobe Launch

  1. Dans les propriétés de la balise, sélectionnez Règles > Ajouter une règle.

  2. Spécifiez un nom, des événements et des conditions.

  3. Ajoutez une action avec les paramètres suivants :

    • Extension : Contentsquare,
    • Type d'action : Dynamic Variables,
    • Nom : Contentsquare - Dynamic Variable tracking.

  4. Dans la zone à droite de la page, sélectionnez Ajouter une variable.

  5. Pour chaque variable dynamique, spécifiez :

    • La clé
    • La valeur
    • Le type - Number ou String.

  6. Sélectionnez Conservez les modifications > Sauvegarder.

Le tag ETR Event

Le tag ETR Event permet de déclencher des événements ETR pour sauvegarder la session d'un visiteur.

Pour plus d'information, voir Gestion des événements.

Google Tag Manager (Template)

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur Rechercher dans la galerie.

  3. Recherchez contentsquare et sélectionnez le modèle Contentsquare - ETR Event.

  4. Cliquez sur Ajouter à l’espace de travail.

  5. Confirmez le choix en cliquant sur Ajouter.

  6. Dans la section “Balises”, cliquez sur Nouvelle pour ajouter le tag.

  7. Configurez le tag en cliquant sur le bouton d’édition en haut à droite.

  8. Recherchez contentsquare et sélectionnez le template Contentsquare - ETR Event ajouté précédemment.

  9. Attribuez un nom au tag and saisissez votre Tag ID dans le champ dédié.

  10. Saisissez le nom de l'événement.

  11. Sélectionnez le type d'événements: Page Level ou Session Level.

    Sélectionnez le déclencheur qui correpond à votre besoin.

  12. Sauvegardez vos changements et retournez sur votre conteneur. Le template et le nouveau tag s'affichent.

Adobe Launch

  1. Dans les propriétés de la balise, sélectionnez Règles > Ajouter une règle.

  2. Spécifiez un nom, des événements et des conditions.

  3. Ajoutez une action avec les paramètres suivants :

    • Extension : Contentsquare,
    • Type d'action : ETR Event,
    • Nom : Contentsquare - ETR Event

  4. Dans la zone à droite de la page, saisissez le nom de l'événement.

  5. Sélectionnez les type de l'événement : Page Level ou Sesson Level.

  6. Sélectionnez Conservez les modifications > Sauvegarder.

Le Tag Événements de page

Ce tag permet d'envoyer des événements de page à Contentsquare.

Les événements de page sont des informations complémentaires de session qui peuvent être utilisées pour établir des segments. Comme les variables dynamiques, vous pouvez les envoyer n'importe quand dans une session.

Pour plus d'information, voir Gestion des événements.

Google Tag Manager (Template)

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur Rechercher dans la galerie.

  3. Recherchez contentsquare et sélectionnez le modèle Contentsquare - Page Events.

  4. Cliquez sur Ajouter à l’espace de travail.

  5. Confirmez le choix en cliquant sur Ajouter.

  6. Dans la section “Balises”, cliquez sur Nouvelle pour ajouter le tag.

  7. Configurez le tag en cliquant sur le bouton d’édition en haut à droite.

  8. Recherchez contentsquare et sélectionnez le template Contentsquare - Page Event ajouté précédemment.

  9. Attribuez un nom au tag and saisissez votre Tag ID dans le champ dédié.

  10. Saisissez le nom de l'événement.

  11. (Optional) If needed, add additional page events.

    Select the trigger that best suits your needs.

  12. Save your changes and go back to your container. You should now see both the template and the newly created tag.

Adobe Launch

  1. Dans les propriétés de la balise, sélectionnez Règles > Ajouter une règle.

  2. Spécifiez un nom, des événements et des conditions.

  3. Ajoutez une action avec les paramètres suivants :

    • Extension : Contentsquare,
    • Type d'action : Page Events,
    • Nom : Contentsquare - Page Event

  4. Dans la zone à droite de la page, saisissez le nom de l'événement.

  5. Sélectionnez Conservez les modifications > Sauvegarder.

Le Tag E-commerce

Le tag e-commerce permet de suivre les transactions sur votre site et collecter des statistiques relatives aux revenus générés.

Déclenchez le tag uniquement sur la page de confirmation, lorsque la transaction est finalisée, et renseignez les paramètres obligatoires suivants :

  • ID (identifiant unique pour chaque transaction)
  • Revenue (montant total de la transaction)

Vous pouvez également inclure les paramètres facultatifs suivants :

  • Currency (devise utilisée pour la transaction et dans notre plateforme, où elle peut être convertie)

La documentation technique complète sur le déclenchement du tag e-commerce est disponible ici.

Google Tag Manager (Template)

  1. Ouvrez l’espace de travail et accédez à la section Modèles.

  2. Cliquez sur “Rechercher dans la galerie”.

  3. Recherchez “Contentsquare” et sélectionnez le modèle “E-commerce data”.

  4. Cliquez sur « Ajouter à l’espace de travail ».

  5. Confirmez le choix en cliquant sur « Ajouter ».

  6. Dans la section “Balises”, cliquez sur « Nouvelle » pour ajouter le tag.

  7. Configurez le tag en cliquant sur le bouton d’édition en haut à droite.

  8. Recherchez “Contentsquare” et sélectionnez la balise « E-commerce » précédemment ajoutée.

  9. Nommez la balise et ajoutez les variables GTM au champ de transaction et de montant. Attention à choisir un mode de déclenchement uniquement sur la page de confirmation d’achat, ou bien sur l’ensemble des pages pour lesquelles une donnée de transaction doit être collectée.

    La valeur de devise peut également être transmise dans les paramètres optionnels.

  10. Sauvegardez les modifications et retourner dans l’espace de travail. Vous devriez à présent retrouver le modèle ainsi que la balise.

Google Tag Manager (Custom HTML)

  1. Créez une nouvelle balise et collez le code suivant dans le champ HTML :

    <script type="text/javascript">
    window._uxa = window._uxa || [];
    window._uxa.push(['ec:transaction:create', {
        'id': '{{YOUR ID HERE}}',
        'revenue': '{{YOUR REVENUE HERE}}',
        'currency':'{{CURRENCY ISO CODE HERE}}'
    }]);
    window._uxa.push(['ec:transaction:send']);
</script>

  2. Dans le script, remplacez toutes les variables d'espace réservé par vos valeurs GTM (en utilisant la notation à double accolade : {{transaction id}}, {{transaction revenue}}).

    Ces variables doivent être disponibles dans la section "Variables" de Google Tag Manager.

  3. Dans la liste des déclencheurs, sélectionnez la "page de confirmation" ou créez-la si elle n’existe pas:

    1. Cliquez sur le "+" en haut à droite,
    2. Cliquez sur "Choisissez un type de déclencheur pour commencer la configuration ..."
    3. Choisissez "Fenêtre chargée"
    4. Vous ne voulez pas que cela se déclenche sur toutes les pages, alors choisissez "Certains événements chargés par la fenêtre"
    5. Ajoutez une condition pour correspondre uniquement à la page de confirmation — par exemple, URL de la page "contient" checkout / confirmation
    6. Enregistrez et nommez votre déclencheur "page de confirmation"

Tealium

L'extension Tealium déclenchera automatiquement le code de transaction Contentsquare dès que les valeurs de transaction définies auront été renseignées dans votre datalayer utag.

Adobe Launch

Rendez-vous sur l'onglet des règles et créez-en un nouveau.

Configuration d'événement

La balise e-commerce ** doit être activée uniquement sur la page de confirmation ** et chaque fois qu'une transaction doit être suivie. Pour ce faire, vous devez spécifier le chemin ou l'événement à utiliser comme déclencheur. Par exemple, si vous souhaitez cibler la page de confirmation, vous pouvez utiliser une condition similaire :

Si vous avez choisi l'itinéraire + condition, votre configuration devrait ressembler à ceci :

Configuration de l'action

Sélectionnez l'action d'installation de balises e-commerce à partir de l'extension Contentsquare.

Vous serez ensuite invité à renseigner les informations requises à l'aide de chaînes ou de Data Elements.

Compte tenu de la nature dynamique des détails de la transaction, il est nécessaire d’avoir préalablement configuré Data Elements avec les informations demandées.

Commanders Act

  1. Ajoutez un nouveeau tag à votre conteneur en sélectionnant Contentsquare (Builder).

  2. Définissez le template Contentsquare en sélectionnant Ecommerce.

  3. Saisissez tous les champs pour vos variables Commanders Act.

  4. (Optionnel) Si vos transactions sont effectuées dans des devises différentes, envoyez à Contentsquare la valeur pour la devise.

  5. (Optionnel) Si vous être client CS Merchandising, ajoutez des items.

  6. Sélectionnez un délencheur ou périmètre uniquement pour la page de confimration on the confirmation page, et cliquez sur Save.

Votre Tag est prêt à être déployé.

Shopify

  1. Cliquez sur Settings.

  2. Depuis la fenêtre modale, sélectionnez Checkout and accounts.

  3. Scrollez jusqu'à la section Order status page.

  4. Dans le champ Additional scripts, insérez le même code que vous avez ajouté au fichier theme.liquid :

    Voici un exemple du code avec des Liquid Objects pre-définis. Éditez ces valeurs selon vos besoins :

    window._uxa = window._uxa || [];
window._uxa.push(['ec:transaction:create', {
    'id': '{{checkout.order_id}}',
    'revenue': {{checkout.subtotal_price}}, 
    'currency':'{{currency.iso_code}}'
}]);
window._uxa.push(['ec:transaction:send']);

    Il est possible que le code du tracking tag Contentsquare et d'autre code soit présent dans le champ ci-dessus : ajoutez ce nouveau code à la section Contentsquare.

  5. Cliquez sur Save.

HTML personnalisé

Tout d'abord, affectez une variable aux champs obligatoires :

<script type="text/javascript">
    window._uxa = window._uxa || [];
    window._uxa.push(['ec:transaction:create', {
        'id': '{{YOUR ID HERE}}',
        'revenue': '{{YOUR REVENUE HERE}}',
    }]);
</script>

Exécutez ensuite la fonction suivante pour envoyer les informations ci-dessus à Contentsquare :

<script type="text/javascript">
    window._uxa.push(['ec:transaction:send']);
</script>

Vous pouvez également tout rassembler dans un seul extrait :

<script type="text/javascript">
    window._uxa = window._uxa || [];
    window._uxa.push(['ec:transaction:create', {
        'id': '{{YOUR ID HERE}}',
        'revenue': '{{YOUR REVENUE HERE}}',
    }]);
    window._uxa.push(['ec:transaction:send']);
</script>

Test de votre implémentation

Assurez-vous que les données sont correctement envoyées à notre serveur en procédant comme suit :

  1. Téléchargez notre extension Chrome Contentsquare Tracking Setup Assistant.

  2. Parcourez votre site web et, en regardant l'extension, assurez-vous que :

    • Un pageview est envoyée à chaque visite ou étape parcourue par l'utilisateur.
    • Les variables personnalisées sont envoyées.
    • une transaction est envoyée avec les paramètres obligatoires, le cas échéant.

Sinon, consultez notre Section de dépannage.

Pour finir

Les données sont collectées

Une fois que toutes les balises ci-dessus ont été implémentées, le site transmet intégralement les données nécessaires à l'analyse.

Les données collectées dans Contentsquare sont visibles 3 heures après leur réception.

Aller plus loin

Pour enrichir vos analyses, consultez notre documentation technique ici.

Contactez votre Implémentation Manager et votre Customer Success Manager pour toute demande d’implémentation avancée (suivi des événements personnalisés, masquage des données personnelles pour le Session Replay…)

Connexion avec des outils tiers

Vous pouvez facilement connecter la solution Contentsquare à des outils d'analyse tiers et à des plateformes d'AB test.

  • ABTasty
  • Adobe Analytics
  • Adobe Test and Target
  • Google Analytics 360
  • Google Optimize
  • Dynamic Yield
  • Kameleoon
  • Maxymiser
  • Monetate
  • Optimizely
  • Qubit
  • Usabilla
  • VWO

Lire la documentation dédiée (en anglais)...

Question fréquemment posées (FAQ)

Quelle taille fait le tag ?

Le Tag Contentsquare dans sa version standard et compressé a une taille de 95.5 KB, et transféré du CDN Contentsquare vers le navigateur, et compressé par gzip.

Toutefois, si d'autres intégrations custom avec des services tiers sont ajoutés, le fichier peut être légèrement plus volumineux.

Combien de temps dure le cache du Tag ?

Le tag Contentsquare est stocké dans le cache local du navigateur pendant 15 minutes, ce qui signifie qu'il n'est en général chargé qu'une seule fois pour une session typique. Au-delà de 15 minutes, le tag sera retéléchargé seulement si une nouvelle version est déployée sur le CDN.

Quel est l'impact du tag sur le chargement des pages ?

Le tag Contentsquare doit être exécuté juste après l'événement “load” du Document Object Model (DOM). Notre recommandation est de placer le code dans l'élément <head> de votre page HTML, avec un attribut defer ; le tag sera chargé en asynchrone par le navigateur pendant qu'il continue à parcourir le HTML, et, une fois que le DOM est "prêt", il exécutera le tag.

Cela signifie également que le tag Contentsquare n'impactera aucune métrique "paint", telles que such as Time to First Byte (TTFB), First Contentful Paint (FCP) or Largest Contentful Paint (LCP).

Les seuls métriques potentiellement impactées par le Tag Contentsquare sont Total Blocking Time (TBT), Time to Interactive (TTI) and Interaction to Next Paint (INP). L'impact dépend de la taille du DOM, et de ses "mutations", lorsqu'il y a des interactions sur la page.

Une page avec un DOM de taille moyenne, et sur laquelle les interactions n'ont que peu d'impact sur le HTML (les "mutations") aura peu d'impact sur le Total Blocking Time.

Quelques exemples :

  • Une station de travail avec une puissance de traitement et une connexion haut débit satisfaisantes, et un navigateur moderne - le tag aura un impact entre 20ms et 50ms.
  • Un appareil mobile avec une puissance de traitement moyenne, une connexion 4G, et un navigateur moderne - le tag aura un impact entre 60ms et 120ms.

Si des tests révèlent un impact sur le Total Blocking Time impact plus élevé, cela peut être dû à :

  • Un Document Object Model (DOM) volumineux, contenant plus de 2000 nœuds.
  • Un nombre de mutations du DOM trop élevé, qui engendre du trafic réseau et donc augmente la charge CPU
  • L'appareil utilisé pour les tests est très ancien et a une faible puissance de traitement
  • Les tests en émulation sont réalisés sur de vieux appareils (par exemple le Moto G4), et surestiment l'impact du JavaScript en convertissant les "tâches courtes" en "tâches longues" qui ne s'appliquent pas à un scénario réel.

Quel impact sur les Core Web Vitals ?

La seule métrique Core Web Vital potentiellement impactée par le tag Contentsquare est le First Input Delay. Il s'agit d'une métrique mesurée par des données utilisateur réelles, et qui est liée à la métrique synthétique Total Blocking Time.

Vous pouvez facilement tracker les scores Core Web Vitals en utilisant la base de données publique Google BigQuery et les tableaux de bord Google Data Studio.

Suivez ces instructions pour le paramétrer pour votre site : https://g.co/chromeuxdash

Quelles métriques de performance peuvent être impactées par le tag ?

Le tag Contentsquare n'impacte les métriques qu'après avoir été chargé, parsé, et exécuté. Cela signifie qu'il n'a pas d'impact sur les métriques paint comme FCP, LCP ou l'indice de vitesse (Speed Index). Il n'impacte pas non plus les métriques de stabilité comme le Cumulative Layout Shift (CLS).

Voici un tableau récapitulatif des métriques potentiellement impactées par le Tag.

Nom de la métriqueImpactée par le Tag CS ?
Time to First Byte (TTFB)Non
First Meaningful Paint (FMP)Non
Largest Contentful Paint (LCP)Non
Speed IndexNon
Cumulative Layout Shift (CLS)Non
Time to Interactive (TTI)Oui
Total Blocking Time (TBT)Oui
Interaction to Next Paint (INP)Oui

Combien de requêtes sont générées par le Tag ?

Le nombre de requêtes effectuées par le Tag dépend des fonctionnalités activées pour un compte. Si le Session Replay est activé, le Tag effectue plusieurs requêtes pendant qu'un utilisateur navigue sur la page. Ces requêtes sont regroupées et envoyées par batch via des requêtes HTTP POST ou GET.

Si le Document Object Model (DOM) subit des mutations alors que l'utilisateur navigue sur la page, alors des requêtes supplémentaires seront envoyées.

Si la fonctionnalité de capture d'erreurs est activée, une requête supplémentaire par erreur sur la page sera déclenchée.

Quelle est la taille des requêtes envoyées vers Contentsquare ?

La taille des requêtes envoyées vers l'API Contentsquare varie selon les informations qui sont envoyées. La majorité des requêtes ne dépassent pas les 500 octets.

Troubleshooting

Mes données ne sont pas envoyées

À l'aide de notre extension Chrome Contentsquare Tracking Setup Assistant, vérifiez les points ci-dessous :

  • La balise principale est-elle chargée ? (Marqueur "1" ci-dessus). Si non :
    • Assurez-vous que l'appel est effectué par votre TMS ou dans votre page.
    • Assurez-vous qu'aucune Cross-origin Resource Sharing (CORS) n'empêche d'appeler la balise.
  • Le tag est-il actif ? (Marqueur "2" ci-dessus, le "Statut" doit être "actif". — Sinon, contactez-nous.)
  • Le domaine est-il autorisé ? (Le domaine actuel doit être répertorié sur le marqueur "2" ci-dessus — Sinon, contactez-nous.)
  • La session en cours est-elle traquée ? (Marqueur "3" — Sinon, mettez à jour ce menu déroulant.)

Ma métrique CS est différente des autres outils d'analyse

La technologie d’analyse web actuelle est dépendante des différents navigateurs, des systèmes d’exploitation et de la résolution d’écran. Ces différents composants peuvent affecter la qualité de la donnée de tous les outils analytiques.

Lorsque vous comparez les données de Contentsquare à d’autres outils analytiques, il est possible d’observer des différences entre les métriques majeures. Plusieurs facteurs sont à prendre en compte en fonction de l'outil et des indicateurs que vous comparez.

Autres définitions d'analyse. — Les définitions de mesures suivantes ont été extraites des documentations officielles Adobe Analytics et Google Analytics. Pour obtenir une assistance supplémentaire en matière de dépannage, reportez-vous aux onglets correspondants.

Statistiques de Sessions vs Visits

Définitions
[tab] Contentsquare

Le nombre de visiteurs uniques sur le site ou le nombre de visiteurs uniques qui ont vu une page au moins une fois au cours de leur visite.

[tab] Google Analytics

Nombre total de sessions (non unique) pour une période sélectionnée.

Une session est la période pendant laquelle un utilisateur est actif sur votre site web, votre application, etc.

Toutes les données d'utilisation (vues d'écran, événements, e-commerce, etc.) sont associées à une session.

[tab] Adobe Analytics

Une séquence de pages vues. La métrique des visites est couramment utilisée dans les rapports qui affichent le nombre de sessions utilisateur au cours de la période sélectionnée.

La métrique de visite est toujours associée à une période. Vous savez donc s'il faut compter une nouvelle visite si le même visiteur revient sur votre site. Une session commence lorsque l'utilisateur arrive sur votre site pour la première fois et se termine dans l'un des scénarios suivants :

  • 30 minutes d'inactivité : presque toutes les sessions se terminent de cette manière. Si plus de 30 minutes se sont écoulées entre les requêtes, une nouvelle visite commence.
  • 12 heures d'activité constante : si un utilisateur envoie des requêtes sans intervalle de plus de 30 minutes pendant 12 heures, une nouvelle visite commence automatiquement.
  • 2 500 hits : Si un utilisateur génère un grand nombre de hits sans démarrer une nouvelle session, une nouvelle visite est comptabilisée après 2 500 requêtes.
  • 100 hits en 100 secondes : si une visite comporte plus de 100 hits en moins de 100 secondes, la visite se termine automatiquement. Ce comportement indique généralement une activité de bot et cette limitation est appliquée pour éviter que ces visites à forte intensité de traitement n'augmentent le temps de latence et le temps nécessaire à la génération de rapports.

Une visite ne coïncide pas nécessairement avec une session de navigateur.

Suggestions de dépannage

Une divergence majeure dans les visites / sessions peut être due à plusieurs facteurs :

  • La définition de la métrique n'est pas la même entre les outils.
  • Le tag se déclenche tardivement et empêche la collecte des données.
  • Le déclencheur choisi n'est pas le même que celui utilisé pour votre autre outil d'analyse.

Taux de rebond et rebond

Définitions
[tab] Contentsquare

Le rapport entre les visiteurs qui sont entrés dans le site et qui l'ont quitté sans avoir vu une deuxième page et tous les visiteurs**, quel que soit le nombre d'actions effectuées sur cette seule page**.

[tab] Google Analytics

Un rebond est une session d'une seule page sur votre site. Le taux de rebond correspond aux sessions d'une page divisées par toutes les sessions, ou le pourcentage de toutes les sessions de votre site dans lesquelles les utilisateurs ne visualisent qu'une seule page et ne déclenchent qu'une seule requête auprès du serveur Analytics. Ces sessions d'une seule page ont une durée de session de 0 seconde, car il n'y a aucun autre résultat après le premier qui laisserait Analytics calculer la durée de la session.

[tab] Adobe Analytics

Rebond

Une visite qui consiste en un seul appel de serveur.

Par exemple, une visite d'une seule page est un rebond si un visiteur n'interagit pas avec la page de manière à envoyer des données à Adobe (en cliquant sur un lien, en lançant une vidéo…).

Taux de rebond

Affiche le pourcentage de visites contenant un seul accès.

Le taux de rebond utilise la métrique de rebonds et est calculé comme suit : Rebonds divisés par les entrées.

Le taux de rebond n'inclut pas les visites pour lesquelles plusieurs actions ont eu lieu sur une seule page.

Suggestion de dépannage

Lorsque vous faites face à un écart important entre le taux de rebond et le rebond, veuillez noter que la définition du taux de rebond par Contentsquare prend en compte les visiteurs qui n'ont visionné qu'une seule page, quel que soit le nombre d'événements / actions qu'ils ont effectués.

Pages vues

Définitions
[tab] Contentsquare

Nombre total de pages vues.

Une vue de page prend en compte toutes les pages vues artificielles déclenchées par la fonction trackPageview.

[tab] Google Analytics

Nombre total de pages vues.

Les vues répétées d'une seule page sont comptées.

[tab] Adobe Analytics

Une page vue est comptée pour chaque appel envoyé au serveur.

Cette métrique représente le nombre total d'instances de la page vue.

Les appels TrackLink ne sont pas comptés en tant que page vue et n'incrémentent pas la métrique page vue.

Suggestions de dépannage

Une divergence majeure dans le nombre de pages vues peut être due à plusieurs facteurs, tels que :

  • Les événements que vous suivez actuellement avec votre autre outil d'analyse ne sont pas comptabilisés comme une page vue.
  • Si la majeure partie de votre site fonctionne sur une structure SPA, chaque réacheminement est suivi sous la forme d'une nouvelle page vue par Contentsquare.

 

Transactions vs Conversions

Définitions
[tab] Contentsquare

Nombre de sessions au cours desquelles les visiteurs ont effectué une transaction e-commerce.

Une transaction e-commerce est collectée à chaque déclenchement du tag e-commerce.

[tab] Google Analytics

Nombre total de transactions réalisées sur votre site.

[tab] Adobe Analytics

Conversions

Les rapports de conversion personnalisés sont basés sur les eVars (variables de conversion). Les variables de conversions peuvent persister au-delà du pageview, et être associées avec des métriques dans les limites de leur durée de vie. Les métriques par défaut des rapports sont les recettes.

Toutes les mesures standard eCommerce peuvent être utilisées : Recettes, Commandes, Unités, Paniers, Consultations du panier, Achats, Ajouts au panier, Retraits du panier.

Pour plus d'informations : https://experienceleague.adobe.com/docs/analytics/components/metrics/overview.html?lang=fr

Transactions

Le nombre de commandes effectuées sur votre site web au cours de la période sélectionnée.

Suggestions de dépannage

Lorsque vous rencontrez des divergences importantes dans le nombre de transactions, si vous avez différentes pages de confirmation, veuillez vous assurer que le tag e-commerce est activé sur vos différentes pages de confirmation.

Taux de conversion

Définitions
[tab] Contentsquare

Le nombre de sessions avec des transactions e-commerce divisé par le nombre total de sessions au cours de la période sélectionnée.

[tab] Google Analytics

Pourcentage de sessions ayant abouti à une transaction e-commerce.

[tab] Adobe Analytics

Voir le point de conversion ci-dessus.

Suggestions de dépannage

Lorsque vous comparez le taux de conversion entre différents outils, veuillez noter que le taux de conversion de Contentsquare est basé sur le rapport entre le nombre de visites avec une transaction et le nombre total de visites.

Cette définition peut changer selon la solution d'analytics que vous utilisez.

Revenus

Définitions
[tab] Contentsquare

Montant total des transactions.

Cela n'inclut pas les taxes et les frais d'expédition.

La devise est également prédéfinie sur la plate-forme Contentsquare. Par conséquent, la valeur transmise doit être sans devise.

[tab] Google Analytics

Total des revenus provenant du e-commerce ou des transactions in-app.

Selon votre implémentation, cela peut inclure les taxes et les frais d’expédition.

[tab] Adobe Analytics

Les revenus sont saisis lors de l'événement d'achat et sont définis comme le montant total de la somme des commandes de chaque produit.

Cette valeur provient de l'événement d'achat.

Suggestions de dépannage

Un écart important dans les revenus peut être dû à plusieurs facteurs :

  • Contentsquare ne prend en compte que le montant défini comme "Revenue" dans la balise e-commerce lors du calcul du revenu total affiché.
  • Si vous devez exclure les frais d'expédition et les taxes du total des revenus, vous devez le faire avant d'envoyer la transaction.
  • Si vous avez une politique de retour, Contentsquare ne prend pas en compte les valeurs négatives dans les transactions.