Guide d`installation du marqueur unique

Transcription

Guide d'installation du marqueur unique
Médiamétrie-eStat
Siège social :
Buropolis Bât.2
1240, route des Dolines
25
Sophia Antipolis
06560 Valbonne
SAS au capital de 80.496 euros / R.C.S Grasse B 440 736 395
E-mail : [email protected]
Tél : 04 92 38 38 20
Fax : 04 92 96 91
Médiamétrie-eStat : Liste des marqueurs disponibles
Introduction
La technologie de mesure et d’analyse d’audience repose sur l’insertion d'un marqueur (ou tag) dans les
pages du site. L’implémentation du marqueur est une étape importante pour tirer toute la valeur ajoutée de
nos solutions. C’est pourquoi, il est nécessaire de se poser les bonnes questions avant de procéder au
marquage de votre site : est-ce que le site est en Flash, comporte-t-il des pages sécurisées, des frames ?
Est-ce qu’il y a des redirections ? Quel est le découpage du contenu dont j’ai besoin pour mes analyses ?
etc.
Pour information, voici la liste récapitulative de l’ensemble des cas que le marqueur unique MédiamétrieeStat permet de gérer :
•
•
•
•
•
•
•
2 niveaux
2 niveaux sécurisé
frame 2 niveaux
2 niveaux de redirection pour les référenceurs
2 niveaux XHTML 1.0 strict
multicritère 2 niveaux
Flash 2 niveaux
•
•
•
•
•
•
•
4 niveaux
frame 4 niveaux
4 niveaux de redirection pour les référenceurs
4 niveaux sécurisé
4 niveaux XHTML 1.0 strict
multicritère 4 niveaux
Flash 4 niveaux
•
•
•
•
•
eCommerce
eCommerce sécurisé
eCommerce multidevise
eCommerce sécurisé multidevise
eCommerce payement externalisé
•
wap/i-mode
•
Streaming
•
Segmentation
Ainsi qu’un mode de vérification du marqueur afin de vous aider lors du marquage de vos pages.
-2-
-3-
SOMMAIRE
INTRODUCTION...................................................................................................................2
1- LE MARQUAGE 2 NIVEAUX STANDARD...................................................................... 7
Syntaxe
7
Paramètres du marqueur
7
2- LE MARQUAGE 2 NIVEAUX SÉCURISÉ...................................................................... 11
Syntaxe
11
11
3- LE MARQUAGE DE REDIRECTION..............................................................................12
Syntaxe
12
12
4- LE MARQUAGE FRAME................................................................................................ 14
Syntaxe
14
14
5- LE MARQUAGE XHTML 1.1.......................................................................................... 15
Syntaxe
15
15
Remarques
15
6- LE MARQUAGE MULTICRITÈRES :............................................................................. 16
Syntaxe
16
16
Remarques
16
7- LE MARQUAGE ROI ..................................................................................................... 17
Syntaxe
17
17
Remarques
18
-4-
8- LE MARQUAGE ROI SÉCURISÉ...................................................................................19
Syntaxe
19
19
9- LE MARQUAGE ROI DANS LE CAS DE PAIEMENT EXTERNALISÉ.........................21
Paiement externalisé : modification des marqueurs indispensable
21
ETAPE 1 : Modification du marqueur sur les pages qui précèdent l’achat.
21
ETAPE 2 : La validation d’achat.
21
10- LE MARQUAGE FLASH ..............................................................................................22
Syntaxe
22
22
Remarques
23
11- LE MARQUAGE WAP/I-MODE ................................................................................... 24
Syntaxe
24
24
Remarques
24
12- LE MARQUAGE 4 NIVEAUX........................................................................................25
Syntaxe
25
25
Remarques
25
13- LE MARQUAGE 4 NIVEAUX SÉCURISÉ.................................................................... 27
Syntaxe
27
27
Remarques
27
14- LE MARQUAGE 4 NIVEAUX DE REDIRECTION........................................................28
Syntaxe
28
29
15- LE MARQUAGE 4 NIVEAUX FRAME..........................................................................30
Syntaxe
30
-5-
30
Remarques
30
16- LE MARQUAGE 4 NIVEAUX XHTML1.1..................................................................... 31
Syntaxe
31
31
17- LE MARQUAGE 4 NIVEAUX MULTICRITÈRES......................................................... 32
Syntaxe
32
32
18- LE MARQUAGE FLASH 4 NIVEAUX...........................................................................33
Syntaxe
33
33
19- LE MARQUAGE WAP/I-MODE 4 NIVEAUX................................................................ 35
Syntaxe
35
35
Remarques
35
20- LE MARQUAGE STREAMING..................................................................................... 36
Principe de fonctionnement de la mesure du streaming
36
Syntaxe
36
Cas des Players Windows Media...................................................................................................................................38
Cas des Players Flash.....................................................................................................................................................38
Cas des Players Quicktime............................................................................................................................................ 40
Cas des autres Players....................................................................................................................................................40
Intégration de players dans vos pages HTML...............................................................................................................40
Intégration de plusieurs players sur une même page.....................................................................................................41
Comment ajouter des callbacks personnelles (utilisation avancee du marqueur)..........................................................41
Utilisation.......................................................................................................................................................................41
Exemple d’utilisation de callbacks................................................................................................................................45
Compatibilité avec les applications ..............................................................................................................................46
Indicateurs disponibles.................................................................................................................................................. 46
Définitions..................................................................................................................................................................... 46
21- OPTION DE SEGMENTATION.....................................................................................47
Syntaxe
47
Paramètres de l'option des marqueurs
47
22- OPTION DE CRMID...................................................................................................... 48
Syntaxe
48
-6-
23- LE MODE DE VÉRIFICATION DU MARQUEUR......................................................... 49
1- Le marquage 2 niveaux standard
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 2 NIVEAUX STANDARD

<SCRIPT LANGUAGE="JavaScript">
<!-var _PJS=0;
//-->
</SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="http://prof.estat.com/js/SERIAL.js"></SCRIPT>
<!-if(_PJS) {
eStat_id.serial("SERIAL");
eStat_id.master("MASTER");
eStat_id.pg_mq("PAGE_MARQUEE");
eStat_id.gp_pg_mq("GROUPE_PAGES_MARQUEES");
eStat_tag.post("m");
}
//-->
</SCRIPT>
<NOSCRIPT>
<IMG SRC="http://prof.estat.com/m/web/SERIAL?
g=MASTER&p=PAGE_MARQUEE&c=GROUPE_PAGES_MARQUEES&st=0&sjs=0" BORDER="0"
WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

-SERIAL : c'est l'identifiant du sous-compte.
Le sous-compte correspond au niveau site. Ce paramètre doit être obligatoirement présent dans tous
marqueurs.
-MASTER : c'est l'identifiant du compte de cumul appelée également compte maître.
Le compte de cumul permet d’agréger l’audience d'un ensemble de sous-comptes compris dans le périmètre
audité.
Ce paramètre n'est pas forcément renseigné au niveau des marqueurs. Si vous n’avez pas de compte de
cumul, vous pouvez omettre la ligne commençant par «eStat_id.master ».
- Le paramètre PAGE_MARQUEE permet d'affecter librement un libellé à chaque URL d'un site. Cela
permet de suivre l'audience non plus en fonction des URL mais à l'aide de ces libellés. On retrouve
l'audience de tous ces libellés dans le tableau des "Pages Marquées".
-7-
- Le paramètre GROUPE_PAGES_MARQUEES, qui fonctionne comme le paramètre PAGE_MARQUEE,
permet de cumuler l'audience de plusieurs pages marquées dans une rubrique définie librement.
Généralement, un groupe de pages marquées est associé à une section ou à une thématique du site. On
retrouve l'audience de tous ces libellés dans le tableau des "Groupe de Pages".
-8-
Remarques
Ce marqueur est à insérer juste avant la balise </body> des pages que vous souhaitez auditer sur votre site.
Attention ! Vous devez strictement respecter cette syntaxe, tant dans son contenu que dans sa disposition
(renvois à la ligne, casse...).
Pour disposer de la mesure de la fréquentation, ce type de marqueur est indispensable. (Marqueur où l’on
doit personnaliser des paramètres pour caractériser une page).
Au niveau de l'interface des rapports d'audience, dès qu'un libellé n'est pas personnalisé dans le marqueur,
il sera automatiquement remplacé par le terme "indéterminé" dans les rapports d'audience.
Si vous consultez la section Contenu vous aurez :
Par Niveau 3 (Groupe de Pages Marquées) : GROUPE_PAGES_MARQUEES
Par Niveau 4 (Page Marquée) :PAGE_MARQUEE(GROUPE_PAGES_MARQUEES)
Afin d'appeler dynamiquement le marqueur avec les paramètres adaptés aux pages, vous pouvez remplacer
ceux-ci par des variables gérées dans vos scripts. (PHP,ASP,JSP...)
Exemple en php :
VOTRE SYNTAXE DE MARQUEUR 2 NIVEAUX STANDARD (PHP)

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_id.pg_mq("<? echo $PAGE_MARQUEE; ?> ");
eStat_id.gp_pg_mq("< ? echo $GROUPE_PAGES_MARQUEES; ?> ");
}
//-->
</SCRIPT>
<NOSCRIPT>
<IMG SRC="http://prof.estat.com/m/web/SERIAL?g=MASTER&p=<? echo $PAGE_MARQUEE; ?>&c=<?
echo $GROUPE_PAGES_MARQUEES; ?>&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

où $PAGE_MARQUEE et $GROUPE_PAGES_MARQUEES sont des variables gérées dans votre script
PHP.
-9-
Exemple en ASP et JSP :
VOTRE SYNTAXE DE MARQUEUR 2 NIVEAUX STANDARD (ASP et JSP)

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_id.pg_mq("<%=PAGE_MARQUEE%>");
eStat_id.gp_pg_mq("<%=GROUPE_PAGES_MARQUEES%> ");
}
//-->
</SCRIPT>
<NOSCRIPT>
<IMG SRC="http://prof.estat.com/m/web/SERIAL?g=MASTER&p=<%=PAGE_MARQUEE%>&c=<
%=GROUPE_PAGES_MARQUEES%>&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

où PAGE_MARQUEE et GROUPE_PAGES_MARQUEES sont des variables gérées dans votre script ASP
ou JSP.
- 10 -
2- Le marquage 2 niveaux sécurisé
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 2 NIVEAUX SECURISE

<!-var _PJS=0;
//-->
</SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="https://prof.estat.com/js/SERIAL.js"></SCRIPT>
<!-if(_PJS) {
eStat_id.secur();
}
//-->
</SCRIPT>
<NOSCRIPT>
<IMG SRC="https://prof.estat.com/m/web/SERIAL?
</NOSCRIPT>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
Cf. définition de ces 4 paramètres au niveau de "1du marqueur.
Le marquage 2 niveaux standard" : Paramètres
Remarques
Pour permettre l'audit des pages sécurisées, Médiamétrie-eStat a développé ce marqueur spécifique faisant
appel à des serveurs fonctionnant avec le protocole ssl.
+ Cf. remarques présentes au niveau de "1-
Le marquage 2 niveaux standard" : Remarques.
- 11 -
3- Le marquage de redirection
Syntaxe
VOTRE SYNTAXE DE MARQUEUR REDIRECTION (PAGE EFFECTUANT LA REDIRECTION)
#MARQUEUR A PLACER SUR LA PAGE EFFECTUANT LA REDIRECTION
#TAG TO PASTE ON THE PAGE WHICH MAKES THE REDIRECTION

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if (_PJS) eStat_tag.post("sr");
//-->
</SCRIPT>

VOTRE SYNTAXE DE MARQUEUR REDIRECTION (PAGE SUR LAQUELLE EST EFFECTUEE LA
REDIRECTION)
#MARQUEUR A PLACER SUR LA PAGE OU S EFFECTUE LA REDIRECTION
#TAG TO PASTE ON THE PAGE WHICH IS THE REDIRECTION GOAL

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_tag.post("mr");
}
//-->
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
- 12 -
Cf. définition de ces 4 paramètres au niveau de "1du marqueurs.
Remarques
Il y a donc deux marqueurs à placer. Seul le second a des paramètres à renseigner.
Le marqueur de redirection est nécessaire lorsque "une page web renvoie automatiquement l'internaute vers
une autre page web.
Il faut dans ce cas placer un marqueur sur la "page qui renvoie" et un marqueur sur la "page qui reçoit".
Si ces derniers ne sont pas utilisés, la provenance est alors perdue. On considère que le visiteur vient de
la "page qui renvoie" au lieu de venir du moteur de recherche Google par exemple.
- 13 -
4- Le marquage frame
Syntaxe
VOTRE SYNTAXE DE MARQUEUR FRAME

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_tag.post("mf");
}
//-->
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
Remarques
Si vous utilisez un marqueur standard (eStat_tag.post("m");) au lieu d'un marqueur frame
(eStat_tag.post("mf");) alors que votre site contient des frames (cadre) : les provenances sont perdues.
+ Cf. remarques présentes au niveau de "1- Le marquage 2 niveaux standard " : Remarques.
- 14 -
5- Le marquage xhtml 1.1
Syntaxe
VOTRE SYNTAXE DE MARQUEUR XHTML 1.1

<script type="text/javascript">
<!-var _PJS=0;
//-->
</script>
<script type="text/javascript" src="http://prof.estat.com/js/SERIAL.js"></script>
<!-if(_PJS) {
}
//-->
</script>
<noscript>
<div>
<img src="http://prof.estat.com/m/web/SERIAL?
g=MASTER&p=PAGE_MARQUEE&c=GROUPE_PAGES_MARQUEES&st=0&sjs=0"
width="1" height="1" alt="eStat Pro" />
</div>
</noscript>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
Cf. définition de ces 4 paramètres au niveau de " 1du marqueur.
Le marquage 2 niveaux standard " : Paramètres
Remarques
Ce marqueur respecte la norme XHTML 1.1 .
+ Cf. remarques présentes au niveau de "1- Le
marquage 2 niveaux standard" : Remarques.
- 15 -
6- Le marquage multicritères :
Syntaxe
VOTRE SYNTAXE DE MARQUEUR MULTICRITERES

<!-var _PJS=0;
//-->
</script>
<!-if(_PJS) {
eStat_id.critere(1,"CRITERE1");
eStat_tag.post("mmc");
}
//-->
</script>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
Cf. définition de ces 4 paramètres au niveau de " 1du marqueur.
Jusqu'à 5 critères d'analyses sont disponibles dans le marqueur, ces critères sont indépendants des
paramètres d'analyses du contenu et il s peuvent être croisés entre eux.
- Les paramètres 'CRITERE1','CRITERE2','CRITERE3','CRITERE4','CRITERE5'. Les CRITERE1 à
CRITERE4 correspondent aux différents critères de recherche entrés par l'utilisateur et le CRITERE5 vaut 1
ou 0, selon si la requête a donné un résultat ou non.
Remarques
En plus de mesurer la fréquentation, ce marqueur vous permet d’analyser les informations enregistrées sur
vos moteurs de recherche interne et vos formulaires en ligne.
- 16 -
7- Le marquage ROI
Syntaxe
VOTRE SYNTAXE DE MARQUEUR ROI

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_id.action("ACTION");
eStat_id.typ_prod("TYPE_PRODUIT");
eStat_id.mrq_prod("MARQUE_PRODUIT");
eStat_id.ref_prod("REFERENCE_PRODUIT");
eStat_id.nbr("NOMBRE");
eStat_id.ca_engdr("CA_ENGENDRE");
eStat_tag.post("ma");
}
//-->
</SCRIPT>
<NOSCRIPT>
g=MASTER&action=ACTION&ptype=TYPE_PRODUIT&pbrand=MARQUE_PRODUIT&pref=REFERENCE_
PRODUIT&nb=NOMBRE&ca=CA_ENGENDRE&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

-MASTER
-SERIAL
Cf. définition de ces 2 paramètres au niveau de "1du marqueurs
Le marqueur eCommerce comporte six paramètres qu'il faut personnaliser le plus rigoureusement possible
afin que les analyses soient les plus en phase avec la réalité :
-
ACTION : Permet de renseigner de manière dynamique quelle est l'étape d'achat. A remplacer par
V(=Visualisation), P(=Mise en panier), A(=Confirmation d'achat).
-
TYPE_PRODUIT : premier paramètre pour identifier votre produit ou article.
-
MARQUE_PRODUIT : deuxième paramètre pour personnaliser votre produit ou article.
-
REFERENCE_PRODUIT : troisième paramètre pour personnaliser votre produit.
-
NOMBRE : nombre de fois ou le produit ou l'article a été acheté.
-
CA_ENGENDRE : Chiffre d'affaires unitaire
- 17 -
Remarques
Ce marqueur permet une analyse ciblée e-commerce. Pour disposer en plus de la mesure de la
fréquentation il est indispensable d’intégrer également le marqueur eStat’Pro.
Les champs ACTION, TYPE_PRODUIT, MARQUE_PRODUIT, REFERENCE_PRODUIT doivent
obligatoirement contenir un libellé.
A chaque étape de l'achat : V (visualisation), P (mise en panier) puis A (achat), les libellés pour un produit
doivent être strictement identiques. Si cela n'est pas respecté, on perd une certaine cohérence au niveau du
tableau "Par article : CA et efficacité (étapes d'achat)".
Pour une commande comprenant plusieurs produits différents, il est possible d'écrire la ligne d'appel
plusieurs fois.
D'autre part, dans le cas de rafraîchissement de page, nous considérons que l'ensemble des produits
présents dans le tag eCommerce sont rajoutés à la commande (dès qu'un marqueur est appelé nous
enregistrons une mesure). Le CA est donc multiplié par 2 mais le nombre de commande est toujours de 1.
Pour calculer le nombre de commande nous nous basons sur le cookie (ou user agent/IP) et la visite. Ainsi
tant que le visiteur passe des commandes au cours d'une même visite, nous considérons qu'il n'y a qu'une
seule commande.
Il ne faut pas mettre de caractères spéciaux dans les marqueurs eCommerce (seul le " _ " est accepté.).
Cela entraîne des problèmes d'affichage.
En adaptant le script du marqueur, il est possible de le personnaliser dynamiquement. Afin d'appeler
dynamiquement le marqueur avec les paramètres adaptés aux pages, vous pouvez remplacer ceux-ci par
des variables gérées dans vos scripts. (PHP, ASP, JSP...)
Le marqueur ROI existe également pour le Flash. N’hésitez pas à nous le demander en cas de besoin.
Il existe également un marqueur ROI multidevises :
VOTRE SYNTAXE DE MARQUEUR ROI MULTIDEVISES
g=CUMUL&action=ACTION&ptype=TYPE&pbrand=Brand&pref=Ref&nb=Nb&ca=CA&currency_o=DEVISE_
ORIGINE&currency_f=DEVISE_DESTINATION&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />

Paramètres supplémentaires :
DEVISE_ORIGINE : devise courante
DEVISE_DESTINATION : transformer la devise courante en …
Valeurs des devises présentes sur : http://www.xe.com/iso4217.htm
- 18 -
8- Le marquage ROI sécurisé
Syntaxe
VOTRE SYNTAXE DE MARQUEUR ROI SECURISE
<!-var _PJS=0;
//-->
</SCRIPT>
<SCRIPT LANGUAGE="JavaScript" SRC="https://prof.estat.com/js/SERIAL.js"></SCRIPT>
<!-if(_PJS) {
eStat_id.action("ACTION");
eStat_id.typ_prod("TYPE_PRODUIT");
eStat_id.mrq_prod("MARQUE_PRODUIT");
eStat_id.ref_prod("REFERENCE_PRODUIT");
eStat_id.nbr("NOMBRE");
eStat_id.ca_engdr("CA_ENGENDRE");
eStat_id.secur();
eStat_tag.post("ma");
}
//-->
</SCRIPT>
<NOSCRIPT>
g=MASTER&action=ACTION&ptype=TYPE_PRODUIT&pbrand=MARQUE_PRODUIT&pref=REFERENCE_
PRODUIT&nb=NOMBRE&ca=CA_ENGENDRE&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

Cf. définition de ces paramètres au niveau de "7-
Le marquage ROI" : Paramètres du marqueur
Remarques
Pour permettre une analyse ciblée des pages sécurisées des sites marchands, Médiamétrie-eStat a
développé ce marqueur spécifique faisant appel à des serveurs fonctionnant avec le protocole ssl.
+ Cf. remarques présentes au niveau de "7- Le marquage ROI" : Remarques.
- 19 -
Il existe également un marqueur ROI sécurisés multidevises :
VOTRE SYNTAXE DE MARQUEUR ROI SECURISE MULTIDEVISES
g=CUMUL&action=ACTION&ptype=TYPE&pbrand=Brand&pref=Ref&nb=Nb&ca=CA&currency_o=DEVISE_
ORIGINE&currency_f=DEVISE_DESTINATION&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />

Paramètres supplémentaires :
DEVISE_ORIGINE : devise courante
DEVISE_DESTINATION : transformer la devise courante en …
Valeurs des devises présentes sur : http://www.xe.com/iso4217.htm
- 20 -
9- Le marquage ROI dans le cas de paiement externalisé
Paiement externalisé : modification des marqueurs indispensable
Si le paiement en ligne est externalisé vers des plates-formes de prestataires en dehors du site,
Médiamétrie-eStat vous recommande d’adapter les marqueurs de mesure et d’analyse eCommerce tel que
décrit ci-dessous.
Cette adaptation du marqueur va permettre de faire le lien entre le client qui a consulté puis mis en panier
les articles et celui qui a acheté même si ce client a du interrompre sa visite sur le site en étant obligé de
passer par un autre site pour finaliser le paiement.
ETAPE 1 : Modification du marqueur sur les pages qui précèdent l’achat.
La première étape revient à modifier le marqueur sur les pages qui précèdent l’achat et le paiement. Cela
peut couvrir au choix toutes les étapes (visualisation, mise en panier) ou uniquement la dernière étape avant
l’achat soit la mise en panier.
Le marqueur se présente de la façon suivante :
VOTRE SYNTAXE DE MARQUEUR ROI (PAIEMENT EXTERNALISE)
< !-- eStat ROI tag -->
<IMG SRC="http://prof.estat.com/m/web/SERIAL?g=MASTER&action=V ou
P&ptype=TYPE_PRODUIT&pbrand=MARQUE_PRODUIT&pref=REFERENCE_PRODUIT&nb=NOMBRE&c
a=CA_ENGENDRE&cid=ID_CLIENT&st=0&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
< !-- /eStat -->
Commentaires sur le marqueur : le seul changement de ce marqueur par rapport à un marqueur standard
est l'ajout du champ suivant: "cid=ID_CLIENT". Vous devez remplacer ce paramètre avec un numéro
d’identifiant permettant d’identifier de manière unique soit le client, soit le numéro de commande.
ETAPE 2 : La validation d’achat.
A l’étape de la validation d’achat et comme celle-ci est externalisée, il ne faut surtout pas utiliser le marqueur
standard de validation d’achat tel que décrit dans ce manuel.
Lors de l’envoi de la confirmation de la commande par la banque, il faut utiliser le lien suivant ce qui va
permettre de faire un appel vers nos serveurs et donc de mesurer et d’enregistrer que la commande a bien
été validée :
VOTRE SYNTAXE DE MARQUEUR ROI (VALIDATION D'ACHAT)
http://prof.estat.com/m/web/SERIAL?
g=MASTER&action=A&ptype=TYPE_PRODUIT&pbrand=MARQUE_PRODUIT&pref=REFERENCE_PROD
UIT&nb=NOMBRE&ca=CA_ENGENDRE&rcid=ID_CLIENT&st=0&sjs=0
Commentaires sur le marqueur : il faut ajouter le paramètre : "rcid=ID_CLIENT". Vous devez remplacer ce
paramètre avec un numéro d’identifiant permettant d’identifier de manière unique soit le client, soit le numéro
de commande. Il est IMPERATIF que cet identifiant soit le même entre le marqueur d’avant l’achat et le
marqueur de confirmation d’achat. C’est cet identifiant unique qui nous permet de faire le lien entre une
même commande ou client même si celui-ci a du interrompre sa visite sur le site du fait de l’externalisation
du paiement.
- 21 -
10- Le marquage flash
Syntaxe
VOTRE SYNTAXE DE MARQUEUR FLASH
getURL("javascript:eStat_id.pg_mq('PAGE_MARQUEE');eStat_id.gp_pg_mq('GROUPE_PAGES_MARQUE
ES');eStat_tag.post('m');");
Pour implémenter ce marqueur, la ligne suivante doit obligatoirement être insérée dans la partie body :
<script type="text/javascript" src="http://prof.estat.com/js/SERIAL.js"></script>, avant d'insérer votre film
flash :
exemple
<html>
<head>
...
</head>
<body>
<script language="JavaScript">
<!-var _PJS=0;
//-->
</script>
<script type="text/javascript" src=" http://prof.estat.com/js/SERIAL.js "></script>
<!-if(_PJS) {
}
//-->
</script>
...
...
<film flash>
...
</body>
</html>
SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGE_MARQUEE
- 22 -
Remarques
Le marqueur Flash est sans doute le plus souple de tous nos marqueurs, puisqu'il permet de mesurer "tout
et n'importe quoi".
Il faut voir le film flash comme une "timeline" (ou succession de séquences) sur laquelle sont placés
différents éléments.
Boutons, images, films vidéo etc. ...
En sachant que sur chaque élément de la séquence on peut apposer un bout de code pour dire- en arrivant
sur cette séquence faire ceci - en sortant de cette séquence faire cela - en cliquant sur ce bouton lancer tel
le action - etc.
Vous pouvez ainsi placer notre marqueur où vous le souhaitez pour pouvoir suivre toute l'activité de votre
film flash. Il existe cependant une restriction à l'appel de scripts javascript depuis un film flash : il est possible
que seul le dernier appel à getURL() soit pris en compte, si plusieurs appels successifs à cette fonction ont
été effectués de manière rapprochée. Cela est dû au fait que certains navigateurs tels que Internet Explorer,
dans ses versions antérieures à la version 7, appellent getURL() de manière asynchrone. Pour pallier à ce
problème, il est conseillé soit de mettre en place soit:
1. un mécanisme de mise en queue des appels javascript tel que conseillé par Adobe (c.f.
http://www.adobe.com/devnet/flex/articles/analytic_app_05.html )
2. rassembler les fonctions javascript à utiliser dans un seul appel à getURL(), qui est la technique
utilisée dans le marqueur flash
- 23 -
11- Le marquage Wap/I-mode
Syntaxe
VOTRE SYNTAXE DE MARQUEUR WAP/I-MODE

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_id.pg_mq("PAGE_MARQUE");
eStat_id.uid("UID");
eStat_id.alt("estat");
eStat_tag.post("wap");
}
//-->
</SCRIPT>
<NOSCRIPT><img src="http://prof.estat.com/m/wap/SERIAL?
g=MASTER&p=PAGE_MARQUEE&c=GROUPE_PAGES_MARQUEES&u=UID;&n=Un
ChiffreAleatoire" alt="estat" />< />
</NOSCRIPT>

SERIAL
MASTER
PAGE_MARQUEE
GROUPE_PAGES_MARQUEES
- UID : identifiant unique (alphanumérique) du mobinaute fourni par l'opérateur
Remarques
- Le tag 'alt' est obligatoire pour la norme WML.
- 'UnChiffreAleatoire' est à remplacer dynamiquement par un nombre aléatoire si possible.
- Le '&' (séparateur de paramètres) doit être écrit &
- 24 -
12- Le marquage 4 niveaux
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 4 NIVEAUX

<!-var _PJS=0;
//-->
</script>
<SCRIPT LANGUAGE="JavaScript" SRC="http://prof.estat.com/js/SERIAL.js"></script>
<!-if(_PJS) {
eStat_id.niveau(1,"NIVEAU1");
eStat_tag.post("ml");
}
//-->
</script>
<noscript>
g=MASTER&c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4" BORDER="0" WIDTH="1" HEIGHT="1"
/>
</noscript>

-MASTER
-SERIAL
Cf. définition de ces 2 paramètres au niveau de " 1du marqueur
La personnalisation sur 4 niveaux fonctionne de la même façon que sur 2 niveaux, paramètres à changer
librement dans la syntaxe des marqueurs, sauf que celle-ci comporte 2 niveaux supplémentaires.
Pour personnaliser ce marqueur, il est nécessaire d'introduire un libellé sur chacun des 4 niveaux sur les 2
lignes du marqueur où l'on a les paramètres NIVEAU1, NIVEAU2, NIVEAU3 et NIVEAU4.
La hiérarchisation des niveaux est la suivante :
- Niveau 1 correspond à une section,
- Niveau 2 appartient à niveau1 et correspond à une sous-section,
- Niveau 3 appartient aux deux autres niveaux et correspond à un groupe de pages marquées,
- et Niveau 4 appartient aux 3 autres niveaux et correspond à une page marquée.
Remarques
La prise en compte du multi-niveaux nécessite une activation de notre part. Sinon au niveau de l'interface,
seuls deux niveaux vont s'afficher (Le Niveau3 et Le Niveau4). Il est donc indispensable de nous prévenir si
vous souhaitez passer du deux aux quatre niveaux (et inversement).
- 25 -
D’autre part, seul les niveau1 et niveau2 apparaîtront au niveau de l’option eStat’Track. Actuellement, il n’est
pas possible d’avoir les résultats pour les niveaux3 (Groupe de Pages Marquées) et niveau4 (pages
marquées) ce qui fait perdre un peu d’intérêt à cette option lorsque l’on utilise le 4 niveaux.
Si vous consultez la section Contenu vous aurez :
Par Niveau 1 :niveau1
Par Niveau 2 : niveau2 (niveau1)
Par Niveau 3 (Groupe de Pages Marquées) : niveau3 (niveau2 (niveau1))
Par Niveau 4 (Page Marquée) :niveau4 (niveau3 (niveau2 (niveau1)))
Au niveau de l'interface des rapports d'audience, dès qu'un libellé n'est pas personnalisé dans le marqueur,
il sera automatiquement remplacé par le terme "indéterminé" dans les rapports d'audience.
Ce marqueur est à insérer juste avant la balise </body> des pages que vous souhaitez auditer sur votre site.
Attention ! Vous devez strictement respecter cette syntaxe, tant dans son contenu que dans sa disposition
(renvois à la ligne, casse...).
- 26 -
13- Le marquage 4 niveaux sécurisé
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 4 NIVEAUX SECURISE

<!-var _PJS=0;
//-->
</script>
<SCRIPT LANGUAGE="JavaScript" SRC="https://prof.estat.com/js/SERIAL.js"></script>
<!-if(_PJS) {
eStat_id.secur();
}
//-->
</script>
<noscript>
/>
</noscript>

-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
+ Cf. définitions de ces paramètres au niveau de " 12marqueur.
Le marquage 4 niveaux " : Paramètres du
Remarques
Pour permettre l'audition des pages sécurisées, Médiamétrie-eStat a développé ce marqueur spécifique
faisant appel à des serveurs fonctionnant avec le protocole ssl.
Le marquage 4 niveaux" : Remarques.
- 27 -
14- Le marquage 4 niveaux de redirection
Syntaxe
VOTRE SYNTAXE DE MARQUEUR DE REDIRECTION 4 NIVEAUX (PAGE EFFECTUANT LA
REDIRECTION)
#MARQUEUR A PLACER SUR LA PAGE EFFECTUANT LA REDIRECTION
#TAG TO PASTE ON THE PAGE WHICH MAKES THE REDIRECTION

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if (_PJS) eStat_tag.post("sr");
//-->
</SCRIPT>

VOTRE SYNTAXE DE MARQUEUR DE REDIRECTION 4 NIVEAUX (PAGE SUR LAQUELLE
S'EFFECTUE LA REDIRECTION)
#MARQUEUR A PLACER SUR LA PAGE OU S EFFECTUE LA REDIRECTION
#TAG TO PASTE ON THE PAGE WHICH IS THE REDIRECTION GOAL

<!-var _PJS=0;
//-->
</script>
<!-if(_PJS) {
eStat_tag.post("mr4");
}
//-->
</script>
<noscript>
/>
</noscript>

- 28 -
-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
Remarques
Il y a donc deux marqueurs à placer. Seul le second a des paramètres à renseigner.
Le marqueur de redirection est nécessaire lorsque "une page web renvoie automatiquement l'internaute vers
une autre page web" .
Il faut dans ce cas placer un marqueur sur la "page qui renvoie" et un marqueur sur la "page qui reçoit".
Si ces derniers ne sont pas uitlisés, la provenance est alors perdue. On considère que le visiteur vient de
la "page qui renvoie" au lieu de venir du moteur de recherche Google par exemple.
- 29 -
15- Le marquage 4 niveaux frame
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 4 NIVEAUX FRAME

<!-var _PJS=0;
//-->
</script>
<!-if(_PJS) {
eStat_tag.post("mf4");
}
//-->
</script>
<noscript>
g=MASTER&c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4" WIDTH="1" HEIGHT="1" />
</noscript>

-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
Remarques
Si vous utilisez un marqueur standard au lieu d'un marqueur frame alors que votre site contient des frames
(cadre) : les provenances sont perdues.
Le marquage 4 niveaux" : Remarques
- 30 -
16- Le marquage 4 niveaux XHTML1.1
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 4 NIVEAUX XHTML 1.1

<!-var _PJS=0;
//-->
</script>
<!-if(_PJS) {
}
//-->
</script>
<noscript>
<div>
<img src="http://prof.estat.com/m/web/SERIAL?
g=MASTER&c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4&st=0&sjs
=0" width="1" height="1" alt="eStat Pro" />
</div>
</noscript>

-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
Remarques
Ce marqueur respecte la norme XHTML 1.1 .
- 31 -
17- Le marquage 4 niveaux multicritères
Syntaxe
VOTRE SYNTAXE DE MARQUEUR 4 NIVEAUX MULTICRITERES

<script LANGUAGE="JavaScript">
<!-var _PJS=0;
//-->
</SCRIPT>
<script LANGUAGE="JavaScript" SRC="http://prof.estat.com/js/SERIAL.js"></SCRIPT>
<script LANGUAGE="JavaScript">
<!-if(_PJS) {
eStat_tag.post("mmcml");
}
//-->
</SCRIPT>

-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
Jusqu'à 5 critères d'analyses disponibles dans le marqueur indépendants des paramètres d'analyses du
contenu et qui peuvent être croisées entre eux.
- Les paramètres 'CRITERE1','CRITERE2','CRITERE3','CRITERE4','CRITERE5'. Les CRITERE1 à
CRITERE4 correspondent aux différents critères de recherche entrés par l'utilisateur et le CRITERE5 vaut 1
ou 0, selon si la requête a donné un résultat ou non.
Remarques
En plus de mesurer la fréquentation, ce marqueur vous permet d’analyser les informations enregistrées sur
vos moteurs de recherche interne et vos formulaires en ligne.
- 32 -
18- Le marquage Flash 4 niveaux
Syntaxe
VOTRE SYNTAXE DE MARQUEUR FLASH 4 NIVEAUX
getURL("javascript:eStat_id.niveau(1,'NIVEAU1');eStat_id.niveau(2,'NIVEAU2');eStat_id.niveau(3,'NIVEAU3'
);eStat_id.niveau(4,'NIVEAU4');eStat_tag.post('ml');");
Pour implémenter ce marqueur, la ligne suivante doit obligatoirement être insérée dans la partie body :
<script type="text/javascript" src="http://prof.estat.com/js/SERIAL.js"></script>, avant d'insérer votre film
flash :
exemple
<html>
<head>
...
</head>
<body>
<!-var _PJS=0;
//-->
</script>
<script type="text/javascript" src=" http://prof.estat.com/js/SERIAL.js "></script>
<!-if(_PJS) {
}
//-->
</script>
...
...
<film flash>
...
</body>
</html>
-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
Remarques
Le marqueur Flash est sans doute le plus souple de tous nos marqueurs, puisqu'il permet de mesurer "tout
et n'importe quoi".
Il faut voir le film flash comme une "timeline" (ou succession de séquences) sur laquelle sont placés
différents éléments.
- 33 -
Boutons, images, films vidéo etc. ...
En sachant que sur chaque élément de la séquence on peut apposer un bout de code pour dire- en arrivant
sur cette séquence faire ceci - en sortant de cette séquence faire cela - en cliquant sur ce bouton lancer tel
le action - etc.
Vous pouvez ainsi placer notre marqueur où vous le souhaitez pour pouvoir suivre toute l'activité de votre
film flash. Il existe cependant une restriction à l'appel de scripts javascript depuis un film flash : il est possible
que seul le dernier appel à getURL() soit pris en compte, si plusieurs appels successifs à cette fonction ont
été effectués de manière rapprochée. Cela est dû au fait que certains navigateurs tels que Internet Explorer,
dans ses versions antérieures à la version 7, appellent getURL() de manière asynchrone. Pour pallier à ce
problème, il est conseillé soit de mettre en place soit:
1. un mécanisme de mise en queue des appels javascript tel que conseillé par Adobe (c.f.
http://www.adobe.com/devnet/flex/articles/analytic_app_05.html )
2. rassembler les fonctions javascript à utiliser dans un seul appel à getURL(), qui est la
technique utilisée dans le marqueur flash
- 34 -
19- Le marquage Wap/I-mode 4 niveaux
Syntaxe
VOTRE SYNTAXE DE MARQUEUR WAP/I-MODE 4 NIVEAUX

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_id.uid("UID");
eStat_id.alt("estat");
eStat_tag.post("wapl");
}
//-->
</SCRIPT>
<NOSCRIPT>
<img src="http://prof.estat.com/m/wap/SERIAL?
g=MASTER&c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4&u=UID;&
n=UnChiffreAleatoire" alt="estat" />< />
</NOSCRIPT>

-MASTER
-SERIAL
-NIVEAU1
-NIVEAU2
-NIVEAU3
-NIVEAU4
- UID : identifiant unique (alphanumérique) du mobinaute fourni par l'opérateur
Remarques
- Le tag 'alt' est obligatoire pour la norme WML.
- 'UnChiffreAleatoire' est à remplacer dynamiquement par un nombre aléatoire si possible.
- Le '&' (séparateur de paramètres) doit être écrit &
- 35 -
20- Le marquage Streaming
Principe de fonctionnement de la mesure du streaming
Le marqueur unique permet également de mesurer la fréquentation des flux audio et/ou vidéo streamés. Le
principe est le suivant : La page HTML permettant de diffuser un contenu audio et/ou vidéo doit contenir le
marqueur Médiamétrie-eStat qui permet de mesurer le trafic du streaming et du site web.
Le marqueur Médiamétrie-eStat pour le
streaming est directement dans la page
web.
Une action sur le flux streamé va
déclencher la mesure.
Figure 1 – Exemple : Fonctionnement Général
Syntaxe
Médiamétrie-eStat mesure et collecte les
données concernant la consommation du flux
streamé par les internautes ainsi que la
fréquentation Internet.
VOTRE SYNTAXE DE MARQUEUR STREAMING

<!-var _PJS=0;
var _cmsJS=0;
//-->
</script>
<SCRIPT LANGUAGE="JavaScript"
SRC=" http://prof.estat.com/js/SERIAL.js "></script>
<script language="javascript">
<!-if (_PJS) {
eStat_tag.post('cms');
if (_cmsJS) {
/* Windows Media Player */
eStat_WMPReference(playerObject, 'video_name', 'video_section1_name', 'video_section2_name');
/* ou Real Media Player */
eStat_RealReference(playerObject, 'video_name', 'video_section1_name', 'video_section2_name');
/* ou Quicktime Player */
eStat_QTReference(playerObject, 'video_name', 'video_section1_name', 'video_section2_name');
/* ou Flash Player */
eStat_FlashReference(playerObject, 'video_name', 'video_section1_name', 'video_section2_name');
}
}
//-->
</script>

Il est également possible d'utiliser plusieurs players simultanément :
- 36 -
VOTRE SYNTAXE DE MARQUEUR STREAMING AVEC PLUSIEURS PLAYERS

<!-var _PJS=0;
var _cmsJS=0;
//-->
</script>
<!-if (_PJS) {
if (_cmsJS) {
/* Windows Media Player 1*/
eStat_WMPReference(playerObject1,'video1_name','video1_section1_name','video1_section2_name');
/* ou Real Media Player 1*/
eStat_RealReference(playerObject1, 'video1_name','video1_section1_name','video1_section2_name');
/* ou Quicktime Player 1*/
eStat_QTReference(playerObject1, 'video1_name', 'video1_section1_name', 'video1_section2_name');
/* ou Flash Player 1*/
eStat_FlashReference(playerObject1,'video1_name','video1_section1_name','video1_section2_name');
/* Windows Media Player 2*/
eStat_WMPReference(playerObject2,'video2_name','video2_section1_name','video2_section2_name');
/* ou Real Media Player 2*/
eStat_RealReference(playerObject2, 'video2_name','video2_section1_name','video2_section2_name');
/* ou Quicktime Player 2*/
eStat_QTReference(playerObject2, 'video2_name', 'video2_section1_name', 'video2_section2_name');
/* ou Flash Player 2*/
eStat_FlashReference(playerObject2,'video1_name','video2_section1_name','video2_section2_name');
…
/* Windows Media Player N*/
eStat_WMPReference(playerObjectN,'videoN_name','videoN_section1_name','videoN_section2_name');
/* ou Real Media Player N*/
eStat_RealReference(playerObjectN,'videoN_name','videoN_section1_name','videoN_section2_name');
/* ou Quicktime Player N*/
eStat_QTReference(playerObjectN, 'videoN_name','videoN_section1_name','videoN_section2_name');
/* ou Flash Player N*/
eStat_FlashReference(playerObjectN,'videoN_name','videoN_section1_name','videoN_section2_name');
}
}
//-->
</script>

Il est OBLIGATOIRE de personnaliser le paramètre de la Rubrique, afin que la comptabilisation de
votre fréquentation soit la plus fiable possible.
- 37 -
Le marqueur met à votre disposition deux variables pour la mesure et l’analyse de la fréquentation Web :
PAGE_MARQUEE et GROUPE_PAGES_MARQUEES. Lorsque vous renseignez ces variables, les noms
choisis ne doivent pas excéder 64 caractères. Ils ne doivent comporter que des tirets ('-' ou '_') et les
caractères de ‘0’ à ‘9’ et de ‘a’ à ‘z’ ( ou ‘A’ à ‘Z’ ). Leur interprétation est sensible à la casse, c’est à dire que
la page marquée "Accueil" est différente de la page marquée "ACCUEIL", elle-même différente de "accueil".
Le nom du groupe de pages marquées doit être un libellé simple qui correspond au premier niveau de
contenu du site.
En ce qui concerne le paramètre de la page marquée, nous vous conseillons d’utiliser les séparateurs de
type ('-' ou '_') pour séparer plusieurs niveaux de contenus.
Cas des Players Windows Media
Pour chaque Player Windows Media présent dans la page, un appel à la fonction eStat_WMPReference doit
être réalisé, avec les paramètres suivants :
•
•
•
•
playerObject doit être l'objet javascript correspondant au Player,
video_name est le nom de la vidéo (à personnaliser) : ce paramètre est OBLIGATOIRE,
video_section1_name - est le nom de la section de niveau 1 à laquelle appartient la vidéo (à
personnaliser) : ce paramètre n’est pas obligatoire mais fortement recommandé,
video_section2_name est le nom de la section de niveau 2 à laquelle appartient la vidéo (à
personnaliser) : ce paramètre n’est pas obligatoire mais fortement recommandé.
NOTE : ces deux derniers paramètres ne sont pas encore activés mais ils ont été ajoutés au marqueur afin
de vous éviter un retaggage lorsque la fonctionnalité sera mise en ligne.
Le premier paramètre est obligatoire et doit être différent pour chaque appel. Les autres paramètres sont
optionnels et ils peuvent prendre des valeurs différentes.
Nous vous conseillons toutefois de renseigner tous les paramètres vous permettant de personnaliser vos
vidéos ce qui facilitera ensuite vos analyses depuis l’interface.
Cas des Players Flash
Préambule : le marqueur Flash est compatible avec les players compilés en Flash 8 (ou supérieur) utilisant
ActionScript 2.0 (ou supérieur)
Le marqueur se décompose en deux parties :
1. le code JavaScript dans la page HTML contenant votre player Flash
2. le code ActionScript à intégrer dans votre player Flash
Le code :
1. Code JavaScript
Pour chaque Player Flash présent dans la page, un appel à la fonction eStat_FlashReference doit
être réalisé, avec les paramètres suivants :
• playerObject doit être l'objet javascript correspondant au Player
•
video_name est le nom de la vidéo
•
video_section1_name - est le nom de la section de niveau 1 à laquelle appartient la vidéo
•
video_section2_name est le nom de la section de niveau 2 à laquelle appartient la vidéo
- 38 -
2. Code ActionScript
Code à ajouter dans le code flash du player :
•
Trois variables à personnaliser :
/* ID correspondant a l’objet HTML du player */
_global.eStat_html_player_id = "your_player_id";
/* Objet NetStream correspondant aux flux a mesurer */
_global.eStat_NetStream = your_NetStream_object;
/* Variable a mettre a jour lors d’un changement de flux
e.g.: appel de la methode open de l’objet NetStream */
_global.eStat_media_url = "your_stream_url";
•
Suite du marqueur ActionScript :
/* Variable a usage interne au marqueur */
_global.eStat_previous_status = "";
/* Appel au marqueur JavaScript */
_global.eStat_call = function( html_player_id : String,
status_code : String,
position : Number,
version : String,
media_url : String,
media_duration : Number,
event_type : String ) {
getURL( "javascript:eStat_Flash(" +
"document.getElementById('" + html_player_id + "')," +
"'" + status_code + "'," +
"'" + position + "'," +
"'" + version + "'," +
"'" + media_url + "'," +
"'" + media_duration + "'," +
"'" + event_type + "');" );
};
_global.eStat_NetStream.onMetaData = function( infoObject : Object ) {
_global.eStat_media_duration = infoObject.duration;
/* Appelez votre callback onMetaData ici, si necessaire */
};
_global.eStat_NetStream.onStatus = function(infoObject : Object):Void {
_global.eStat_call( _global.eStat_html_player_id,
infoObject.code,
_global.eStat_NetStream.time,
System.capabilities.version,
_global.eStat_media_url,
_global.eStat_media_duration,
"state" );
_global.eStat_previous_status = infoObject.code;
/* Appelez votre callback onStatus ici, si necessaire */
};
setInterval( function() {
_global.eStat_call( _global.eStat_html_player_id,
_global.eStat_previous_status,
_global.eStat_NetStream.time,
- 39 -
System.capabilities.version,
_global.eStat_media_url,
_global.eStat_media_duration,
"polling" );
}, 60 * 1000 );
Cas des Players Quicktime
Il existe deux types de mesure : soit ce sont les actions de l’internaute sur le player qui vont déclencher les
mesures (méthode événementielle), soit les mesures sont lancées sur des intervalles de temps régulier quel
que soit l’état du player associé (méthode périodique). Pour les players Quicktime, seule la seconde
méthode est possible.
Le marqueur fonctionne pour les players QuickTime réalise en effet un appel à la fonction
eStat_QTReference qui présente une particularité. L'appel à cette fonction va démarrer une mesure
périodique, et toutes les 2 secondes, une nouvelle mesure va être effectuée et ceci quel que soit l'état du
player associé.
Toutefois, il est aussi possible de contrôler manuellement le début et la fin de la mesure.
Dans ce cas, l'appel à la fonction eStat_QTReference est à remplacer par un appel à la fonction
eStat_QTReferenceNoAuto, toujours pour chaque player Quicktime à mesurer.
Le début de la mesure est alors déclenché lors d'un appel à la fonction eStat_QTStartMeasure. On peut de
plus spécifier la fin de la mesure par un appel à la fonction eStat_QTStopMeasure.
Ces deux fonctions n'ont qu'un seul paramètre, obligatoire, qui est l'objet javascript du player QuickTime. Il
s'agit du même paramètre que celui utilisé pour eStat_QTReference ou eStat_QTReferenceNoAuto.
Il est à noter que les fonctions eStat_QTStopMeasure et eStat_QTStartMeasure peuvent être utilisées
même dans le cas d'un démarrage automatique de la mesure, si besoin.
Ces fonctionnalités permettent d'interfacer la mesure QuickTime avec une éventuelle application Javascript
contrôlant la lecture des vidéos, évitant dans une certaine mesure d'effectuer trop de mesures inutiles
pouvant gêner l'internaute.
Cas des autres Players
On opère de la même façon pour les players Real Media, mais avec un appel à la fonction
eStat_RealReference.
Remarque : Pour référencer l'objet Javascript du ou des players à auditer, on peut très souvent
simplement utiliser la directive Javascript: document.playerId, où playerId est à remplacer par la
valeur du paramètre id de la balise html object ou embed. Cette méthode fonctionne sur la majorité
des plateformes supportées par le marqueur de mesure de flux.
Intégration de players dans vos pages HTML
Pour identifier un player présent dans vos pages HTML, le marqueur se base à la fois sur l’objet javascript
de ce player et sur l’attribut NAME de cet objet. Ainsi, lorsque vous insérez un player dans une page, vous
devez spécifier un champ NAME dans la déclaration de l’objet correspondant.
DECLARATION DE L’OBJET CORRESPONDANT AU PLAYER
<OBJECT
ID="your_id"
CLASSID="your_classid" 
NAME="your_name"
…
- 40 -
Intégration de plusieurs players sur une même page
Sur l’ensemble de la page, les valeurs des différents attributs NAME et ID doivent être distinctes.
Comment ajouter des callbacks personnelles (utilisation avancee du
marqueur)
Qu’est-ce qu’une callback :
Une callback est une fonction personnelle que vous pouvez faire appeler par le player jouant un flux streamé
lors d’un événement bien précis. Par exemple si vous souhaitez afficher un message lors d’un clic sur le
bouton stop du player, il faudra utiliser une callback.
Médiamétrie-eStat vous offre la possibilité d’appeler vos callbacks personnelles. Il est donc possible
d’appeler le marqueur tout en lui spécifiant la fonction qu’il devra appeler à son tour si l’état du player change
(stop, pause, play …) et la fonction qu’il devra appeler s’il advient un changement de position dans le flux
streamé. Cette fonctionnalité est disponible pour Windows Media Player, pour Real Player.
En ce qui concerne le Flash, cette fonctionnalité étant déjà disponible de façon implicite dans le code action
script, merci de se référer aux pages concernant le marquage Flash.
Schéma de fonctionnement :
Appel au marqueur standard
Appel au marqueur avec callback
Page Web
Page Web
Appel
<script…>
…
myCallback()
…
</script>
Marqueur
Exécution de
votre code
2
Appel
Mesure
Marqueur
1
Mesure
Utilisation
Pour pouvoir utiliser les callbacks personnelles, l’appel au marqueur doit être fait avec les fonctions d’appel
au marqueur dites ‘avec callback’ et non plus avec les fonctions d’appel au marqueur standard. Pour
Windows Media Player il faudra donc utiliser la fonction d’appel eStat_WMPReferenceWithCallBack() à la
place de eStat_WMPReference() et pour RealPlayer il faudra utiliser la fonction d’appel
eStat_RealReferenceWithCallBack() à la place de eStat_RealReference();
Les fonctions eStat_WMPReferenceWithCallBack() et eStat_RealReferenceWithCallBack() sont semblables
aux fonctions eStat_WMPReference() et eStat_RealReference(), mais elles permettent de spécifier au
marqueur les fonctions utilisateur (callbacks) à appeler en plus de l’exécution de la mesure standard.
- 41 -
- 42 -
Les appels aux fonctions permettant l’utilisation des callback personnelles cmWMPReferenceWithCallBack()
et cmRealReferenceWithCallBack() doivent être faits avec les paramètres suivants :
-
•
•
•
playerObject doit être l'objet javascript correspondant au Player,
•
video_section2_name est le nom de la section de niveau 2 à laquelle appartient la vidéo (ce
paramètre n’est pas obligatoire mais fortement recommandé)
video_name est le nom de la vidéo. (Ce paramètre est OBLIGATOIRE),
video_section1_name est le nom de la section de niveau 1 à laquelle appartient la vidéo (ce
paramètre n’est pas obligatoire mais fortement recommandé),
(Ces 4 premiers paramètres sont les mêmes que pour les appels aux
fonctions standard du
marqueur)
•
-
stateChangeCallBack(param) représente l’appel à la callback qui sera exécuté lors d’un
changement d’état. Ce paramètre peut être une chaîne vide (pas de callback).
* positionChangeCallBack(params) représente l’appel à la callback qui sera exécuté lors d’un
changement de position dans le flux streamé. Ce paramètre peut être une chaîne vide (pas de
callback).
(Pour plus de détails veuillez vous référer à l’exemple ci-après)
VOTRE SYNTAXE DE MARQUEUR STREAMING AVEC CALLBACKS

<!-var _PJS=0;
var _cmsJS=0;
//-->
</script>
<!-if (_PJS) {
eStat_id.serial("SERIAL"); // personnalisation OBLIGATOIRE
if (_cmsJS) {
/* Windows Media Player */
eStat_WMPReferenceWithCallBack(playerObject,
'video_name',
'video_section1_name',
'stateChangeCallBack(param)',
'positionChangeCallBack(params)');
/* ou Real Media Player */
eStat_RealReference(playerObject,
'video_name',
'stateChangeCallBack(param)',
'positionChangeCallBack(params)');
}
}
//-->
</script>

- 43 -
Comme décrit plus haut, il est possible de mesurer plusieurs flux sur une même page. Avec les fonctions
d’appel au marqueur avec callback, on peut en plus spécifier, pour chacun des players, les callbacks à
appeler en cas d’événement. Pour cela il suffit d’effectuer plusieurs appels aux fonctions
eStat_WMPReferenceWithCallBack() ou eStat_RealReferenceWithCallBack() pour chacun des N objets
javascript correspondant à chaque Player avec les callbacks associées.
VOTRE SYNTAXE DE MARQUEUR STREAMING AVEC CALLBACKS POUR PLUSIEURS PLAYERS

<!-var _PJS=0;
var _cmsJS=0;
//-->
</script>
<!-if (_PJS) {
eStat_id.serial("SERIAL"); // personnalisation OBLIGATOIRE
if (_cmsJS) {
/* Windows Media Player 1 */
eStat_WMPReferenceWithCallBack(playerObject1,
'video_name1',
'video1_section1_name',
'stateChangeCallBack1(param)',
'positionChangeCallBack1(params)');
/* ou Real Media Player 1 */
eStat_RealReference(playerObject1,
'video_name1',
/* Windows Media Player 2 */
eStat_WMPReferenceWithCallBack(playerObject2,
'video_name2',
/* ou Real Media Player 2 */
eStat_RealReference(playerObject2,
'video_name2',
… etc.
}
}
//-->
</script>
- 44 -

Exemple d’utilisation de callbacks
L’exemple suivant met en avant l’utilisation des callbacks personnalisées. Dans cet exemple on souhaite
afficher dans une zone de texte l’état et la position du player :
EXEMPLE D'UTILISATION DU MARQUEUR STREAMING AVEC CALLBACK
<HTML>
<BODY>

<OBJECT
ID="myVideoID"
NAME="myVideoNAME"
CLASSID="CLSID:6BF52A52-394A-11D3-B153-00C04F79FAA6"
WIDTH="320" HEIGHT="302" TYPE="application/x-oleobject">
<PARAM NAME="AutoStart" VALUE="false">
<PARAM NAME="SRC" VALUE="test.mpeg">
<PARAM NAME="URL" VALUE="test.mpeg">
<EMBED TYPE="application/x-mplayer2"
PLUGINSPAGE="http://www.microsoft.com/isapi/redir.dll?prd=windows&sbp=mediaplayer&ar=Media&sba=Plugin&"
NAME="playerObjectWMP" SRC="test.mpeg"
WIDTH="320" HEIGHT="302" ShowControls="1" ShowDisplay="0" ShowStatusBar="0">
</EMBED>
</OBJECT>
< !-- Sur l’ensemble de la page, les valeurs des attributs NAME et ID doivent être distinctes. //-->
<BR>
<TEXTAREA NAME=mytextarea1 COLS=78 ROWS=15></TEXTAREA>
…

function WM_onPlayStateChange_cb(playerObject){
// … CODE PERSO … (changement d’état)
mytextarea1.value += '[WMPlayer] playstate:' + playerObject.playState + '\n';
}
function WM_onPositionChange_cb(playerObject){
// … CODE PERSO … (changement de position)
mytextarea1.value += '[WMPlayer] new:' + parseInt(playerObject.currentPosition,10) + '\n';
}
</script>
…

<script language="Javascript">
<!—
var _PJS=0;
var _cmJS=0;
//-->
</script>
<!-if (_PJS) {
if (_cmsJS) {
/* Windows Media Player With CallBack */
cmWMPReferenceWithCallBack(document.getElementById('myVideoID'),
'video_test',
'my_section1',
'my_section2',
'WM_onPlayStateChange_cb(document.getElementById('myVideoID'))',
'WM_onPositionChange_cb(document.getElementById('myVideoID'))' );
}
//-->
</script>
</BODY>
</HTML>
- 45 -
Compatibilité avec les applications
Le tableau ci-dessous fait un bilan de la compatibilité du marqueur avec les différentes applications de
streaming.
Pour rappel, il existe deux types de mesure : soit ce sont les actions de l’internaute sur le player qui vont
déclencher les mesures (méthode événementielle), soit les mesures sont lancées sur des intervalles de
temps régulier quel que soit l’état du player associé (méthode périodique).
Player
Compatible avec le
marqueur
Méthode
Compatible avec les
callbacks
personnelles
OUI
Windows Media
Player
OUI
Real Audio-Vidéo
OUI
Evènementielle
+
Périodique
Evènementielle
QuickTime
OUI
Périodique
NON
Flash 8
ActionScript 2.0
ou supérieur
OUI
Evènementielle
+
Périodique
OUI
OUI
Remarque : Le marqueur est compatible avec l’ensemble des navigateurs sauf pour FireFox. Ce dernier
n’étant pas compatible nativement avec la technologie ActiveX, le marqueur de streaming ne peut donc pas
fonctionner correctement. Aucune mesure ne sera enregistrée pour ce navigateur sauf si un plug-in de
support des ActiveX a été préalablement installé sur la version de FireFox utilisée par l’internaute.
Indicateurs disponibles
•
Durée totale de visualisation et de visualisation significative (au total, par paramètres de
vidéo et par Url),
•
Nombre total de visualisations et de visualisations significatives (au total, par paramètres de
vidéo et par Url)
•
Durée moyenne de visualisation (au total, par paramètres de vidéo et par Url),
•
Lien entre la fréquentation des flux streamés et les pages du site sur lesquelles les vidéos
sont lancées (par Section, par Rubrique).
•
Temps de visualisation (vitesse normale)
•
Temps de visualisation (vitesses accélérées, ralenties, retours)
•
Courbe d’audience au sein de la vidéo
•
Notion de qualité
•
Equipement utilisé …
Définitions
Visualisation : Action de consommation d’un flux défini par l’ouverture et la fermeture
flux. Une visualisation est comptabilisée dès lors qu’est atteinte l’url du flux.
du
Durée de visualisation : Correspond à la durée de lecture du flux en vitesse normale
secondes).
(en
Nombre de visualisations : Nombre de fois où un flux est lu.
Nombre de visualisations significatives : Nombre de fois où un flux est lu et où le
temps de visualisation est supérieur à 0 seconde.
- 46 -
21- Option de segmentation
L'option de segmentation vous offre la possibilité d'ajouter dans le marqueur de vos pages (quelque soit le
marqueur utilisé) 5 paramètres de segmentation libres. Ces paramètres vous permettront de définir 5
variables utilisateur qui pourront faire l'objet d'une segmentation par le biais de l'interface de consultation des
rapports (cf documentation du produit de segmentation).
Syntaxe
L'ajout de ces 5 variables de segmentation passe par l'insertion dans votre marqueur de la ligne
suivante : eStat_seg.set("variable_1","variable_2","variable_3","variable_4","variable_5");
Voici ci-dessous un exemple d'ajout de segmentation sur un marqueur 2 niveaux standard:
EXEMPLE DE SEGMENTATION SUR UN MARQUEUR 2 NIVEAUX STANDARD

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_seg.set("SEGMENTATION1","SEGMENTATION2","SEGMENTATION3,SEGMENTATION4,SEG
MENTATION5");
}
//-->
</SCRIPT>
<NOSCRIPT>
g=MASTER&p=PAGE_MARQUEE&c=GROUPE_PAGES_MARQUEES&st=0&seg1="SEGMENTATION1"&
seg2="SEGMENTATION2"&seg3="SEGMENTATION3"&seg4="SEGMENTATION4"&seg5="SEGMENTATI
ON5"&sjs=0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

Paramètres de l'option des marqueurs
-Les paramètres SEGMENTATION1, SEGMENTATION2, SEGMENTATION3, SEGMENTATION4, et
SEGMENTATION5, représentent vos 5 variables utilisateur qui pourront ensuite faire l'objet d'une
segmentation par le biais de l'interface de consultation des rapports.
L'option de segmentation permet de plus d'effectuer une segmentation sur plusieurs autres paramètres tels
que l'IP de l'internaute, l'heure,le système d'exploitation,le navigateur etc., paramètres qui ne demandent pas
de taggage particulier sur votre page.
(cf documentation du produit de segmentation).
- 47 -
22- Option de crmID
L'option de crmID vous offre la possibilité d'ajouter dans le marqueur de vos pages (quelque soit le marqueur
utilisé) 1 paramètre libre. Il vous permettra de filtrer les lignes correspondantes à votre Serial afin d'obtenir
uniquement les données d'une sous-population comprenant ce paramètre.
Syntaxe
L'ajout de cette variable passe par l'insertion dans votre marqueur de la ligne suivante :
eStat_crm.set("variable_id");
Voici ci-dessous un exemple d'ajout de crmID sur un marqueur 2 niveaux standard:
EXEMPLE DE SEGMENTATION SUR UN MARQUEUR 2 NIVEAUX STANDARD

<!-var _PJS=0;
//-->
</SCRIPT>
<!-if(_PJS) {
eStat_crm.set("VARIABLE_ID");
}
//-->
</SCRIPT>
<NOSCRIPT>
g=MASTER&p=PAGE_MARQUEE&c=GROUPE_PAGES_MARQUEES&st=0&crmID="VARIABLE_ID"&sjs=
0" BORDER="0" WIDTH="1" HEIGHT="1" />
</NOSCRIPT>

- 48 -
23- Le mode de vérification du marqueur
Il existe un mode qui permet de faire remonter les erreurs et avertissements afin de tester la mise en place
d'un marqueur. L'activation de ce mode se fait en ajoutant la commande suivante dans le code source de la
page, avant l'appel à la fonction eStat_tag.post():
eStat_tag.debug();
Une fois ce mode activé, les informations ne seront plus envoyées au serveur de mesure, et une image sera
affichée pour indiquer si oui ou non le marquage s'est bien déroulé. La couleur de cette image dépend du
niveau de gravité des erreurs de marquage :
•
•
•
•
bleue aucune gravité
jaune caractérise un manque d'informations
rouge caractérise un manque d'informations qui aura une influence néfaste sur la mesure
noire indique que le marqueur ne peut fonctionner correctement
En passant la souris sur l'image générée, il est également possible d'avoir un texte présentant la description
de l'erreur et des avertissements obtenus. Dès lors que les renseignements du marqueur sont correctement
mis en place et que la couleur de l'image est bleue, il ne reste plus qu'à supprimer l'appel à la fonction de
vérification pour que la mesure soit effectivement prise en compte.
- 49 -

Guide d`installation du marqueur unique

Transcription

Documents pareils

Cliquez ici pour consulter le communiqué de presse

consulter le Communiqué de Presse des solutions web

script - Girardin, Brigitte

Manuel utilisateur Web Service

ACTIVITE 15 : CREER UN JEU DE POISSON SUR SCRATCH ( en

Prix hit! - Quincaillerie Jaccard SA

Tutoriel : Javascript | Catégorie : Divers | Ecrit par Mathieusub le 16

Programmation de scripts pour la simulation de scénarios

TP n°1 : javascript