Manuel de Marquage

Manuel de
Marquage
XiTi v.7
Structure du marqueur
Les marqueurs de contenus
Tester le bon fonctionnement
XiTi – 85, avenue JF Kennedy – 33700 – Bordeaux Mérignac - France
SOMMAIRE
A – Structure du marqueur web XiTi v7 ............................................................ 3
B – Les marqueurs de contenus ....................................................................... 4
3
4
5
6
7
-
Un marqueur en 2 parties..............................................................................................
Les variables du marqueur.............................................................................................
Comment renseigner la variable xtpage / p ?....................................................................
Créer des chapitres automatiques ...................................................................................
Le fichier javascript ......................................................................................................
5
5
6
6
7
C – Tester le bon fonctionnement des marqueurs ............................................... 8
1 - Situation ..................................................................................................................... 8
2 - Tests .......................................................................................................................... 8
A – Structure du marqueur web XiTi v7
Le marqueur XiTi v7 se décompose en plusieurs parties, visibles ci-dessous sur un schéma récapitulatif
représentant une page dont tous les éléments sont traqués :
Le marqueur nécessaire au fonctionnement de toutes les pages est le marqueur de contenu. Ce marqueur
peut prendre différents aspects selon les cas.
Les sections suivantes ont pour objectif de détailler les différents marqueurs XiTi v7, en mettant en avant les
différents paramétrages spécifiques à chacun d’entre eux.
3
B – Les marqueurs de contenus
Disponibles dans la section « configuration > marqueurs XiTi > marqueurs de contenus », ils permettent
d’effectuer la mesure principale des pages à auditer. On distinguera 2 types de marqueurs :
Le marqueur léger
Le marqueur complet (recommandé)
Ces marqueurs doivent TOUJOURS se trouver entre les balises BODY et /BODY.
1 - Le marqueur complet
Il nécessite l’hébergement sur le serveur web du site à auditer
d’un fichier javascript (JS) fourni par XiTi.
Selon les modules actifs sur le contrat, ce fichier s’appelera :
xiti.js en version standard
ou
xtroi.js si le module ROI est activé sur le contrat
Ce marqueur est le seul qui soit compatible avec les marqueurs complémentaires (détaillés ci-après). Il permet
également de récupérer les affluents du site d’une façon plus propre et plus efficace que le marqueur léger,
c’est la raison pour laquelle il est vivement conseillé de l’utiliser.
Ce marqueur doit TOUJOURS se trouver entre les balises BODY et /BODY.
2 - Le marqueur léger
Il n’est pas compatible avec les marqueurs complémentaires. Il ne permet pas de profiter de toute la
technologie XiTi et n’est à utiliser qu’en dernier recours si :
vous ne pouvez pas héberger de fichier JS sur votre serveur web
vous n’avez pas besoin de marqueur complémentaire (si néanmoins cela s’avérait
nécessaire, une solution alternative pourrait être envisagée avec notre service technique)
toutes les analyses XiTi ne sont pas utiles pour vous (type de connexion, langue du
navigateur, etc. …)
4
3 - Un marqueur en deux parties
Le marqueur est constitué de 2 parties : une partie SCRIPT et une partie NOSCRIPT. Une seule de ces
parties sera appelée sur le poste de l’internaute, selon son acceptation ou non du javascript. Il est donc
primordial de paramétrer ces 2 parties de la même manière sur toutes les pages, faute de quoi XiTi
considèrera que ce sont des pages différentes.
<script type="text/javascript">
<!-xtnv = document;
//parent.document or top.document or document
xtsd = "http://logp";
xtsite = "1";
xtn2 = "5";
// level 2 site
xtpage = "mon_chapitre::ma_page";
//page name (with the use of :: to create chapters)
xtdi = "2";
//implication degree
//-->
</script>
<script type="text/javascript" src="http://www.monsite.fr/xtroi.js"></script>
<noscript>
<img width="1" height="1"
src="http://logp.xiti.com/hit.xiti?s=1&s2=5&p=mon_chapitre::ma_page&di=2&" >
</noscript>
4 - Les variables du marqueur
Ci-dessous, la liste des variables qui doivent être renseignées (partie SCRIPT / partie NOSCRIPT).
Certaines sont déjà pré-remplies par XiTi et ne doivent pas être modifiées :
xtnv : variable spécifiant l’emplacement du referrer à récupérer. Cette variable est renseignée
par défaut à « document », elle doit être changée en « parent.document » dans le cas d’une
frame/iframe sur le même nom de domaine (dans le cas de noms de domaines différents,
contactez le SAV XiTi)
xtsd : variable contenant votre serveur de collecte. Cette information ne doit pas être
modifiée.
xtsite / s : variable identifiant votre site. Cette information ne doit pas être modifiée.
xtn2 / s2 (contrats EXPERT et +) : site de niveau 2 dans lequel il faut ranger la page auditée.
Les sites de niveau 2 sont à créer via votre interface XiTi.
xtpage / p : nom de la page. A renseigner (cf ci-dessous pour le détail).
xtdi / di (contrats EXPERT et +) : degré d’implication de la page. La valeur par défaut est 0 ou
vide. Cette variable accepte les valeurs 1, 2, 3, 4 et 5 pour les pages ayant une implication
non nulle.
5
5 - Comment renseigner la variable xtpage / p ?
La variable xt_page permet de renseigner le nom de la page et de créer les chapitres XiTi. Les libellés qui y
sont renseignés ne doivent contenir que des caractères suivants :
Les lettres abcdefghijklmnopqrstuvwxyz en majuscules ou minuscules
Les chiffres 123467890
Les points .
Les slashs /
Les moins Les underscores _
Les tildes ~
Il est donc nécessaire d’effectuer un retraitement des noms si l’affichage est fait dynamiquement, afin de
nettoyer les caractères interdits lors du remplissage de cette variable. Selon la technologie utilisée sur le site à
auditer, il est possible que la méthode de filtrage ait déjà été développée par nos équipes, et que celle-ci soit
déjà disponible dans la section « configuration > fonctions programmées » de votre interface.
Ainsi, on pourrait obtenir comme nom de page :
xtpage = "homepage_fr”;
A noter que XiTi remplace automatiquement les underscores des libellés par des espaces au moment de
l’affichage dans votre interface, pour un confort de lecture et d’utilisation.
6 - Créer des chapitres automatiques
L’arborescence de XiTi permet de créer des chapitres afin de regrouper les pages et ainsi obtenir une vision
volumétrique globale. La définition et l’utilisation de chapitres s’effectue via le marqueur, sans paramétrage
dans l’interface, avec l’utilisation de la syntaxe « chapitre::page ».
Pour ranger « homepage_fr » dans le chapitre « site France », il suffirait d’utiliser la syntaxe suivante :
xtpage = "site_France::homepage_fr”;
6
Il est possible de créer 3 niveaux de chapitres à partir de la version expert. Notre exemple deviendrait donc :
xtpage = "SITES_EUROPE::sites_francophones::site_France::homepage_fr”;
7 - Le fichier javascript
Dans le cas du mode complet, un fichier javascript doit être hébergé sur le serveur. Ce fichier NE DOIS PAS
ETRE EDITE, il contient des librairies de fonctions nécessaires au bon fonctionnement de XiTi sur votre site.
Il est conseillé de le placer à la racine du site, ou dans un répertoire facilement accessible. Une fois hébergé, le
chemin de ce fichier doit être renseigné dans la partie SCRIPT du marqueur, à l’emplacement de l’url
« http://www.monsite.fr/xtroi.js » ou « http://www.monsite.fr/xiti.js » spécifiée par défaut. Vous pouvez y
renseigner un chemin relatif ou un chemin absolu.
L’intérêt de ce fichier est qu’il sera appelé par tous les marqueurs du site à auditer. Dès lors, il devient simple
et rapide de le mettre à jour :
mettre à jour le marqueur = mettre à jour le fichier JS
Pour vous tenir informé des éventuelles évolutions du
marqueur XiTi, n’hésitez pas à vous abonner au flux
RSS XiTi, via le menu « configuration > paramètres >
Flux RSS XiTi » de votre interface.
7
C – Tester le bon fonctionnement des marqueurs
1 - Situation
Vous venez de mettre en place le code du marqueur mais ne souhaitez pas attendre les résultats d’audience du
lendemain pour contrôler son bon fonctionnement.
2 - Tests
Vous pouvez utiliser le test du Rapport de confidentialité.
Une fois le code du marqueur inséré dans votre page et la page mise en ligne, vous avez la possibilité de
contrôler le bon fonctionnement du code du marqueur:
consultez une page de votre site contenant le code du marqueur avec Internet Explorer
sur la page en question, ouvrez le Rapport de confidentialité dans la rubrique Affichage >
Rapport de confidentialité d'Internet Explorer
vous verrez alors une fenêtre contenant tous les éléments de cette page. Vous devez voir une
ligne pour le code XiTi (ligne qui ressemble à http://logxxx.xiti.com/hit.xiti?s=.........).
Si cette ligne ne s'affiche pas, c'est qu'il y a un problème dans l'implémentation du code du marqueur.
Quels sont alors les différents points à vérifier?
le code du marqueur est-il placé dans le corps de la page (entre les balises <body> et
</body>)?
les retours à la ligne dans le code du marqueur sont-ils respectés ? (le code du marqueur
n’est pas étalé sur une sule ligne)
le fichier javascript (xiti.js ou xtroi.js) a-t-il été mis en ligne?
l'appel du fichier javascript a-t-il été modifié (www.monsite.fr remplacé par votre nom de
domaine) et correspond-il bien à son emplacement?
des caractères spéciaux comme les apostrophes ou guillemets ont-ils été placés dans la
variable xtpage?
y-a-t-il une erreur javascript sur cette page empêchant le code du marqueur de fonctionner
correctement ?
Si, après avoir passé en revue tous ces points de contrôle, l’appel à notre serveur n’est toujours pas visible
dans le Rapport de confidentialité, n’hésitez à interroger notre service client.
8