Installation


Installation

# Vue d'ensemble

Skalin propose un SDK permettant de collecter l'identification et les fonctionnalités utilisées par les utilisateurs de votre plateforme , l'exploitation de ces informations permet l'alimenter un score d'usage dans Skalin afin obtenir un score de santé plus précis.

La mise en œuvre de ce service requiert :

  • L'insertion sur chaque page du site d'un script (SDK Skalin) qui permet de faciliter la collecte et le transfert des données vers notre plateforme.
  • La mise à disposition dans un format structuré de données lié à l'utilisateur connecté sur votre plateforme ainsi que des informations sur son contexte de navigation – couramment via un datalayer.

Les modalités de collecte sont décrites dans les sections suivantes du présent document.

# Protection des données

# Collecte et stockage first-party

Skalin utilise des cookies de type first-party pour tracker les interactions de vos utilisateurs. Ces cookies servent à stocker des informations telles que la date de visite en cours ou la récurrence des visites. En revanche, les cookies déposés ne stockent aucune donnée personnelle.

Les navigateurs ne permettent pas l'usage d'un cookie first-party entre plusieurs domaines. Cela signifie que les cookies déposés par Skalin ne peuvent pas être lus et utilisés par des sites tiers.

Notre SDK utilise le localStorage pour sauvegarder les identifiants de l'utilisateur. Par défault, toutes les données conservées via localStorage ont une durée d'expiration de 13 mois glissants (à chaque nouvelle connexion de l'utilisateur, l'expiration est ré-initialisée à 13 mois).

# Cadre réglementaire et responsabilités

Les développements récents de la législation de certains pays imposent de ne pas collecter d'informations de navigation dès lors qu'elles peuvent être rattachées à individu, et ce tant qu'il n'a pas donné consentement à cette collecte.

Les informations collectées par Skalin entrent dans la catégorie des informations rattachées à un individu, et il est important de respecter le cadre réglementaire en vigueur et les mesures qu'il impose. Notamment, il est de votre responsabilité de ne pas déclencher le tag Skalin tant que l'individu n'a pas donné son consentement si votre cadre réglementaire vous y contraint.

# Chargement du SDK

Le SDK fonctionne de manière asynchrone afin que l'affichage de la page par les navigateurs ne soit pas impacté par le téléchargement du script.

Le code suivant doit être inclus sur chaque page du site sur lequel la collecte est opérée, par exemple via un Tag Manager :

<script type="text/javascript">
(function(w,d,l,t){
   w[t]=w[t]||function(){var p=[];Array.prototype.push.apply(p,arguments);return (w[t].p=w[t].p||[]).push(p);};
   var g=d.createElement('script');g.type='text/javascript';g.defer=true;g.async=true;g.src=l;
   var s=d.getElementsByTagName('script')[0];s.parentNode.insertBefore(g,s);
})(window, document, "//assets.skalin.io/scripts/skalin.min.js" , "ska");

ska(function(skalin){
   skalin.clientId({{ClientId}});
});
</script>;
1
2
3
4
5
6
7
8
9
10
11
ClientId

votre identifiant client qui vous a été fourni par Skalin ou est disponible dans la section Paramétrage > Général

# Recette

Pour pouvoir vérifier le bon envoi des informations vers la plate-forme de Skalin, il faut utiliser les fonctionnalités de debug natives à la plupart des navigateurs. Nous prenons ici l'exemple des DevTools disponibles dans Google Chrome.

Dans l'onglet « Réseau », le filtre suivant doit être utilisé : « skalin ».

On retrouve ainsi toutes les informations transférées vers les serveurs Skalin.

Exemple

En ouvrant la première requête (action=ui pour user identity), on retrouve l'ensemble des informations envoyées vers la plate-forme Skalin dans la section « Header » > « Query String Parameters » :

On retrouve par exemple dans « identity » le contenu des informations d'identification de l'utilisateur.

Contributeurs: Julien