Identification du visiteur unique

 

Avant-propos

Avant de commencer l’implémentation du plugin ClientSideUserId, veuillez-vous assurer d’avoir initialisé le Tracker JavaScript AT Internet et sélectionné le plugin depuis l’interface Tag Composer.

 

Principe

Le plugin ClientSideUserId permet le suivi d’un visiteur par la création d’un identifiant utilisateur dans le cas où l’écriture de cookies tiers n’est pas envisageable. Ceci peut être le cas par exemple sur un site intranet, lors de l’utilisation du navigateur Safari (configuration par défaut), ou encore lors de la navigation depuis des terminaux Apple type iPhone, iPad ou iPod. Il est également possible de configurer le plugin pour forcer l’utilisation d’un identifiant aléatoire ou personnalisé. Cet identifiant se retrouve dans la variable idclient présente dans tous les hits lorsque le plugin est actif.

 

Configuration du plugin

Le mode de fonctionnement du plugin est directement configurable depuis l’interface ou via la configuration, à l’initialisation du Tracker.

Trois modes sont disponibles :

  • required : l’identifiant utilisateur est ajouté à tous les hits sur le navigateur Safari ou dans le cas de l’utilisation d’un terminal Apple.
  • always (par défaut) : l’identifiant utilisateur est ajouté à tous les hits sur tout type de support.
  • never : le plugin est désactivé, l’identifiant utilisateur n’est jamais ajouté aux hits.

Pour changer le mode, ajouter le code suivant à l’endroit souhaité :

Ajouter l’identifiant utilisateur à tous les hits, uniquement pour les supports concernés (Safari, iPhone, iPad, iPod) :

var config = {ClientSideUserId: {clientSideMode: 'required'}};
var tag = new ATInternet.Tracker.Tag(config);

Ajouter l’identifiant utilisateur à tous les hits :

var config = {ClientSideUserId: {clientSideMode: 'always'}};
var tag = new ATInternet.Tracker.Tag(config);

Ne jamais ajouter l’identifiant utilisateur :

var config = {ClientSideUserId: {clientSideMode: 'never'}};
var tag = new ATInternet.Tracker.Tag(config);
 

La gestion de l’identifiant utilisateur

L’identifiant utilisateur doit être renseigné tout au long de la visite de l’internaute (sur tous les hits). Cet identifiant est stocké dans un cookie sur le domaine déclaré dans la configuration du Tracker (variable cookieDomain), pour être réutilisé sur les pages où il ne serait pas renseigné.

Si besoin, le cookie contenant l’identifiant utilisateur est directement paramétrable via la configuration :

Définir la durée de vie du cookie (en jours, 397 par défaut) :

var config = {ClientSideUserId: {userIdCookieDuration: 397}};
var tag = new ATInternet.Tracker.Tag(config);

Définir une durée de vie fixe pour le cookie (par défaut) :

var config = {ClientSideUserId: {userIdExpirationMode: 'fixed'}};
var tag = new ATInternet.Tracker.Tag(config);

Configurer un cookie glissant :

var config = {ClientSideUserId: {userIdExpirationMode: 'relative'}};
var tag = new ATInternet.Tracker.Tag(config);
 

Déclarer un identifiant utilisateur

Si aucun identifiant ne se trouve ni dans le marqueur, ni dans le cookie, un identifiant unique est généré.

Vous pouvez forcer un identifiant utilisateur :

En passant par une variable de contexte userIdentifier :

var config = {
    ClientSideUserId: {
        clientSideMode: 'required',
        userIdCookieDuration: 397,
        userIdExpirationMode: 'fixed'
    }
};
var context = {
    userIdentifier: 'userID'
};
var tag = new ATInternet.Tracker.Tag(config, context);

En utilisant la fonction set du plugin :

var config = {
    ClientSideUserId: {
        clientSideMode: 'required',
        userIdCookieDuration: 397,
        userIdExpirationMode: 'fixed'
    }
};
var tag = new ATInternet.Tracker.Tag(config);
tag.clientSideUserId.set('userID');

Dans le cas où les deux méthodes seraient utilisées, la fonction set reste prioritaire.

Dernière mise à jour : 12/10/2021