EURECA tag
Un article de Eulerian Support.
Contexte
Ce marqueur est le marqueur générique du système EUreca.
Syntaxe
Implémentation rapide
Pour une implémentation simple et rapide de la solution EUreca sur votre site, il suffit de poser le code suivant sur toutes les pages de votre site :
<script type="text/javascript" src="/eureca.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('<IDENTIFIANT_SITE>');
/*]]>*/
</script>
Paramétres
- <IDENTIFIANT_SITE>, obligatoire, correspond à l'identifiant de votre site dans EUreca.
Exemple pour une page du site ayant l'identifiant demo :
<html>
<head>
<title>Page test</title>
</head>
<body>
Texte de ma page et tout le code html qui suit ...
..................................................
..................................................
..................................................
..................................................
<script type="text/javascript" src="/eureca.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('demo');
/*]]>*/
</script>
</body>
</html>
Syntaxe générique
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('<IDENTIFIANT_SITE>');
/*]]>*/
</script>
Paramétres
- <IDENTIFIANT_SITE>, obligatoire, correspond à l'identifiant de votre site dans EUreca.
Exemple
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('test');
/*]]>*/
</script>
Syntaxe spécifique
Cette syntaxe est à utiliser dans le cas où vous souhaitez fournir des noms de pages personalisés.
Il est conseillé de l'utiliser dans le cas de sites dynamiques ou sur des sites générant des urls dynamiques contenant des paramètres de session.
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('<IDENTIFIANT_SITE>', '<NOM_DE_LA_PAGE>');
/*]]>*/
</script>
Paramétres
- <IDENTIFIANT_SITE>, obligatoire, correspond à l'identifiant de votre site dans EUreca.
- <NOM_DE_LA_PAGE>, (optionnel) : le nom de la page courante peut-être forcé (par défaut l'url de la page est utilisée), une arborescence infinie est définissable en fournissant des noms de page séparés par des /
Exemple : pour spécifier la page /rubrique1/sous-rubrique2/page4
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('test', '/rubrique1/sous-rubrique2/page4');
/*]]>*/
</script>
Implémentation
- Le site doit être déclaré dans le système EUreca.
- L'appel à la librairie JavaScript EUreca est obligatoire.
- Le marqueur doit apparaître une seule fois sur une même page.
- Le marqueur doit être placé de préférence avant tous les autres appels de fonction EURECA.
- Il est conseillé de poser ce marqueur en bas de page juste avant la balise de fermeture du corps du document </body> de chaque page html de votre site.
- Assurez-vous que d'autres appels Javascript présents sur la page n'interfére pas avec l'appel au marqueur EUreca empêchant son exécution.
Données collectées
Ce marqueur collecte toutes les données site-centric de mesure d'audience du site et s'occupe de l'affectation du canal de provenance (pour les canaux non-payants) du trafic généré par votre site.
Remarques
Plusieurs EURECA_tag sont présents sur la même page
Seul le premier appel sera exécuté, les appels suivants seront ignorés.
Il est cependant préferable pour la maintenabilité du marquage et la lisibilité du code source de la page, de poser un et un seul marqueur sur une même page. Si vous souhaitez réaliser des appels multiples sur une même page, merci d'utiliser le marqueur [[EURECA_tagmulti]].
L'événement onerror
Dans certains cas, il est possible que les variables déclarées dans la librairie eureca.js entre en conflit avec d'autres variables déclarées dans la page. Ceci peut avoir comme effet de générer des erreurs JavaScript.
Afin d'éviter que ces erreurs ne gênent les internautes, la librarie JavaScript EUreca intercepte ces erreurs en spécifiant une fonction vide lorsque le navigateur déclenche l'événément onerror.
Si un événement onerror a été déclaré au préalable, cet événement est sauvegardé afin d'être exécuté après l'appel au marqueur EUreca.
Compatibilité XHTML1.0 Strict & HTML 4.01
Le code du marqueur générique ainsi que tous les autres appels JavaScript fournis sont compatibles XHTML 1.0 Strict et HTML 4.01.
Gestion des paramétres dynamiques
Dans le cas où votre site utilise toujours la même page mais change le contenu via un passage de paramétre, il est impératif que le nom de la page courante soit fournie au marqueur EURECA_tag afin que les pages puissent être dissociées entre elles.
Par exemple si vous avez un site architecturé de la façon suivante :
Et que vous ne spécifiez pas le nom de la page dans le marqueur EURECA_tag, alors seule la page index.php apparaîtra dans les reportings, il n'y aura pas de dissociation effectuée via les paramétres.
Mode ROI
Si vous souhaitez uniquement utiliser EUreca pour mesurer votre ROI et votre performance marketing il n'est pas nécessaire de poser le marqueur EURECA_tag sur toutes les pages de votre site.
Vous aurez toutes les informations liées aux canaux marketing que vous trackez, mais vous n'aurez pas d'informations liées aux canaux non-payants : branding, référencement naturel, référants, etc ...
Utiliser de préférence la syntaxe spécifique
Il est fortement conseillé d'utiliser la syntaxe spécifique car cela vous permettra de conserver les mêmes noms de pages quelle que soit l'adresse de la page, adresses susceptibles de changer suite à une migration.
Prenons le cas de la page courante : http://support.eulerian.com/index.php/EURECA_tag , sans syntaxe spécifique cette page apparaîtra sous le nom /index.php/EURECA_tag dans les rapports. Si je décide de changer l'url de cette page et qu'elle ne devienne disponible qu'à cette adresse http://support.eulerian.com/EURECA_tag une nouvelle page sera créée et aura pour nom /EURECA_tag.
Ceci aura pour conséquence une rupture dans les données collectées sur la page EURECA_tag, nous aurons la répartition suivante :
- données sur la page /index.php/EURECA_tag jusqu'au changement de nom.
- données sur la page /EURECA_tag à partir du changement de nom.
Dans le cas où l'on veut les données aggrégées sur une période recouvrant le changement de nom, il faut aggréger les données des deux pages '/index.php/EURECA_tag' et /EURECA_tag, alors que ces pages ont le même contenu.
Pour éviter ce problème et se prémunir d'un éventuel changement d'adresse, le plus simple est d'utiliser la syntaxe spécifique. Dans ce cas on aurait posé le marqueur suivant sur la page http://support.eulerian.com/index.php/EURECA_tag :
<script type="text/javascript">
/*<![CDATA[*/
EURECA_tag('eulerian.support', '/EURECA_tag');
/*]]>*/
</script>
Suite à la migration, le marqueur ci-dessus n'aurait pas été modifié alors que l'adresse aura été changée en http://support.eulerian.com/EURECA_tag
Dans cette configuration, quelle que soit l'adresse de la page, son nom sera toujours /EURECA_tag.
Ceci simplifiera d'autant la réalisation de rapport spécifiques se basant sur des noms de pages.
Site utilisant les technologies Ajax / web2.0
Le marqueur EURECA_tag ne permet pas les appels multiples sur une même page.
Dans le contexte des site utilisant les technologies Ajax / web2.0 il n'y a pas de rechargement de la page, si plusieurs appels au marqueur EURECA_tag sont faits, seul le premier appel sera géré par EUreca.
Si vous souhaitez réaliser plusieurs appels dans une même page, il faut utiliser le marqueur EURECA_tagmulti.
Syntaxe du marqueur utilisant un tag image
Important : nous déconseillons fortement d'utiliser cette méthode pour collecter des données. Cette méthode de collecte ne nous permet pas de récupérer les données liées au trafic gratuit : référencement naturel, référant, branding, etc ... tout ce trafic sera affecté au trafic naturel; tout le trafic payant et tracké par des marqueurs de clics ou d'impressions sera lui correctement traité.
Cette méthode est à utiliser dans certains cas spécifiques où il n'est pas possible d'intégrer des marqueurs Javascripts sur les pages que vous souhaitez tracker et que vous ne souhaitez pas avoir d'informations liés au trafic gratuit.
<img width="1" height="1" border="0" src="http://<RTDOMAIN>/tag/<IDENTIFIANT_SITE>/?url=<URL_PAGE>&urlp=<NOM_PAGE>" />
Paramétres :
- <RTDOMAIN> : obligatoire, domaine de tracking temps-réel.
- <IDENTIFIANT_SITE> : obligatoire, correspond à l'identifiant de votre site dans EUreca.
- <URL_PAGE> : optionnel, url de la page courante.
- <NOM_PAGE> : optionnel, nom de la page comme vous souhaitez la voir apparaître dans l'interface.
Exemple pour le site eulerian.support sur la page http://support.eulerian.com/index.php/EURECA_tag ayant comme nom EURECA_tag.
<img width="1" height="1" border="0" src="http://et.eulerian.net/tag/eulerian.support/?url=http%3A//support.eulerian.com/index.php/EURECA_tag&urlp=EURECA_tag" />
