Initialisation du tracker

 

Avant-propos

Avant de commencer, vous devez télécharger notre bibliothèque JavaScript, ou bien la pousser sur notre CDN, depuis l’interface Tag Composer.

Cette dernière permet de :

  • Configurer le périmètre de marquage (site, domaine utilisé pour l’écriture de cookies, etc.).
  • Sélectionner les fonctionnalités désirées par le biais de plugins configurables.

Une fois la bibliothèque configurée, vous devez y faire appel dans la balise <head> de votre page.

 

Initialisation

L’initialisation du Tracker se fait par l’intermédiaire de méthodes JavaScript à insérer.

Le constructeur ATInternet.Tracker.Tag() peut prendre deux objets en paramètre, un premier destiné à la surcharge de la configuration du Tracker et un deuxième destiné à l’ajout de valeurs de contexte.

 

Configuration

Le fichier « smarttag.js » contient la configuration définie par défaut lors de la génération dans Tag Composer. Il est possible de surcharger une partie de celle-ci en précisant le nouveau paramétrage lors de l’initialisation.

Exemple :

Ici, la variable de configuration « secure » a été forcée à la valeur true.

Liste des variables de configuration de base pouvant être surchargées :

  • La variable secure permet d’envoyer les informations de manière sécurisée ou non. Préciser true dans le cas d’un protocole HTTPS et false pour un protocole HTTP.
  • La variable disableCookie, si elle est à true, permet d’empêcher l’écriture de cookies du tracker (first et third).
  • La variable cookieDomain permet de préciser le domaine pour l’écriture des cookies. Dans le cas où ce paramètre est vide (cookieDomain: ''), le domaine de la page courante sera utilisé.

  • La variable cookieSecure, si elle est à true, permet d’ajouter l’option ‘secure’ lors de l’écriture des cookies du tracker (first). Les cookies ‘secure’ ne fonctionnent que sur les pages HTTPS.
  • La variable ignoreEmptyChapterValue, si elle est à true, permet d’ignorer les chapitres sans valeur.

>= 5.5.0

Il existe d’autres variables de configuration mais nécessitant une connaissance avancée du Tracker (voir Annexe).

 

Contexte

Il est aussi possible de forcer des valeurs de contexte qui seront ajoutées et partagées entre les différents marqueurs du Tracker en fonction du type.

Exemple :

Ici, la valeur de campagne définie dans « forcedCampaign » sera ajoutée aux marqueurs de page du Tracker.

Liste des variables de contexte pouvant être déclarées :

  • La variable forcedCampaign permet de déclarer et de forcer une campagne.
  • La variable forcedRefererpermet de déclarer et de forcer un referer.
 

Marqueur basique

Voici un exemple de marqueur basique, vous permettant de mesurer une page vue portant le libellé « Page Name » :

 

Annexe

Variables de configuration pouvant être surchargées :

Nom Valeur par défaut Description Version
secure false Forcer le mode d’envoi sécurisé (HTTPS)
disableCookie false Empêcher l’écriture de cookies du tracker (first et third)
cookieDomain Valeur renseignée dans TagComposer Domaine pour l’écriture des cookies. Si ce paramètre est vide (cookieDomain: ''), le domaine de la page courante sera utilisé
cookieSecure false Ajouter l’option ‘secure’ lors de l’écriture des cookies du tracker (first) >= 5.5.0
ignoreEmptyChapterValue false Ignorer les chapitres sans valeur >= 5.5.0
site Valeur renseignée dans TagComposer Numéro de site
log Valeur renseignée dans TagComposer Sous-domaine du collecteur AT Internet
logSSL Valeur renseignée dans TagComposer Sous-domaine du collecteur sécurisé (HTTPS) AT Internet
domain Valeur renseignée dans TagComposer Domaine de l’url des hits
pixelPath /hit.xiti Chemin vers le fichier du pixel pour les hits
preview false Forcer l’envoi des hits de page dans le cas d’un chargement en mode preview sur le navigateur Safari (true : mesure activée, false : mesure désactivée)
Dernière mise à jour : 10/11/2017