Le Guide de marquage des Podcasts

Transcription

Le Guide de marquage des Podcasts
Médiamétrie-eStat
Buropolis, Bât 3
1240, route des Dolines
Sophia Antipolis
06560 Valbonne
Tél : 04 92 38 38 20
Fax : 04 92 96 91 25
E-mail : [email protected]
Sommaire
1.
Présentation................................................................................................................................................... 4
1.1.
Terminologie .............................................................................................................................................. 4
1.2.
Modes de redirections ............................................................................................................................... 5
1.2.1.
Classique ................................................................................................................................................ 5
1.2.2.
Url raccourcie ........................................................................................................................................ 5
1.3.
Exemples de flux xml de podcast ............................................................................................................... 5
1.3.1.
Un flux xml sans la mesure eStat ........................................................................................................... 5
1.3.2.
Un flux xml avec la mesure eStat classique ........................................................................................... 5
1.3.3.
Un flux xml avec la mesure eStat et avec une url raccourcie ................................................................ 6
2.
Présentation de la redirection classique ....................................................................................................... 7
2.1.
Le domaine de mesure eStat ..................................................................................................................... 7
2.2.
Le serial eStat ............................................................................................................................................. 7
2.3.
Extension du type de média ....................................................................................................................... 7
2.4.
Les niveaux du plan de marquage .............................................................................................................. 7
2.5.
L'url du média ............................................................................................................................................ 8
3.
Présentation de la redirection avec url raccourcie ....................................................................................... 9
3.1.
Url d'entrée ................................................................................................................................................ 9
3.1.1.
Identifiant d'URL (id) .............................................................................................................................. 9
3.1.2.
Serial .................................................................................................................................................... 10
3.1.3.
Niveaux 1 à 4 (levels) ........................................................................................................................... 10
3.1.4.
Adresse de redirection (redirectUrl) .................................................................................................... 10
3.1.5.
Type de redirection (redirectType) ...................................................................................................... 10
3.2.
Architecture ............................................................................................................................................. 11
3.2.1.
Serveur de raccourcissement d’URLs .................................................................................................. 11
3.2.2.
Base de données des URLs d'entrées .................................................................................................. 11
3.2.3.
Serveur de génération d’identifiants ................................................................................................... 11
3.3.
Utilisation de l'outil de raccourcissement d'url ....................................................................................... 12
3.3.1.
Authentification ................................................................................................................................... 12
3.3.2.
Créer une URL eStat raccourcie ........................................................................................................... 12
3.3.3.
Vérifier une URL raccourcie ................................................................................................................. 13
4.
Sous domaine de mesure ............................................................................................................................ 14
5.
Utilisation de variables ................................................................................................................................ 14
6.
Questions fréquentes .................................................................................................................................. 15
1. Présentation
Médiamétrie-eStat propose la mesure des Podcasts. La mesure des Podcasts se met en place par le
remplacement de l'url du média coté client avec une url eStat. L'url eStat une fois appelée va
rediriger le podcasteur vers l'url du média et mesurer ainsi le podcast.
Figure 1 : Utilisation d'un podcast
Figure 2 : Utilisation d'un podcast avec la mesure et redirection eStat
1.1.Terminologie
Une liste des termes utilisés dans ce document :
-
url du média : l'url d'un contenu proposé dans un flux xml de podcast (fichiers mp3, mpg…)
url eStat : l'url redirigeant vers l'url du média tout en effectuant la mesure de consommation.
url eStat raccourcie : url de redirection eStat raccourcie contenant l'identifiant d'une URL
d'entrée.
URL d'entrée : Entrée dans le référentiel eStat contenant un identifiant, l'url du média et les
niveaux de marquage associés.
identifiant d'URL : L'identifiant d'une URL d'entrée.
1.2.Modes de redirections
Deux techniques eStat sont proposées pour effectuer la redirection eStat.
1.2.1. Classique
Le mode classique implique de renseigner en paramètre dans l'url eStat, l'url du média ainsi que les
différentes informations liées au plan de marquage. Ce mode comprend un risque, car l'url complète
peut devenir très longue et du coup l'url ne sera pas compatible avec l'ensemble des agrégateurs
d'URLs de Podcasts, tels que iTunes.
1.2.2. Url raccourcie
L'autre mode consiste à créer une url eStat raccourcie contenant un identifiant. Cet identifiant
permet de retrouver l'url du média et les informations du plan de marquage pour un podcast.
1.3.Exemples de flux xml de podcast
Vous trouverez ci-dessous des extraits de flux xml. Dans ces extraits, vous trouverez différentes
possibilités de mises à disposition d'un flux avec ou sans la mesure eStat
1.3.1. Un flux xml sans la mesure eStat
Tableau 1 : Podcast sans la mesure eStat
<item>
<title>Emission du 16 août 2011</title>
<link>http://www.monsite.fr/podcast/emission.xml</link>
<author>[email protected]</author>
<enclosure length="91838088" type="audio/mpeg"
url="http://www.monsite.fr/emission/test.mp3"/>
<guid>http://www.monsite.fr/emission/test.mp3</guid>
<pubDate>Tue, 16 Aug 2011 12:00:00 +0200</pubDate>
<itunes:author>SITE</itunes:author>
<itunes:explicit>no</itunes:explicit>
<itunes:keywords>SITE,Marque,podcast</itunes:keywords>
<itunes:duration>01:35:53</itunes:duration>
</item>
1.3.2. Un flux xml avec la mesure eStat classique
Tableau 2 : Podcast avec la mesure eStat classique
<item>
url="http://stat3.cybermonitor.com/m/media/monsite_v.mp3?R=RUBRIQUE&S=SECTION&media_
url=http%3A%2F%2Fwww.monsite.fr%2Femission%2Ftest.mp3"/>
<guid>http://stat3.cybermonitor.com/m/media/monsite_v.mp3?R=RUBRIQUE&S=SECTION&medi
a_url=http%3A%2F%2Fwww.monsite.fr%2Femission%2Ftest.mp3</guid>
</item>
1.3.3. Un flux xml avec la mesure eStat et avec une url raccourcie
Tableau 3 : Podcast avec la mesure eStat avec url raccourcie
<item>
url="http://client.proxycast.org/637177968073904128/test.mp3"/>
<guid>http://client.proxycast.org/637177968443002880/test.mp3</guid>
</item>
2. Présentation de la redirection classique
Le principe de la redirection classique d'un podcast est simple, il faut remplacer l'url d'un media dans
le fichier podcast par une url eStat.
Dans l'url eStat, il faut renseigner les informations suivantes :
-
le domaine de mesure eStat ;
le serial eStat ;
l'extension du type de média (mp3, m4v…);
les niveaux du plan de marquage ;
et l'url du média.
Tableau 4 : Exemple de redirection classique
http://prof.estat.com/m/media/SERIAL.mp3?c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4&m
edia_url=URL_REDIRECTION_URLENCODE
2.1.Le domaine de mesure eStat
Nous proposons plusieurs domaines pour la mesure des podcasts.
Par défaut, le domaine proposé est "prof.estat.com"
Si vous souhaitez avoir un domaine personnalisé, merci de vous référer au chapitre sur les Sous
domaine de mesure.
2.2.Le serial eStat
Le serial est l'identifiant du compte. Ce paramètre doit être obligatoirement présent dans tous
marqueurs.
2.3.Extension du type de média
Il est important de renseigner l'extension en fonction du type de média du podcast, cela assure une
meilleure compatibilité avec les agrégateurs.
2.4.Les niveaux du plan de marquage
Les niveaux sont :
-
"c" = Le niveau 1 ;
"p" = niveau 2 ;
"l3" = niveau 3 ;
"l4" = niveau 4.
Les libellés saisis pour les variables niveaux 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 "Accueil", "ACCUEIL", "accueil" seront
restitués comme des niveaux différents à l'interface de consultation.
Si un niveau n'est pas renseigné, il sera automatiquement remplacé par un tiret "-" dans les rapports
d'audience.
Si vous mesurez les podcasts dans le cadre du communiqué Podcast publié par eStat, vous devez
réserver le niveau 1 pour renseigner le genre du média. Vous pouvez ensuite utiliser les autres
niveaux pour votre plan de marquage. Les genres à utiliser dans ce cadre sont les suivants :
« Culture », « Divertissement », « Information », « Musique », « Sport », « Vie pratique », « Autres »
2.5.L'url du média
L'url du média doit être url encodé.
Tableau 5 : Exemple d'une url d'un média
http://www.monsite.fr/repertoire/podcast.mp3
Tableau 6 : Exemple d'une url d'un média encodé
http%3A%2F%2Fwww.monsite.fr%2Frepertoire%2Fxxxx.mp3
Tableau 7 : Exemple de redirection classique avec une url encodée
http://prof.estat.com/m/media/SERIAL.mp3?c=NIVEAU1&p=NIVEAU2&l3=NIVEAU3&l4=NIVEAU4&m
edia_url= http%3A%2F%2Fwww.monsite.fr%2Frepertoire%2Fxxxx.mp3
3. Présentation de la redirection avec url raccourcie
Pour créer une url eStat raccourcie il faut interroger un service web spécifique (API).
Ce service web permet de générer un identifiant sur 32 caractères en fournissant :



l'url d'un média
le serial eStat
les niveaux du plan de marquage associés.
Cet ensemble d'information stocké dans notre base de données s'appelle une "Url d'entrée".
Le service permet également une fois un identifiant créé, d'obtenir les informations d'une Url
d'entrée à partir de l'identifiant.
Pour utiliser le service, on utilisera soit un identifiant soit les informations nécessaires pour créer une
URL d'entrée.
3.1.Url d'entrée
Une URL d'entrée est composée des informations suivantes
UrlEntry
id : BigInteger (généré automatiquement)
serial : String
level1 : String
level2 : String
level3 : String
level4 : String
redirectUrl : String
redirectType : Integer (302 uniquement pour l'instant)
Figure 3 : URL d'entrée
3.1.1. Identifiant d'URL (id)
Il s’agit d’un nombre entier long (sur 64bits).
L'identifiant est utilisé pour accéder au service.
Afin d'assurer un fonctionnement optimal des urls de podcast, l'identifiant doit être post fixé avec
l’extension du flux (.mp3,.avi...) vers lequel la redirection doit se faire.
L'identifiant doit être isolé par des slash "/".
Exemple d'identifiant : 12615808322391401193
Exemple d'URL raccourcie:
http://client.proxycast.org/12615808322391401193/podcast.mp3?gaid=456&f=lr
3.1.2. Serial
C’est le numéro de compte eStat.
Exemple : 241041114203
3.1.3. Niveaux 1 à 4 (levels)
Ce sont les noms des niveaux que vous devez personnaliser. Ils sont représentés par des chaînes de
caractères.
Exemple : niveautest
3.1.4. Adresse de redirection (redirectUrl)
C’est l’url du média ou l'adresse de la ressource finale. Il s’agit d’une chaine de caractères.
Exemple d'url de média : http://www.monsite.fr/234/podcast.mp3
3.1.5. Type de redirection (redirectType)
Code de redirection HTTP. Il s’agit d’un entier.
Ce code est toujours 302.
3.2.Architecture
Ci-dessous un schéma présentant l'architecture de notre service de raccourcissement d'url.
Figure 4 : Schéma général
3.2.1. Serveur de raccourcissement d’URLs
C’est un serveur d’application Java standard tel que Tomcat ou JBoss.
3.2.2. Base de données des URLs d'entrées
C’est une base de données qui fournit de très rapides temps d’accès aux URLs d'entrées.
3.2.3. Serveur de génération d’identifiants
Le serveur de génération d’identifiants est un serveur appelé par le serveur de raccourcissement
d’URLs pour obtenir un identifiant unique pour une URL d'entrée.
3.3.Utilisation de l'outil de raccourcissement d'url
L'utilisation du service web demande d'envoyer les paramètres d'une <URL d'entrée> ou un
<identifiant d'URL>.
Pour accéder au service web, il faut s'authentifier avec un utilisateur eStat.
Suivant l'adresse appelée sur le service web plusieurs actions peuvent être déclenchées avec l'<URL
d'entrée> ou un <identifiant d'URL>:



Par le point d'entrée https://ws.estat.com/pusz/rest/id, un identifiant d'URL est crée, pour
les informations d'une URL d'entrée passée en paramètre ;
Par le point d'entrée https://ws.estat.com/pusz/rest/url, une URL d'entrée est renvoyée, si
elle existe, pour l'identifiant passé en paramètre ;
Par le point d'entrée https://ws.estat.com/pusz/rest/<<identifiant d'URL>>, l'URL de
redirection correspondante est renvoyée.
3.3.1. Authentification
Pour utiliser le service web, vous devez vous authentifier.
Afin de vous authentifier, vous devez nous contacter afin de configurer un de vos utilisateurs
interface existant, ou afin de créer un nouvel utilisateur pour ce besoin. Une fois que vous aurez un
utilisateur habilité, il vous faudra utiliser l'authentification http BASIC à partir d'un programme pour
appeler le service web.
Exemple d'authentification
Tableau 8 : Exemple d'authentification
curl --user monuser:monmotdepasse https://ws.estat.com/pusz/rest/...
3.3.2. Créer une URL eStat raccourcie
Point d'entrée : https://ws.estat.com/pusz/rest/id
Il y a deux moyens d'accès pour créer une URL raccourcie :

En utilisant la méthode GET du service web, qui permet d'appeler le service en passant en
paramètre les caractéristiques de l'URL à raccourcir.
Le service web renvoi alors uniquement l'identifiant créé pour l'URL, ou un code d'erreur si la
création a échouée.
Si la demande est faite une deuxième fois avec exactement les mêmes informations, un
nouvel identifiant est créé.
Tableau 9 : Exemple d'utilisation en GET
curl --user monuser:monmotdepasse
https://ws.estat.com/pusz/rest/id?redirectUrl=http://www.monsite.fr/234/podcast.mp3&serial=241
041114203&level1=niveautest

En utilisant la méthode POST du service web, qui permet d'appeler le service en passant en
paramètre l'URL d'entrée à raccourcir sous forme XML ou JSON.
Tableau 10 : Exemple d'utilisation en XML
curl --user monuser:monmotdepasse --data-binary \
"<urlEntry xmlns="http://www.estat.com/pusz/schemas">
<level1>niveautest</level1>
<level2></level2>
<level3></level3>
<level4></level4>
<redirectUrl>http://www.monsite.fr/234/podcast.mp3</redirectUrl>
<serial>241041114203</serial>
</urlEntry>" \
https://ws.estat.com/pusz/rest/id
Tableau 11 : Exemple d'utilisation en JSON
curl --user monuser:monmotdepasse --data-binary
'{"u.redirectUrl":"http://www.monsite.fr/234/podcast.mp3","u.redirectType":"302","u.serial":"2410
41114203","u.level1":"niveautest","u.level2":"","u.level3":"","u.level4":""}' \
https://ws.estat.com/pusz/rest/id
3.3.3. Vérifier une URL raccourcie
Point d'entrée : http://ws.estat.com/pusz/rest/url
Il y a deux moyens d'accès pour vérifier une URL raccourcie :

En utilisant la méthode GET :
curl --user monuser:monmotdepasse https://ws.estat.com/pusz/rest/url?id=12345678574

En utilisant la méthode POST :
curl --user monuser:monmotdepasse --data-binary 'id=12345678574'
https://ws.estat.com/pusz/rest/url
4. Sous domaine de mesure
Nous proposons à nos clients de personnaliser le domaine utilisé pour la mesure eStat des Podcasts.
Par défaut, les domaines de mesure estat sont r.estat.com ou r.proxycast.org pour les urls
raccourcies et prof.estat.com pour les urls classiques.
Mais il est possible de remplacer le sous domaine par défaut "r" par le nom de votre entité "client"
ou "monsite" sur le domaine proxycast.org.
Nous proposons un sous domaine par client, à vous de choisir un sous domaine représentatif pour
l'ensemble de vos sites.
Exemple : "monsite.proxycast.org" ou "monentreprise.proxycast.org"
Pour procéder à cette personnalisation, merci de contacter le service client eStat :
[email protected]
5. Utilisation de variables
Il vous est possible d'utiliser des variables sur les différents formats d'urls d'un média.
Il est par exemple possible d'ajouter vos variables dès le départ lors de la création d'une URL
d'entrée. Par exemple, si ces variables définissent le média qui sera lu.
http://www.monsite.fr/234/podcast.mp3?file=456789
Vous pouvez aussi rajouter vos variables sur les urls raccourcies.
Par exemple des variables de session :
http://r.proxycast.com/12615808322391401193/podcast.mp3?session=456&lang=fr
A savoir, au final, toutes les urls que vous aurez renseignées se retrouveront concaténées sur l'url de
destination, une fois la redirection effectuée.
Par exemple :
http://www.monsite.fr/234/podcast.mp3?file=456789&session=456&lang=fr
6. Questions fréquentes
Authentification
Pourquoi je ne parviens pas à m'authentifier avec mon utilisateur eStat ?
Vous devez nous contacter au préalable afin que l'utilisateur que vous souhaitez utiliser soit
correctement configuré pour accéder au service web.
Génération d'un identifiant
Si une demande est faite avec exactement les mêmes entrées, l'identifiant existant sera renvoyé ?
Non, le service va créer une nouvelle entrée à chaque fois qu'il est sollicité.
Sous domaine
Est-il possible de cloisonner les redirections en fonction des sous domaines ?
Il n'est aujourd'hui pas possible de restreindre la mesure pour les identifiants utilisés avec un sous
domaine.
Mauvais identifiant
Si suite à la mise en place d'un sous domaine personnalisés, j'utilise l'identifiant d'un autre client, la
redirection se fera t'elle ?
La redirection se fera, même si le flux de destination n'est pas sur votre domaine.
Si par erreur j'utilise l'identifiant d'un de vos autres clients, cela sera-t-il pris en compte dans notre
fréquentation ?
Dans ce cas, la fréquentation sera rapportée au client ayant créé l'identifiant.
Que se passe t'il si j'utilise un identifiant qui n'existe pas ?
L'agrégateur recevra un code 404.
Que se passe t'il si une erreur de syntaxe se glisse dans mon identifiant ?
Idem que ci-dessus, l'agrégateur recevra un code 404.
Flux indisponible
Que se passe-t-il si l'adresse du flux n'est plus disponible ?
Lors de la redirection, le serveur de destination renverra un code 404, avec une page web affichant
l'erreur si elle est affichée dans l'agrégateur.
Variables d'url
Comment est-il possible d'ajouter des variables dans l'url raccourcie ?
Il vous suffit de coller les variables comme sur une adresse web classique et notre serveur de
redirection se chargera de transmettre ces variables. Il vous est aussi possible d'ajouter les variables
lors de la création de l'URL d'entrée.
Agrégateurs testés
Quels sont les agrégateurs que vous avez testés avec vos urls raccourcies ?
Nous avons testés les agrégateurs suivants :







iTunes
VLC
Winamp
Juice
Zune
Feedburner
Firefox
Les améliorations apportées par les urls raccourcies peuvent être remarquées surtout sur iTunes et
Zune.
Compatibilité entre mode de mesure/redirection eStat
Est-il possible d'utiliser les deux modes de redirections en parallèles ?
Oui, les deux modes cohabiteront, ils répondent à des attentes différentes, même si par précaution,
nous vous encourageons à utiliser le mode avec url raccourcie pour garantir une meilleure
compatibilité avec les agrégateurs.

Le Guide de marquage des Podcasts

Transcription

Documents pareils

Téléchargez l`affiche - La Course à la Fibre

Les erreurs 404 ou fameuses « pages introuvables

Patch Battlefield 2

Séance 4 - master EEI « projets européens

L`agrégateur de flux

The Open Graph Protocol

SINGER, Herbert T., LANG, Ossian, New York Freemasonry, A

VW-MPlate.com - VW Combi T2 Bay Window - M

Enregistrement Podcast

les redirections