Premiers pas avec

Piano Analytics

Vous débutez avec Piano Analytics (AT Internet) et vous ne savez pas par quoi il faut commencer pour avoir les premières analyses standards qu’offre la solution.

Intégration librairie Piano Analytics et configurations

Votre première étape est d’intégrer la librairie du nouvel SDK de Piano grâce au CDN sur votre site ou dans le TMS que vous utilisez afin qu’elle soit disponible à chaque chargement de page.

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

Vous avez la possibilité de choisir la version du SDK au lieu de prendre la dernière mise à jour.

Vous pouvez également ajouter des configurations grâce aux méthodes suivantes :

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

Petite note d’intention cool : vous pouvez gérer le domain de dépôt de cookies.

Si vous n’utilisez pas la config pour le définir, c’est le domaine de votre page qui sera pris en compte, ce qui n’est pas idéal pour le suivi des sous-domaines de votre site.


//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

Votre seconde étape sera d’intégrer non plus un initialiseur de tracker qui n’est plus nécessaire mais uniquement une simple configuration qui permet de collecter les données sur le bon domain de collect ainsi que sur l‘id de site sur lequel vous souhaitez retrouver vos données dans l’interface de Piano Analytics.

Pour retrouver ses 2 informations obligatoires, il faudra d’abord demander au support de vous créer vos sites si vous n’en avez pas puis de vous rendre dans l’interface :

  • Configuration
  • Data Collection Portal
  • Marquage
  • Domain de collect (ex : logsX.xiti.com)
  • Identifiant de site 123456

//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

//Configurations obligatoires pour votre site
<script>
pa.setConfigurations({
site: 123456,
collectDomain: "https://logsX.xiti.com"
});
</script>

Intégrer la privacy

La gestion du consentement doit se faire avant votre déclenchement d’event de page.display pour être en règle avec la CNIL.

Il existe plusieurs cas de figures pour la gestion du consentement.

Si vous avez l’exemption CNIL (possible de le contracter avec le support de Piano).

Qu’est-ce que l’exemption CNIL ? Il s’agit de pouvoir récolter les données dites strictements nécessaires, c’est-à-dire les pages, les clics et autres informations afin de garder une meilleure visibilité de votre audience générale sauf s’il y a eu opt-out.

Il existe 3 niveaux de gestion de consentement :

  1. Bandeau de cookies (un visiteur arrive pour la première fois, il sera en mode exempt et donc fait parti de votre audience. S’il fait le choix « continuer sans accepter’, il reste en mode exempt sinon s’il choisit « accepter’, il passe en opt-in)
  2. Bannières des partenaires dans la gestion du consentement (opt-in ou exempt pour Piano Analytics)
  3. Page de politiques de confidentialités du site où le visiteur peut s’opt-out complètement de Piano Analytics.

Comment gère-t on l’intégration de la privacy avec Piano Analytics ?

1. Vous n’avez pas l’exemption CNIL :

Le visiteur arrive sur votre site pour la première fois, vous ne devez pas le tracker.

Il faut tout d’abord qu’il puisse donner son consentement, c’est-à-dire qu’il doit accepter les cookies de Piano Analytics via le bandeau sinon il sera en mode opt-out (donc ne fera pas parti de votre audience).


//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
window.pdl = window.pdl || {}; //Pré-config obligatoire pour utiliser l'objet window.pdl pour gérer le consentement
window.pdl.requireConsent = true; //Pour activer le consentement
window.pdl.consent = { //Donner le mode de consentement par défaut, ici opt-out quand il n'y a pas l'exemption
  defaultPreset: {
    PA: 'opt-out'
  }
};
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

//Configurations obligatoires pour votre site
<script>
pa.setConfigurations({
site: 123456,
collectDomain: "https://logsX.xiti.com"
});

//Conditions pour gérer la privacy
if("condition vérifiant si le visiteur est en opt-in"){
    pa.consent.setMode('opt-in');
}
else{ // si le visiteur est en opt-out
    pa.consent.setMode('opt-out')
}
</script>

2. Vous avez l’exemption CNIL :

Le visiteur arrive sur votre site pour la première fois, vous pouvez le tracker avec le mode exempt.

Puis opt-in s’il accepte cool sinon opt-out en 3e niveau de consentement au niveau de la page de politiques et confidentialités par exemple.

Pour gérer les modes de consentement, je vous invite à bien suivre la documentation dev de Piano Analytics.


//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
window.pdl = window.pdl || {}; //Pré-config obligatoire pour utiliser l'objet window.pdl pour gérer le consentement
window.pdl.requireConsent = true; //Pour activer le consentement
window.pdl.consent = { //Donner le mode de consentement par défaut, ici essential quand il y a l'exemption
  defaultPreset: {
    PA: 'essential'
  }
};
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

//Configurations obligatoires pour votre site
<script>
pa.setConfigurations({
site: 123456,
collectDomain: "https://logsX.xiti.com"
});

//Conditions pour gérer la privacy
if("condition vérifiant si le visiteur est en opt-in"){
    pa.consent.setMode('opt-in');
}
else if("condition vérifiant si le visiteur est en exempt"){
    pa.consent.setMode('essential');
}
else{ // si le visiteur est en opt-out
    pa.consent.setMode('opt-out')
}
//Configuration nécessaire si vous souhaitez envoyer certains events ou propriétés en mode "essential" donc exempt
window.pdl.consent_items = {
  "PA": {
    "properties": {
      "env_work": "essential",
      "type_template": "essential"
    },
    "events": {
      "internal_search_result.display": "optional",
      "internal_search_result.click": "essential"
    }
  },
};
</script>

Intégrer un event de Page

Deux cas s’offrent à vous :

1. Vous n’avez pas de datalayer et vous souhaitez avoir des données d’audience, de féquentation, ou le temps passé dans Piano Analytics.

Il vous suffira uniquement de déposer un tag light, c’est-à-dire un event de page vide. (il faut bien sûr que vous ayez suivi l’étape ci-dessus pour mettre en place la configuration essentielle au bon fonctionement de Piano Analytics).

Dans l’interface de Piano Analytics, vous retrouverez sous la propriété page, les urls de vos pages.


//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
window.pdl = window.pdl || {}; //Config obligatoire pour le consentement
window.pdl.requireConsent = true; //Pour activer le consentement
window.pdl.consent = { //Donner le mode de consentement par défaut, ici essential quand il y a l'exemption
  defaultPreset: {
    PA: 'essential'
  }
};
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

//Configurations obligatoires pour votre site
<script>
pa.setConfigurations({
site: 123456,
collectDomain: "https://logsX.xiti.com"
});

//Conditions pour gérer la privacy
if("condition vérifiant si le visiteur est en opt-in"){
    pa.consent.setMode('opt-in');
}
else if("condition vérifiant si le visiteur est en exempt"){
    pa.consent.setMode('essential');
}
else{ // si le visiteur est en opt-out
    pa.consent.setMode('opt-out')
}
//Configuration des propriétés et des events dans la privacy
window.pdl.consent_items = {
  "PA": {
    "properties": {
      "env_work": "essential",
      "type_template": "essential"
    },
    "events": {
      "internal_search_result.display": "optional",
      "internal_search_result.click": "essential"
    }
  },
};
</script>

//Event de Page sans datalayer
<script>
pa.sendEvent('page.display', {});
</script>

2. Vous avez un datalayer, il faudra juste déposer un event de page en utilisant les propriétés standards de Piano (‘page’, ‘page_chapter1’, ‘page_chapter2’ et/ou ‘page_chapter3’) en les mappant avec vos variables du datalayer.

Cela va permettre de récupérer le nom de page et le chapitrage qui reprend très souvent le fil d’Ariane (breadcrumb) ou sous rubriques de vos pages.


//Gestion du domain de cookie à poser avant la librairie de Piano Analytics
<script>
window._pac = window._pac || {};
_pac.cookieDomain = '.mysite.com';
window.pdl = window.pdl || {}; //Config obligatoire pour le consentement
window.pdl.requireConsent = true; //Pour activer le consentement
window.pdl.consent = { //Donner le mode de consentement par défaut, ici essential quand il y a l'exemption
  defaultPreset: {
    PA: 'essential'
  }
};
</script>

//Appel de la librairie après la gestion du domain de cookie
<script src="https://tag.aticdn.net/piano-analytics.js"></script>

//Configurations obligatoires pour votre site
<script>
pa.setConfigurations({
site: 123456,
collectDomain: "https://logsX.xiti.com"
});

//Conditions pour gérer la privacy
if("condition vérifiant si le visiteur est en opt-in"){
    pa.consent.setMode('opt-in');
}
else if("condition vérifiant si le visiteur est en exempt"){
    pa.consent.setMode('essential');
}
else{ // si le visiteur est en opt-out
    pa.consent.setMode('opt-out')
}
//Configuration des propriétés et des events dans la privacy
window.pdl.consent_items = {
  "PA": {
    "properties": {
      "env_work": "essential",
      "type_template": "essential"
    },
    "events": {
      "internal_search_result.display": "optional",
      "internal_search_result.click": "essential"
    }
  },
};
</script>

//Event de page avec datalayer
<script>
pa.sendEvent('page.display', {
'page': 'page_name',
'page_chapter1': 'sous_page_name'
});
</script>

En résumé :

  • intégrer la librairie de Piano Analytics
  • intégrer la config du domain de cookie avec window._pac
  • intégrer la config de la privacy avec window.pdl
  • intégrer la config obligatoire avec pa.setConfigurations
  • intégrer la privacy
  • intégrer votre premier event de page

Vous êtes maintenant fin prêt pour réaliser vos premières analyses et profiter des éléments standards de la solution Piano Analytics, enjoy !

Pas de data, pas de chocolat !