Guide du marquage
Transcription
Guide du marquage
Version 1.0 Septembre 2007. Document destiné exclusivement aux utilisateurs de Direct-Stats. Toute reproduction interdite. Guide du marquage Direct-Stats. Tous droits réservés © 2007. SOMMAIRE 1. Technologie de marquage Direct-Stats………………………………. p.3 1.1 Qu’est ce que le marquage Direct-Stats?................................. p.3 1.2 Fonctionnement du marqueur……………………………………………………… p.3 2. Les différents types de traçage………………………………………… p.5 2.1 Qu’est il possible de marquer?............................................... p.5 2.2 Traçage classique de pages web…………………………………………………. p.5 2.3 Marquage dynamique…………………………………………………………………… p.6 2.4 Auditer des sites en Flash……………………………………………………………. p.7 2.5 Suivi de campagnes d’emailing……………………………………………………. p.8 2.6 Marquer les clics…………………………………………………………………………… p.9 2.7 Alternative au JavaScript……………………………………………………………… p.10 3. Marquage de blogs…………………………………………………………. p.11 3.1 Blogger………………………………………………………………………………………….. p.11 3.2 MySpace………………………………………………………………………………………. p.11 4. Et pour le reste……………………………………………………………….. p.12 -2- Guide du marquage Direct-Stats. Tous droits réservés © 2007. 1. Technologie de marquage Direct-Stats 1.1 Qu’est ce que le marquage Direct-Stats ? Le service de statistiques Direct-Stats vous permet d’obtenir des informations de divers types sur les visiteurs de vos pages internet. Le principal avantage de la technologie de marquage Direct-Stats c’est des données en temps réel. Autrement dit les informations sont transmises et reproduites sur l’interface de consultation au moment même de la visite. Afin de récupérer ces informations, il est nécessaire d’insérer sur les pages à auditer une portion de code qui transmettra à nos serveurs les différentes caractéristiques de vos internautes. Actuellement le marqueur Direct-Stats permet la récupération : - du nombre de visiteurs - des pages vues - de l’heure de visite - de la provenance du visiteur (moteur de recherche, site référant ou accès direct) - du pays et de la région d’origine (Fr, Be, Es) - de l’équipement (FAI, navigateur, OS, résolutions d’écran et nombre de couleur) Ces données sont ensuite traitées en entrée et en sortie afin de vous fournir un large panel de statistiques. Le code utilisé pour le marqueur est le javaScript qui est un langage web coté client omniprésent sur l’Internet. Intégrer correctement ce script n’affectera en rien votre site. En plus d’être invisible (une image de 1x1 pixel) il ne ralentira pas le temps de chargement de vos pages (un poids de 6 octets). 1.2 Fonctionnement du marqueur Une fois votre compte utilisateur ouvert et le marqueur positionné correctement sur vos pages, vous êtes prêts à obtenir les premières statistiques. A chaque fois qu’une personne se rend sur votre site un appel est fait à la fonction javaScript du marqueur. Cette fonction transmet à un système de traitement situé sur les machines Direct-Stats les informations sur vos visiteurs. Les données sont filtrées puis insérées dans nos différentes architectures de stockage. -3- Guide du marquage Direct-Stats. Tous droits réservés © 2007. Technologie de marquage Direct-Stats La technologie que nous utilisons a été développée en considérant deux aspects primordiaux. Premièrement le marqueur est invisible. Il ne se verra ni physiquement sur vos pages ni ne se sentira en ralentissant le temps de chargement de cellesci. Ensuite le filtrage et l’insertion de vos données sont rapides. Cela afin d’assurer un fonctionnement optimum de nos serveurs autant pour la collecte des informations que pour leur consultation. Qu’est que cette méthode vous garantit? Avant tout un temps d’exécution du marqueur quasi nul et des données statistiques fiables en temps réel. Mais aussi une mesure d’audience qui reste invisible pour vos visiteurs. -4- Guide du marquage Direct-Stats. Tous droits réservés © 2007. 2. Les différents types de traçage 2.1 Qu’est il possible de marquer ? Il existe de très nombreux types de traçage de page web. Dans une optique d’efficacité et de fiabilité Direct-Stats vous propose actuellement six catégories de marqueurs. Chacun d’eux étant orienté vers une utilisation bien précise. - - - Le marquage manuel: Il s’agit du type de marqueur le plus classique. Destiné aux sites web perso, de petite taille et comprenant un nombre limité de pages à tracer. Le marquage dynamique: Il est l’alternative idéale au marquage manuel dés lors que le nombre de pages ou la structure du site devient important. Bien adapté aux sites à caractère professionnels. Le marquage Flash: Un marqueur particulier spécialement conçu pour les sites en Flash. Suivi des campagnes d’emailings: Un marqueur simplifié pour visualiser vos campagnes d’emails. Le marquage au clic: Un système de marquage pour comptabiliser les clics sur des liens particuliers comme les fichiers à télécharger. Le marquage de zones sécurisées: Alternative au JavaScript, ce marqueur utilisant la libraire cURL de PHP peut s’avérer très efficace dans les cas ou le JavaScript ne peut être exécuté. 2.2 Traçage classique de pages web Adapté aux sites Internet de petite envergure tel que les pages perso, les blogs ou bien les sites de petite et moyenne entreprise ne comprenant pas beaucoup de pages. Il s’agit ici d’un marquage manuel. C'est-à-dire que chacune de vos pages html devra contenir le code du marqueur avec le nom de la page correspondante. Pour générer ce marqueur il vous suffit de rentrer le nom de la page (exemple « accueil ») dans le champ du formulaire puis de cliquer sur « générer le marqueur ». Il faudra ensuite répéter cette opération pour toutes les pages dont vous désirez suivre la fréquentation. -5- Guide du marquage Direct-Stats. Tous droits réservés © 2007. Ci-dessous un exemple de marquage manuel pour une page nommée ‘accueil’: <script type="text/javascript"> <!-function mesure(_MesurePro, _page) { scr_w = screen.width; scr_h = screen.height; color = screen.colorDepth; ref = escape(window.document.referrer); document.write('<img src="http://www.directstats.com/logs/monCompte/monSite/marqueur.php?page='+_page+ '&n='+ Math.round (Math.random () * 1000000000000000)+ '&reso_w='+ scr_w+ '&reso_h='+ scr_h+ '&color='+ color+ '&referer='+ ref+'" style="border:0px;" />'); } mesure("Mesure Pro", "accueil"); --> </script> 2.3 Marquage dynamique Conçu en tant qu’alternative au marquage manuel ce système est uniquement utilisable si votre site comprend une architecture de langages coté serveur tel que PHP, ASP, Perl/Cgi… Il vous permettra de remplacer des noms de pages statiques par des variables dynamiques. Par exemple si votre site est conçu en PHP il est fort probable que certaines variables contiennent des informations sur la page en question. Pour une structure de pages comprenant des URLs de la forme : http://www.monsite.com/index.php?page=accueil ou la page index.php est appelée pour chacune des autre pages. Il suffira de positionner un seul marqueur dans l’index. - On récupère tout d’abord le nom de la page : <?php $page_marqueur=$_GET['page']; ?> -6- Guide du marquage Direct-Stats. Tous droits réservés © 2007. - Afin de l’utiliser ensuite dans le marqueur <script type="text/javascript"> <!-function mesure(_MesurePro, _page) { scr_w = screen.width; scr_h = screen.height; color = screen.colorDepth; ref = escape(window.document.referrer); document.write('<img src="http://www.directstats.com/logs/monCompte/monSite/marqueur.php?page='+_page+ '&n='+ Math.round (Math.random () * 1000000000000000)+ '&reso_w='+ scr_w+ '&reso_h='+ scr_h+ '&color='+ color+ '&referer='+ ref+'" style="border:0px;" />'); } mesure("Mesure Pro", "<?php echo $page_marqueur; ?>"); --> </script> Bien sur ceci n’est qu’un exemple basique en PHP. La manière d’utiliser un marqueur dynamique dépend de la structure de vos pages et du langage utilisé. 2.4 Auditer des sites en Flash La technologie Direct-Stats permet de suivre la fréquentation de sites entièrement conçus en Flash (uniquement disponible à partir de Flash 8). Et cela d’une manière très simple en utilisant la méthode ‘ExternalInterface‘ de ActionScript (à partir de la version 2.0). Le fichier html incluant l’objet Flash contient la fonction de mesure JavaScript Direct-Stats. Un objet image JavaScript est crée mais n’est pas affiché. <script type="text/javascript"> <!-function mesure(_MesurePro, _page) { scr_w = screen.width; scr_h = screen.height; color = screen.colorDepth; ref = escape(window.document.referrer); var DSImage=new Image(); imgSrc='http://www.directstats.com/logs/monCompte/monSite/marqueur.php?page='+_page+ '&n='+ Math.round (Math.random () * 1000000000000000)+ '&reso_w='+ scr_w+ '&reso_h='+ scr_h+ '&color='+ color+ '&referer='+ ref; DSImage.src=imgSrc; } --> </script> -7- Guide du marquage Direct-Stats. Tous droits réservés © 2007. Un appel à la fonction de mesure est fait directement à partir du Flash par le biais d’ActionScript: var maPage:String="Nom_Page"; ExternalInterface.call("mesure",'Mesure Pro', maPage); Pour plus d’informations nous vous recommandons de consulter la documentation en ligne sur la fonction ExternalInterface: http://livedocs.adobe.com/flash/8/main/wwhelp/wwhimpl/common/html/ww help.htm?context=LiveDocs_Parts&file=00002200.html 2.5 Suivi de campagnes d’emailing Le service de mesure d’audience Direct-Stats vous offre la possibilité de tracer la consultation de vos emails. Quoi de plus pratique lors de l’envoi d’une newsletter que de savoir combien et quelles personnes ont ouvert le message. Ci-dessous un exemple d’implémentation en PHP utilisant la fonction mail(). <?php $headers $headers $headers $headers $headers = .= .= .= .= 'MIME-Version: 1.0' . "\r\n"; 'Content-type: text/html; charset=iso-8859-1' . "\r\n"; 'From: me <[email protected]>' . "\r\n"; 'Cc: [email protected]' . "\r\n"; 'Bcc: [email protected]' . "\r\n"; $destinataire='[email protected]'; $sujet='Nos dernières actualités'; $corps = 'Cher utilisateur,<br/>'; $corps .= 'blablabla <br/>'; $corps .= 'merci.'; //Insertion dans le corps du mail du marqueur Direct-Stats $corps .= '<img src="http://www.directstats.com/logs/monCompte/monSite/marqueur.php?page='.$destinataire.'">'; $send = mail ($destinataire, $sujet, $corps, $headers); ?> En plus de la structure existante du mail une image de 1x1 pixel, renvoyant vers le marqueur Direct-Stats, est insérée. Celle-ci sera invisible lors de la lecture du message. Dans le cas de cet exemple, la liste des destinataires ayant ouvert l’email apparaîtra dans le rapport ‘pages vues’ de l’interface de consultation des statistiques. -8- Guide du marquage Direct-Stats. Tous droits réservés © 2007. Important: Veuillez considérer que cette méthode de mesure ne fonctionnera que pour les clients mail acceptant les images. Un outil comme Thunderbird est configuré par défaut pour ne pas afficher les images. Alors que Yahoo! mail les ouvrent directement. Note: Les informations telles que le pays ou région d’origine, l’équipement ou bien la provenance ne sont pas enregistrées avec ce type de marqueur. 2.6 Marquer les clics Grâce au système de mesure d’audience Direct-Stats vous pouvez suivre le nombre de clics sur un lien. Pratique pour comptabiliser le nombre de téléchargements d’un fichier. Il suffit pour cela de modifier légèrement la structure de vos liens en y ajoutant un événement OnClick. Lorsqu’un clic sera exécuté sur le lien en question un appel est fait au marqueur Direct-Stats. <a href="#" onClick="document.getElementById('marqueur_DS').innerHTML='<img src=\'http://www.directstats.com/logs/cevasion/cevasion/marqueur.php?page=monFichier\' style=\'border:0px;\' />';window.open('monURL');">Texte du lien</a> Il suffit ensuite d’ajouter un div qui contiendra le marqueur. <div id="marqueur_DS"></div> En rouge les paramètres à modifier: le nom du fichier tel que vous voulez qu’il apparaisse dans le rapport pages vues, la cible du lien href par un # et l’URL du lien dans le window.open. Remarque: Bien que ce modèle se réfère à des téléchargements, il est évidemment possible de mesurer toutes sortes de liens en appliquant la même méthode. -9- Guide du marquage Direct-Stats. Tous droits réservés © 2007. 2.7 Alternative au JavaScript Il peut s’avérer que dans certains cas le JavaScript ne soit pas accepté par le navigateur web. Cela est très fréquent dans les zones sécurisées de sites internet. Ce marqueur est destiné principalement aux sites de e-commerce comprenant une partie sécurisée (https). Généralement la zone d’achat. Le marqueur zone sécurisée Direct-Stats utilise la librairie cURL de PHP. Pour plus d’informations sur cURL vous pouvez consulter la documentation en ligne http://php.net/manual/fr/ref.curl.php Avec cette méthode les données seront transférées au serveur Direct-Stats directement via cURL et non plus par un lien non sécurisé. <?php // url d'accès à la passerelle Direct-Stats $url= "http://www.directstats.com/logs/monCompte/monSite/marqueur.php?page=maPage"; // initialisation curl $ch = curl_init(); // paramètres curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // active la méthode POST curl_setopt($ch, CURLOPT_POST, 1); // execute la connexion CURL $reponse = curl_exec($ch); // fermeture de la connexion curl_close($ch); ?> Dans l’exemple de code ci-dessus il est tout à fait possible d’implémenter un marquage dynamique en remplaçant le nom de page par une variable PHP. Note: Le marqueur cURL vous permettra d’obtenir uniquement des statistiques sur les pages vues. Les visiteurs ne seront pas comptabilisés. - 10 - Guide du marquage Direct-Stats. Tous droits réservés © 2007. 3. Marquage de blogs 3.1 Blogger Vous désirez marquer les pages de votre blog Blogger? Avec le marqueur Direct-Stats rien de plus simple. Sur Direct-Stats, dans la section "Gestion des marqueurs", choissisez un marqueur manuel avec le nom de page de votre choix. Générez le marqueur et copiez ce code. Connectez vous avec vos identifiants à votre compte Blogger. Cliquer sur "template". Cliquez sur "Ajouter un élément de page". Choisissez "HTML/JavaScript" puis "Ajouter au blog". Il vous suffit de coller le code Direct-Stats dans la case prévue à cet effet puis d’enregistrez les modifications. 3.2 MySpace Répétez l’étape de génération du marqueur comme dans le 3.1. Copiez uniquement la ligne ci dessous: http://www.direct-stats.com/logs/monCompte/monSite/marqueur.php?page=maPage Sur votre compte MySpace, choisissez le template suivant: <div style="background-image:url(insérez ici la ligne); backgroundrepeat:no-repeat; background-position:center; width:1px; height:1px;"> </div> Enregistrez les modifications. Vous pouvez désormais suivre l’audience de votre compte MySpace. - 11 - Guide du marquage Direct-Stats. Tous droits réservés © 2007. 4. Et pour le reste Vous avez consulté ce guide sans trouver de solution de marquage adapté à votre système? Des questions, des remarques… Notre équipe de techniciens est à votre disposition pour vous conseiller sur la meilleure méthode à adopter pour le traçage de votre site. Ensemble, en fonction de vos besoins, nous définirons la technologie qui conviendra le mieux à votre architecture. Contact: [email protected] - 12 -