Issuu on Google+

Guide de marquage Rich media

AT INTERNET © All rights reserved www.atinternet.com - France: 0 800 881 838 (free number) Head office: 85 avenue JF Kennedy – 33700 Mérignac – France – RCS Bordeaux B 403 261 258 DE.S.3-000000533 – v2.2 (updated 12/02/2010)


Table des matières Avant propos ..................................................................................................................................................................... 1 Rich media ........................................................................................................................................................................ 2 Principes généraux ........................................................................................................................................................ 2 Personnalisation du marquage ................................................................................................................................... 2 Tag de rafraîchissement ............................................................................................................................................. 2 Le cas des podcasts ................................................................................................................................................... 2 Implémentation javaScript .............................................................................................................................................. 3 Marquer les contenus vidéo, audio et animations ....................................................................................................... 3 Marquer les podcasts ................................................................................................................................................. 3 Implémentation ActionScript .......................................................................................................................................... 5 Etape 1 : insertion des appels dans les fichiers AS existants ..................................................................................... 6 Etape 2 : implémentation du fichier "xititag.xml" ......................................................................................................... 7 Exemple d’implémentation ......................................................................................................................................... 8 Annexes ............................................................................................................................................................................ 9 Annexe : identifiants Rich media .................................................................................................................................... 9 Identifiants des actions prédéfinies ............................................................................................................................. 9 Identifiants de définition de la qualité du contenu ....................................................................................................... 9 Identifiants des flux de lecture .................................................................................................................................... 9 Identifiants des extensions de contenus ................................................................................................................... 10

ii


Avant propos Les marques et logos figurant dans ce document sont des marques enregistrées ou non appartenant à la société AT Internet ou à des tiers. Toute utilisation, non autorisée explicitement par les titulaires des marques précitées, est strictement interdite. Toute reproduction partielle ou totale de ce document, sans autorisation expresse d’AT Internet est interdite. AT Internet se réserve le droit de mettre à jour le présent document à tout moment et sans préavis. Document et informations non contractuels. © AT Internet - 2010 - All rights reserved

1


Rich media Grâce à la fonctionnalité Rich media, vous disposez d’une mesure précise et détaillée de tous les types de contenus (audio, vidéo, podcast...), mais également d’informations complémentaires sur lieux de diffusion des contenus (internes ou externes à votre site), les modes de diffusion (Clip ou Live) ainsi que sur les actions précises effectuées par les internautes (play, stop, pause, backward, forward, partage, envoi par email, mise en favoris...). Ce document de marquage décrit une marche à suivre générale en fonction de la technologie utilisée pour l’implémentation de la mesure Rich media : Implémentation en code javaScript (lecteurs standards) Implémentation en code ActionScript (lecteurs Flash AS3) Les informations et exemples fournis sont donc valables pour la mesure de tous les types de contenus mesurés (audio, vidéo, etc.). Toutes les informations décrites dans ce document sont conditionnées par le téléchargement préalable (et par vos soins) du fichier xtcore.js version 3.3.003 ou ultérieure. Ce dernier est disponible dans votre interface depuis : la zone Configuration > Marqueurs XiTi > Marqueurs de contenus (version 7.5) le bouton Outils > Marqueurs (version NX)

Principes généraux Quel que soit votre type de lecteur (javaScript ou Flash), AT Internet vous propose de mesurer les types de contenus suivants : Vidéo Audio Animation Podcast IMPORTANT Un type de contenu ne peut pas appartenir à 2 types différents. Le fait de renseigner le même libellé lors du marquage (ou le même identifiant) ne permet pas de les regrouper.

Personnalisation du marquage En fonction du type de contenu mesuré, vous avez la possibilité de nommer tous les éléments, puis de les classer (avec pour séparateur "::") sur 3 niveaux de thèmes maximum. AT Internet vous propose de mesurer un grand nombre d’éléments Rich media en vous proposant des valeurs prédéfinies, mais vous permet également d’intégrer des informations personnalisées au moment du marquage. IMPORTANT Retrouvez toutes les valeurs prédéfinies des variables dans les annexes de ce document.

Tag de rafraîchissement Pour garantir la parfaite intégrité de la mesure, AT Internet a prévu un envoi (à fréquence régulière) de hit indépendant de rafraichissement (Refresh) afin de s’assurer que le media est toujours lu par l’internaute. Vous obtenez ainsi des durées de lecture plus précises qu’avec une simple mesure basée sur la différence de temps entre l’action "Stop" et l’action "Play".

Le cas des podcasts La méthode d’implémentation du marqueur Podcast est sensiblement différente des autres types de contenus. La procédure de marquage est évoquée en détail dans ce document.

2


Rich media

Implémentation javaScript La méthode de mesure des éléments Rich media consiste à appeler une fonction javaScript (xt_rm()) au moment du clic de l’internaute sur un élément du player (diffusant le contenu du média).

Marquer les contenus vidéo, audio et animations La page Web qui contient le lecteur Rich media doit contenir un code du marqueur avec le fichier xtcore.js . Ce fichier xtcore.js contient la fonction xt_rm() qui doit être appelée sur chaque action réalisée sur le lecteur (action javaScript). IMPORTANT Vous devez donc faire appel à la fonction xt_rm() pour mesurer tous les événements sur les types de contenus audio, vidéo et animation. Appel en javaScript via la fonction xt_rm() La fonction xt_rm(), commune à tous les types de contenus, permet de passer plusieurs variables. Ces dernières ont une signification différente en fonction du type de contenu mesuré. La fonction xt_rm() doit prendre la forme suivante (ordre à respecter) : Onclick=xt_rm(A,B,C,D,E,F,G,H,I,J,K,L,M,N) Liste des variables à renseigner A (obligatoire) : type de contenu ("video", "audio", ou "animation"). B : site de niveau 2 dans lequel est rangé le contenu. C (obligatoire) : libellé du contenu (utilisez les "::" si besoin). D (obligatoire) : action (identifiant prédéfini). Retrouvez la liste des identifiants dans les annexes de ce document. E : valeur de l’action personnalisée (si la variable D="perso"). Vous pouvez ajouter jusqu’à 5 actions personnalisées. DISPONIBLE PROCHAINEMENT F : durée de rafraichissement (optionnel en seconde). La durée de rafraîchissement est blindée. Il est impossible de saisir une durée inférieure à 5 secondes. G : durée totale du contenu en seconde (laisser vide si L="live"). Cette variable est obligatoire si D="play" et L="clip". H : Variable non utilisée (mettre la valeur "0"). I : identifiant de qualité OU numéro du slide si type="animation". J : identifiant de flux OU information si passage automatique ou pas si type="animation". K : localisation ("int" ou "ext"). L : diffusion ("live" ou "clip"). Si A="Animation", renseigner L="Live" permet d’avoir la durée absolue de lecture (et non relative par rapport à G). Si L est vide, le mode de diffusion pris en compte est "clip". M : taille du contenu (entier en Ko, laisser vide si L="live")) N : format du contenu (identifiant prédéfini par nos soins. Voir annexes) NOTE Toutes les caractéristiques d’un contenu n’ont pas besoin d’être transmises à chaque appel. Par exemple, sur les actions "pause" ou "stop", nous pouvons estimer que les caractéristiques du contenu ont déjà été transmises. IMPORTANT Retrouvez toutes les valeurs prédéfinies des variables dans les annexes de ce document. Exemple : Ci-dessous l’exemple de la fonction xt_rm qualifiant une action "play" sur un lecteur vidéo. xt_rm('video',3, 'mychapter::mycontent', 'play','0','0','3600','0','1','1','int','clip','300',1)

Marquer les podcasts Pour l’analyse de la performance des podcasts d’un site, nous proposons plusieurs types de mesure :

3


Guide de marquage | Rich media

Le chargement du flux XML sur le logiciel de lecteur de podcast (iTunes ou autres). Le téléchargement d'un des éléments podcast proposés dans le flux. Mesure du flux XML La mesure du flux XML est permise par une redirection du flux vers l’un de nos serveurs afin que nous puissions mesurer chacun des chargements du flux. Afin d’installer cette redirection, vous devez procéder de la façon suivante : Si votre site possède un flux de type podcast sur l'URL http://www.mysite.fr/feed.xml, les internautes ont noté cette URL dans leur lecteur de podcast. Copiez le contenu de ce fichier dans un autre fichier XML inconnu des internautes (par exemple, feed2.xml). Remplacez son contenu par une redirection dynamique (côté serveur) vers : http://logxxxx.xiti.com/get/feed?xts=xxxx&type=Podcast&feed=feed_name&url=http://www.mys ite.com/feed2.xml Dans cette URL, les modifications suivantes doivent être apportées : logxxxx est à remplacer par le serveur indiqué dans la variable xtsd de votre code du marqueur général xts=xxxx est à renseigner avec l’identifiant de votre site (variable xtsite du code du marqueur général) feed_name est à remplacer par le nom que vous voulez donner à votre flux (celui qui apparaitra dans votre rapport) url contient l’URL vers laquelle la redirection doit se faire (celle qui héberge votre flux). Cette variable doit être placée en dernier et commencer par http:// NOTE Cette méthode permet de mesurer les flux XML déjà enregistrés par les internautes dans leur lecteur de flux (iTunes ou autres). Pour toute nouvelle inscription, il est recommandé de proposer aux internautes le même fichier XML avec en paramètre la date de l’inscription : la redirection vers logxxxx.xiti.com/…. ne se fait alors que si la date de diffusion est supérieure à celle de l’inscription (pas de mesure le 1 er jour). * Date de la mesure (variable "xtdate") : Pour éviter que les lecteurs de flux podcast enregistrent directement l'URL redirigée, vous devez vous baser sur la date d'inscription au flux. Si la date récupérée est la date du jour, la redirection ne se fait pas, si la date est différente de la date du jour, la redirection s'effectue. Si votre site propose un flux Podcast sur l'URL suivante : http://www.mysite.com/feed.xml Vous devez suivre les étapes suivantes : 1. A tous les appels à ce flux, ajoutez la date du jour dans une variable "xtdate". Par exemple en ASP : http://www.mysite.com/feed.xml?xtdate=<% = date %> Cette date sera récupérée comme la date d'inscription au flux. 2. Copiez le contenu de ce fichier flux.xml dans un autre fichier (par exemple feed2.xml) qui servira au point 3. 3. Remplacez le contenu du fichier flux.xml par une redirection dynamique (côté serveur) vers nos serveurs : http://logxxxx.xiti.com/get/feed?xts=xxxx&type=podcast&feed=feed_name&xtinsc={value_xtda te}&url=http://www.mysite.com/feed2.xml où feed_name est à remplacer par votre propre libellé de flux. IMPORTANT Vous devez réaliser cette opération UNIQUEMENT si la variable xtdate n'est pas la date du jour. Par exemple, en ASP, vous auriez : <% xtdate = request.querystring("xtdate") if date = xtdate then %>

4


Rich media

<!-- #include file="feed2.xml" --> <% else response.redirect "http://logxxxx.xiti.com/get/feed?xts=xxxx&type=podcast&feed=feed_name &xtinsc=" & xtdate & "&url=http://www.mysite.com/feed2.xml" end if %> Au final : Si la date que vous avez placée dans l'URL est celle du jour, feed.xml ne contient alors que feed2.xml en "include" Sinon l'URL logp.xiti.com effectuera une redirection vers feed2.xml (permettant ainsi la mesure) Mesure des articles podcast Les articles podcast peuvent être des fichiers audio, vidéo ou autres, que le flux XML propose en téléchargement. Là aussi, il est nécessaire de passer par une redirection, en procédant de la façon suivante : Repérez les balises <enclosure> à l’intérieur de votre fichier XML. Par exemple, la ligne suivante : <enclosure url="http://mysite.com/video.mov" length="34524" type="video/quicktime" /> Remplacez l’URL appelée par le fichier, par une URL de redirection comme celle-ci : <enclosure url="http://logxxxx.xiti.com/get/my_video.mov?xts=xxxx&amp;type=Podcast&amp;feed=feed_na me&amp;pod=video_name&amp;url=http://www.mysite.com/video.mov" length="34524" type="video/quicktime" /> NOTE Pour des raisons de compatibilité avec iTunes, il est impératif d’ajouter "amp ;" derrière le caractère "&". Dans cette URL, les modifications suivantes doivent être apportées : logxxxx est à remplacer par le serveur indiqué dans la variable xtsd de votre code du marqueur général xts=xxxx est à renseigner avec l’identifiant de votre site (variable xtsite du code du marqueur général) feed_name reprend le libellé du flux global XML my_video.mov est un libellé que vous pouvez renseigner librement (avec extension .mp3, .mov ou autre) et qui est repris par certains lecteurs de flux (IE7 entre autre) video_name à remplacer par le nom que vous voulez donner au fichier téléchargé (libellé que vous retrouverez dans votre interface) url contient l’URL vers laquelle la redirection doit se faire (celle qui héberge votre flux). Cette variable doit être placée en dernier et commencer par http:// IMPORTANT L'URL placée derrière dans la variable url= doit commencer par ‘http://’ et doit être placée à la fin. La variable "pod" doit être utilisée uniquement pour les articles téléchargés (sans cette variable, une actualisation du flux est mesurée et non un téléchargement d’élément). NOTE Les analyses seront disponibles dans Rich media > Podcasts.

Implémentation ActionScript Nous décrivons ici la méthode d’implémentation Rich media dans un lecteur de type Flash AS3. IMPORTANT Pour l'implémentation Rich media, nous mettons à votre disposition un dossier "XiTiFlash". Ce dossier est disponible UNIQUEMENT SUR DEMANDE à formuler depuis le Centre Support dans l’interface. Il contient : - Des fichiers sources AS3 : ils ne doivent pas être modifiés et doivent être placés dans le même dossier que votre film flash source. - Un fichier "xititag.xml" qui doit contenir toutes les informations reliant les flags aux variables.

5


Guide de marquage | Rich media

L’implémentation du marqueur Rich media nécessite plusieurs étapes : 1. Placer les bons fichiers contenus dans le dossier "XiTiFlash" dans votre espace de travail Flash. 2. Modifier votre film Flash pour insérer des flags qui caractérisent les endroits que vous souhaitez mesurer tout au long de votre film. 3. Implémenter un fichier XML (exemple proposé dans le dossier "XiTiFlash") qui reprend tous les flags créés pour leur attacher des variables.

Etape 1 : insertion des appels dans les fichiers AS existants En fonction de vos besoins de mesure, vous devez insérer la ligne : XiTiTag.loadXml("Flag_Name"); Dans cette ligne de code "Flag_Name" est un libellé qui relie l’événement Flash à mesurer au code contenu dans le fichier xititag.xml. XiTiTag est une fonction créée dans un des fichiers ".as" du dossier "XiTiFlash". Nous vous recommandons de donner des noms suffisamment explicites aux flags, tout en sachant que vous devez configurer leurs propriétés à mesurer dans le fichier "xititag.xml" (voir étape 2). IMPORTANT Si le film Flash fait appel ("XiTiTag.loadXml()") à un flag non déclaré dans le fichier XML, la mesure ne se fait pas. Exemple :

L’image ci-dessus présente un code ".as" existant dans lequel ont été ajoutés 2 appels XiTiTag.loadXml() avec un nom de flag "Play_video1" et "stop_video1". L’objectif de ces appels est de générer une mesure Rich media avec une action "play" et "stop". Ces actions sont renseignées dans le fichier xititag.xml, via la fonction xt_rm(). Variables dynamiques Pour des raisons pratiques, si vous souhaitez passer les valeurs de certaines variables (à passer dans la fonction xt_rm() du fichier xititag.xml) directement dans le code source du fichier .as, vous devez regrouper ces variables (concaténées avec des séparateurs "&") dans une chaine à passer comme seconde variable de XiTiTag.loadXml(). Exemple : //Start play private function doPlay (e:MouseEvent) :void { var nameflv:String="&richname=theme::myvideo1"; flv=video1.flv";

6


Rich media

if (nextP){ flv="video2.flv"; nameflv="&richname=thme::myvideo2"; } XiTiTag.loadXml ("Play", nameflv) ; vidtest.stopPlay (ns) ; vid.clear () ; vidTest.startPlay (ns, flv) ; vid.attachNetStream (ns) ; } Cet exemple montre comment une variable dynamique ("nameflv") est construite pour changer un nom de contenu ("myvideo1" ou "myvideo2") selon un certain contexte. L’appel suivant : XiTiTag.loadXml("Play",nameflv); Permet ainsi de se reposer sur les caractéristiques du flag "Play" (passées dans xt_rm() de xititag.xml) tout en modifiant le libellé du contenu. Toutes les variables passées en seconde variable de cet appel sont prioritaires sur les informations renseignées dans le fichier XML (étape 2). Structure des variables Pour contrôler dynamiquement chaque variable de xt_rm(), il suffit donc de les renseigner dans les noms suivants : type (obligatoire) : type de contenu ("audio", "video" ou "animation"). richn2 : site de niveau 2 dans lequel ranger le contenu. richname (obligatoire) : libellé du contenu (avec utilisation de "::" si besoin pour établir une arborescence thématique). action (obligatoire) : identifiant texte caractérisant une action parmi les actions prédéfinies (voir annexes). custom : contenu des variables personnalisées (à utiliser uniquement si action="perso"). DISPONIBLE PROCHAINEMENT refresh : durée de rafraîchissement (optionnel, en seconde). Pour les contenus de longue durée, cette variable permet de générer des hits intermédiaires automatiques (entre le hit de "play" et celui de "stop") apportant ainsi une mesure plus fine de la durée. duration : durée totale du contenu en seconde (laisser vide si mode="live"). Cette variable est obligatoire si D="play" et L="clip". quality : identifiant de qualité OU numéro de slide si type="animation". stream : identifiant de flux OU booléen pour indiquer si le changement de slide est automatique ou pas (si type="animation"). location : localisation du contenu ("int" pour interne au site ou "ext" pour externe). mode : diffusion ("live" pour les contenus diffusés en continu et sans durée, ou "clip" pour les contenus à durée finie). Si "type=Animation", renseigner "mode=Live" permet d’avoir la durée absolue de lecture (et non relative par rapport à "duration").Si L est vide, le mode de diffusion pris en compte est "clip". size : taille/poids du contenu (entier en Ko, laisser vide si mode="live"). extension : format du contenu (identifiant prédéfini. Voir annexes).

Etape 2 : implémentation du fichier "xititag.xml" Ce fichier contient : une balise <xiti> contenant elle-même 2 balises. une balise <tags> contenant toutes les balises <tag> définissant les flags présents dans les fichiers ".as" sources. Elle doit contenir le sous-domaine du marqueur, le numéro de site et, éventuellement, le niveau 2. NOTE Les variables définies directement dans la balise <tags> sont les valeurs globales par défaut à attribuer à toutes les balises <tag> : cela évite d’avoir à répéter dans chaque balise l’identifiant du site, du niveau 2, etc. Bien sûr, chaque variable de la balise <tags> peut être redéfinie dans chaque balise <tag>. une balise <settings> qui contient elle-même une balise <url> caractérisant le domaine du collecteur (ne pas modifier). Exemple :

7


Guide de marquage | Rich media

Ci-dessous un exemple de fichier "xititag.xml" donné dans le dossier "XiTiFlash" : <?xml version="1.0" encoding="iso-8859-1"?> <xiti> <tags xtsd="http://log" xtsite="32" xtn2="17"> <! -- video launch --> <tag key="Play_video1" xtprich="page_with_video" xts2rich="3" xtrm="video,4,video1,play,0,2,3000,4,1,1,int,clip,1000,8" /> <tag key="Stop_video1" xtprich="page_with_video" xts2rich="3" xtrm="video,4,video1,stop /> </tags> <! -- General parameters defintion --> <settings> <url>.xiti.com/hit.xiti</url> </settings> </xiti>

Exemple d’implémentation Avec le tag XML suivant : <tag key="Play_video1" xt_rm="video,4,chap::myvideo,play,0,6,10,0,1,1,int,clip,1000,8" xtprich="video_page" xts2rich="3" /> Tout appel : XiTiTag.loadXml("Play_video1"); envoie un hit contenant les informations suivantes : Type : "video". Site de niveau 2 : "4" Libellé du contenu : "chap::myvideo" Action : "play" Actions personnalisées : "0" (pas d’action personnalisée). Durée de rafraîchissement : "6" (secondes) Durée totale du contenu : "10" (secondes) Variable non utilisée : "0" Identifiant de qualité : "1" (22khz) Identifiant de flux : "1" (64 kbps) Localisation du contenu : "int" (interne au site) Mode de diffusion : "clip" (contenu avec durée finie) Taille/poids du contenu : "1000" (Ko) Format du contenu : "8" (swf) Par contre, l’appel suivant : XiTiTag.loadXml("Play_video1", "&richname=theme::myvideo&duration=20"); envoie un hit avec exactement les mêmes informations, à l’exception : du nom du contenu : "theme::myvideo" de la durée du contenu : "20" (secondes)

8


Annexes Annexe : identifiants Rich media Identifiants des actions prédéfinies En fonction de la signification à donner à l’appel d’un tag, les actions Rich media doivent contenir un des identifiants textes suivants : "play" : action de lancement de lecture "pause" : action de mise en pause "stop" : action d’arrêt de lecture (et donc de retour au début) "forward" : action de se déplacer vers l’avant (valable uniquement pour les contenus avec des séquences prédéfinies) "backward" : action de se déplacer vers l’arrière (valable uniquement pour les contenus avec des séquences prédéfinies) "share" : action de partager la vidéo (utilisé surtout dans les blogosphères) "email" : action d’envoyer le contenu par mail "favor" : action de mise en favoris "download" : action de télécharger un contenu "perso" : DISPONIBLE PROCHAINEMENT - action non prédéfinie. Cet identifiant permet de passer jusqu’à 3 actions personnalisées. Elles doivent être définies dans votre interface et les valeurs sont à transmettre dans les variables rm1, rm2 ou rm3

Identifiants de définition de la qualité du contenu La qualité est une mesure qui s’exprime en Hz. Les identifiants prédéfinis sont les suivants : 1 : 22 kHz 2 : 44 kHz 3 : 32 kHz 4 : 70 kHz

Identifiants des flux de lecture Les flux de lecture sont des mesures qui s’expriment en kbps. Les identifiants prédéfinis sont les suivants : 1 : 64 kbps 2 : 128 kbps 3 : 160 kbps 4 : 192 kbps 5 : 224 kbps 6 : 256 kbps 7 : 320 kbps 8 : 22 kbps 9 : 96 kbps 10 : 112 kbps 11 : 300 kbps 12 : 500 kbps

9


Guide de marquage | Rich media

13 : 1000 kbps 14 : 800 kbps 15 : 900 kbps 16 : 1200 kbps 17 : 1500 kbps 18 :200 kbps

Identifiants des extensions de contenus Les extensions de contenu se renseignent dans le tag par des identifiants textes dont voici la liste : 1 : mp3 2 : wma 3 : wav 4 : aiff 5 : aac 6: mpeg 7 : flv 8 : swf 9 : mp4 10 : avi 11 : mkv 12 : wmv 13 : mp3+G 14 : rm 15 : rmvb 16 : mov

10


Marque Xiti Rich media