Article

Éditeurs : récupérer et utiliser un flux produits tracké

Découvrez les articles les plus lus

Un flux produits est le catalogue d’une marque : ses produits, leurs prix, leurs images et leurs disponibilités, dans un fichier qu’elle tient à jour. Sur Affilae, vous n’utilisez pas ce fichier tel quel. Vous en récupérez une version trackée, dans laquelle chaque lien produit porte déjà votre identifiant d’affilié : toutes les ventes réalisées depuis ces liens vous sont attribuées, sans créer un seul lien à la main.

Prérequis : un partenariat validé avec la marque, et un flux produits qu’elle a mis à votre disposition. Toutes les marques n’en proposent pas.

À quoi sert un flux tracké

Afficher tout un catalogue. Comparateur de prix, moteur de recherche produits, site de bons plans ou boutique affiliée : vous intégrez des centaines ou des milliers de produits d’un coup.
Gagner du temps. Tous les liens produits sont déjà trackés. Vous n’avez rien à créer dans le Générateur de liens.
Rester à jour. Le flux tracké est fabriqué à partir du catalogue de la marque au moment où vous le téléchargez. Les prix, les stocks et les promotions suivent ses mises à jour.
Être commissionné normalement. Un clic sur un lien du flux est un clic tracké comme les autres, soumis aux règles de commission de votre partenariat.

Où trouver vos flux

GESTION DE MES PROFILS

Mon Blog

Configuration

Mes partenariats

Element pubs

Eléments créatifs

Flux produits

Codes promo

Côté éditeur, la page « Flux produits » se trouve sous « Element pubs », dans le menu du profil.

Dans la barre latérale, sous Gestion de mes profils, cliquez sur le nom de votre profil.
Dépliez Element pubs et cliquez sur Flux produits.
Le tableau liste les flux des marques avec lesquelles vous êtes partenaire, avec les colonnes Programme, Titre, Créé le, Format, URL et Statut. Le champ de recherche filtre la liste par nom de programme.

la colonne URL avec ses deux lignes « URL du flux » et « URL flux tracké », plus la colonne Statut

Vous ne voyez que les flux que la marque a partagés avec vous : elle peut réserver un flux à certains partenaires. Les flux d’un partenariat encore en attente de validation n’apparaissent pas. Un flux au statut Inactif n’est plus diffusé par la marque.

Une marque peut vous prévenir par e-mail quand elle met un flux à votre disposition. Vous recevez aussi un e-mail quand elle active ou désactive un flux qui vous concerne, avec un lien vers cette page.

Les deux adresses de chaque flux

Dans la colonne URL, chaque flux affiche deux lignes, chacune avec son bouton de copie :

URL du flux : le fichier d’origine de la marque. Ses liens ne sont pas trackés. Ne l’utilisez pas pour publier, vos ventes ne vous seraient pas attribuées.
URL flux tracké : la version à utiliser. Elle est propre à votre partenariat et ses liens produits portent votre identifiant d’affilié.

L’URL flux tracké ressemble à ceci :

https://feeds.affilae.com/api/feed/affilae/builder?url=…&partnershipId=…&encoding=UTF-8&separator=,&format=csv

À noter : si la ligne URL flux tracké affiche un tiret, la marque n’a pas terminé le paramétrage de son flux. Il apparaît alors comme Inactif et ne peut pas encore être utilisé.

Ce que contient le flux tracké

Le même fichier que celui de la marque : même format (CSV, XML ou JSON), même encodage, mêmes colonnes.
Seul le lien de chaque fiche produit change. Il est remplacé par un lien tracké à votre nom, construit selon les réglages du programme, comme un lien du Générateur de liens.
Les noms et le choix des colonnes sont ceux de la marque, ils varient d’un programme à l’autre. Repérez dans chaque fichier la colonne du lien produit : c’est elle qui porte le tracking.
Les liens du flux ne portent pas de SubID. Pour suivre un emplacement précis avec un SubID, créez ce lien avec le Générateur de liens.

Utiliser le flux dans vos outils

Copiez l’URL flux tracké avec son bouton de copie.
Collez-la dans votre outil : module d’import de votre site, comparateur, script, agrégateur de flux ou tableur. Indiquez-lui le format affiché dans la colonne Format.
Programmez une mise à jour automatique, par exemple une fois par jour, pour reprendre les nouveaux prix et les nouveaux produits de la marque.
Publiez les liens du flux tels quels. Ne les modifiez pas et ne les reconstruisez pas : un lien retouché peut ne pas enregistrer vos clics et vos ventes.

Astuce : avant de brancher votre outil, comparez un lien du flux tracké avec le même produit dans l’URL du flux. Ils sont différents : c’est le lien tracké qui vous attribue la vente.

Vous automatisez déjà vos outils ? La liste de vos flux et leurs URL trackées sont aussi disponibles par l’API Affilae.

À quel rythme le télécharger

Le flux tracké est fabriqué à chaque téléchargement, à partir du fichier de la marque. Le télécharger plus souvent que la marque ne met à jour son catalogue n’apporte rien : une fois par jour suffit en général.

Si vous relancez un téléchargement trop tôt, Affilae répond par le code A6, avec le délai à respecter avant de réessayer. Ce délai est aussi donné dans l’en-tête HTTP Retry-After.
Si votre outil gère l’en-tête HTTP ETag, renvoyez la valeur reçue dans l’en-tête If-None-Match de votre téléchargement suivant. Si le flux n’a pas changé, Affilae répond 304 Not Modified, sans fichier : vous n’avez rien à retélécharger, et cette réponse vous est faite même quand le téléchargement est rapproché. L’en-tête If-Modified-Since n’est pas pris en compte.
Un gros catalogue peut mettre un peu de temps à se télécharger. Laissez votre outil aller au bout, sans relancer le même téléchargement en parallèle (code A5).

Si le flux ne répond pas

Quand le flux tracké ne peut pas être fourni, Affilae renvoie un code et un message à la place du fichier. Les plus fréquents :

A2 : le fichier de la marque est en erreur. Rien à faire de votre côté, le flux redevient disponible dès qu’elle l’a corrigé. Si cela dure, prévenez-la depuis la messagerie.
A3 : votre partenariat n’est pas, ou plus, validé.
A6 : téléchargement trop rapproché, réessayez après le délai indiqué dans le message.
D25 : le flux a été désactivé, supprimé ou modifié par la marque. Retournez sur la page Flux produits et copiez à nouveau l’URL flux tracké, elle a pu changer.

Tous les codes sont détaillés dans Codes erreurs liés aux flux produits.

Bonnes pratiques

Utilisez toujours l’URL flux tracké, jamais l’URL du flux.
Si vous gérez plusieurs profils, copiez l’URL depuis le profil qui publiera les liens : chaque partenariat a sa propre URL trackée.
Affichez les prix et les disponibilités du dernier téléchargement. Un produit épuisé ou un prix périmé fait perdre la vente et la confiance de vos visiteurs.
Quand une marque désactive un flux, retirez ses produits de votre site plutôt que de laisser des offres qui ne sont plus à jour.

Cas d’usage

Un comparateur de prix. Il importe chaque nuit les flux trackés de dix marques et affiche leurs offres côte à côte. Chaque vente remonte au bon partenariat, sans un seul lien créé à la main.
Un blog de cuisine. Il construit sa sélection de la semaine à partir du flux d’une marque d’ustensiles. Les prix restent justes sans mise à jour manuelle.
Un site de bons plans. Il repère dans le flux les colonnes de promotion et de code promo, quand la marque les fournit, pour mettre en avant les offres du moment.

Articles liés

Questions
fréquentes

Trois raisons possibles : la marque ne propose pas de flux, elle l’a réservé à d’autres partenaires, ou votre partenariat est encore en attente de validation. Vous pouvez lui demander depuis la messagerie si un flux est prévu.

Pas pour publier. Ses liens ne sont pas trackés et vos ventes ne vous seraient pas attribuées. Utilisez toujours l’URL flux tracké.

Oui : même format, même encodage et mêmes colonnes. Seuls les liens des fiches produits sont remplacés par des liens trackés à votre nom.

Une fois par jour suffit en général : le flux tracké est fabriqué à chaque téléchargement à partir du fichier de la marque. Si vous le téléchargez trop souvent, Affilae répond par le code A6 avec le délai à respecter.

Non, les liens du flux ne portent pas de SubID, et ils ne doivent pas être modifiés. Pour suivre un emplacement précis avec un SubID, créez ce lien avec le Générateur de liens.

La marque n’a pas terminé le paramétrage de son flux, qui ne peut pas encore être fourni en version trackée. Le flux apparaît alors comme Inactif. Il deviendra utilisable quand la marque aura complété sa configuration.