recommandations concernant la fourniture de flux RSS

Note d’application
Annonceurs :
recommandations
concernant la
fourniture de flux RSS
pour Reactivpub
Version 1.0.1
Introduction
Objet
Reactivpub, plateforme d’affiliation basée sur la technologie R-ADServer
développée par la société R, permet de mettre en relation des affiliés (ou
diffuseurs : sites internet souhaitant rentabiliser leur espace publicitaire), et
des sites annonceurs souhaitant vendre ou promouvoir leurs produits.
Il existe différents modèles techniques et économiques de diffusion publicitaire
qui divergent notamment au niveau de leur mise en œuvre.
Ce document, destiné aux annonceurs de la plateforme Reactivpub, présente
les avantages et les aspects techniques de la mise en place d’un flux RSS dans
le cadre d’une campagne.
A qui s’adresse ce document ?
Ce document est destiné aux annonceurs (ou futurs annonceurs) de la
plateforme Reactivpub souhaitant diffuser leurs offres ou produits par le biais
de flux RSS.
Avertissements
Malgré tout le soin apporté à sa vérification, ce document peut comporter
certaines erreurs. Nous vous invitons à nous transmettre toute remarque ou
commentaire à l’adresse [email protected]
Les informations contenues
modifiées sans préavis.
dans
ce
document
sont
susceptibles
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
d’être
2
Flux RSS
Qu’est-ce que RSS ?
RSS (Really Simple Syndication) est un format de syndication de contenu Web.
La syndication de contenu consiste à mettre à disposition des utilisateurs de
l’information (comme de l’actualité, des annonces promotionnelles, ou une
partie du contenu d’un site internet) sous une forme précise et facilement
exploitable.
RSS est le plus souvent utilisé dans un « flux RSS » qui désigne simplement un
fichier au format RSS généré et mis à disposition du visiteur à sa demande.
RSS
•Actualités
•Médias
•Société •...
RSS
RSS
Techniquement, RSS désigne un ensemble
XML. Tout fichier au format RSS doit être
du World Wide Web Consortium (W3C,
respect des standards est un élément clé
données au format RSS.
•Bon plans
•Promotions
•Voyages
•...
•Culture
•Sport
•Sciences •...
de formats reposant sur le standard
conforme à la spécification XML 1.0
http://www.w3c.org). Notez que le
à respecter lors de la fourniture de
Dans la suite de ce document, nous utiliserons le terme « flux RSS » pour
décrire le format d’un flux ou d’un fichier respectant le format RSS.
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
3
Exemple de flux RSS
Voici un exemple de flux RSS :
<?xml version="1.0"?>
<rss version="2.0">
<channel>
<title>Le titre de mon flux RSS</title>
<link>http://www. site.fr/</link>
<description>Description de mon site.</description>
<item>
<title>Mon premier produit</title>
<link>http://www.site.fr/article/premierproduit.php</link>
<description>Description premier produit</description>
<pubDate>Date d’ajout au catalogue</pubDate>
</item>
<item>
<title>Mon deuxième produit</title>
<link>http://www.site.fr/article/deuxiemeproduit.php</link>
<description>Description deuxième produit</description>
<pubDate>Date d’ajout au catalogue</pubDate>
</item>
</channel>
</rss>
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
4
Structure et contenu d’un
flux RSS
Nous vous présenterons ici uniquement les principaux éléments possibles pour
un flux RSS. Vous pouvez cependant retrouver l’intégralité des paramètres
autorisés en consultant la spécification du format RSS 2.01 sur
http://www.scriptol.fr/rss/RSS-2.0.html
Note :
Certains paramètres considérés comme facultatifs dans les spécifications
officielles peuvent cependant être obligatoires pour diffuser sur notre réseau.
Ils seront donc présentés comme obligatoires dans cette documentation.
Structure générale
Un flux RSS est principalement composé :
-
D’un entête composé d’éléments indiquant la version de XML et RSS
relatives au contenu de votre flux. Nous vous conseillons d’utiliser les
valeurs suivantes :
<?xml version="1.0"?>
<rss version="2.0">
…
</rss>
-
Du contenu du flux proprement dit, décrit dans l’élément <channel>
et ses sous-éléments :
o
Eléments décrivant les
(<title>, <link> …)
caractéristiques
générales
o
Eléments <item> décrivant chaque article présent dans le flux
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
du
flux
5
Element de <channel> (description du flux)
Ces éléments sont à placer au dessous de <channel> et avant la première
balise <item>.
Les éléments suivant sont obligatoires :
Eléments
Rôle, valeurs possibles
obligatoires
title
Définit le titre de votre flux RSS
Exemple :
<title>Le titre de mon flux RSS</title>
link
Définit L'URL de votre site web
Exemple :
<link>http://www.monsite.fr/</link>
description
Doit contenir une description de vos prestations
Exemple :
<description>Description de mon
site</description>
Les éléments suivant sont facultatifs :
Eléments
Rôle, valeurs possibles
facultatifs
image
Permet d’insérer votre logo dans votre flux RSS.
L’image doit être au format GIF, JPEG ou PNG.
Exemple :
<image>
<url>
http://www.monsite.fr/monimage.gif</url>
<width>500</width>
<height>120</height>
<link> http://www.monsite.fr/</link>
</image>
language
Permet de définir la langue de votre flux RSS.
Exemple :
<language>fr</language>
ttl
Nombre de minutes qui indique combien de temps un flux
peut demeurer en mémoire ou en cache avant qu'il ne soit
rafraîchi à partir de la source. Par exemple, si vous
regénérez votre flux toutes les heures, spécifiez un ttl à 60
afin de limiter le nombre de requêtes sur vos serveurs.
Exemple :
<ttl>60</ttl>
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
6
Eléments de <item> (description des articles)
Chacun de vos produits/articles doit être représenté par un élément <item>.
Les éléments décrits ci-dessous sont à placer dans chaque balise (entre
<item> et </item>). Votre flux peut contenir autant d’éléments <item> que
vous le souhaitez mais plus le nombre sera important, plus le temps d’affichage
et de traitement de votre flux sera long.
Les éléments suivant sont obligatoires :
Eléments
Rôle, valeurs possibles
obligatoires
title
Définit le nom de l’item (=de l’article, du produit).
Exemple :
<title>Le nom de mon produit</title>
link
Définit L'URL vers votre produit.
Exemple :
<link>http://www.monsite.fr/monproduit.php<
/link>
description
Doit contenir une description de cet item.
Cet élément peut contenir du code HTML à condition d’être
encadré par des délimiteurs de section CDATA.
Exemple :
<description>
<![CDATA[<div>Description
produit.</div>]]>
</description>
Les éléments suivant sont facultatifs :
Eléments
Rôle, valeurs possibles
facultatifs
pubDate
Définit la date d’ajout de cet item au flux (ou date de
création du produit).
Ce champ est utilisé pour déterminer quels sont les items
nouvellement ajoutés au flux. Il est préférable de le spécifier
au format MM/JJ/AAAA (pour le 20 septembre 2007 :
09/20/2007)
Exemple :
<pubDate>09/20/2007</pubDate>
category
Définit la catégorie de l’item. Il peut s’agir du pays pour un
voyage ou d’une catégorie de produit (téléviseur, chemise)…
Certains programmes comme Internet Explorer 7 fournissent
des fonctionnalités permettant de trier les items du flux en
fonction de leur category.
Exemple :
<category>Chemises</category>
guid
Permet de définir un identifiant unique pour le produit (une
référence par exemple). Cet élément est utilisé par certains
aggrégateurs pour déterminer quels sont les nouveaux
items.
Exemple :
<guid>01555EM222A</guid>
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
7
Conseils pour la création de
vos flux
Dans votre intérêt :
-
Ne générez pas aléatoirement les produits constituant votre flux. Cela
aurait pour conséquences de ne pas pouvoir détecter les nouveaux
produits.
-
Bien qu’un flux puisse en théorie contenir un nombre important
d’articles, il est préférable de créer plusieurs flux spécialisés avec peu
de produits (les ventes flash, les promos, un flux par catégorie) plutôt
que de tout regrouper dans un seul flux. Le nombre de flux possible
n’est pas limité.
Annonceurs - Recommandations concernant la fourniture de flux RSS pour Reactivpub
8