Téléchargement des données produits

De Wiki.zanox.com.

Sommaire

Avant-propos

Le réseau d'affiliation zanox vous permet d'avoir accès à plus de 70 millions de références produits de plus de 1 000 annonceurs. Vous pouvez utiliser les données produits actualisées pour booster la pertinence marketing et l'orientation commerciale de votre site. Vous pouvez télécharger les données produits sous forme de fichiers XML ou CSV, dont vous pouvez configurer la structure.

Nouvelles fonctionnalités

De nombreuses fonctionnalités ont été implémentées au nouveau système de téléchargement des données produits – disponible en version BETA. Découvrez ci-dessous un aperçu des points les plus importants.

Un nombre de téléchargements illimité
Jusqu'à présent, l'accès aux données produits était limité à un nombre de téléchargements restreint par jour. Désormais, la nouvelle version du système n'a plus de limite de téléchargement. Les données produits peuvent être téléchargées pour chaque programme chaque fois que vous le souhaitez.

Contenu enrichi grâce à de nouvelles variables
Les paramètres de téléchargement ont été élargis dans cette nouvelle version. Parmi les innovations les plus importantes on trouve le nouvel identifiant produit zanox – un identifiant unique qui reste le même à chaque mise à jour des données –, l’arborescence homogène des catégories par zanox ou encore le paramètre ISBN qui spécifie le numéro ISBN d'un produit.

Nouvelles valeurs par défaut
Dans le nouveau système de téléchargement, des modifications ont été apportées aux valeurs par défaut pour certains paramètres. Par exemple, les colonnes des fichiers CSV sont désormais séparées par des virgules.

Attribution de noms de fichiers distincts
Avec le nouveau système de téléchargement, les noms de fichiers ne sont plus fixes mais sont générés dynamiquement, selon la répartition suivante :

  • zxpd_[creation date]_[programme ID]_[partner ID].[file suffix]
  • Exemple: zxpd_200911061016_184x_9163470C1876294956.csv

Désormais, en lisant simplement le nom du fichier, vous savez le jour où il a été généré, le programme et le partnerID concernés. De plus, cela permet d’éviter que le fichier antérieurement téléchargé soit écrasé par le fichier mis à jour.

Procédure

Les programmes permettant le téléchargement de données produits sont marqués dans l'aperçu programmes d'une disquette verte Image:Download_icon_green.jpg. La disquette orange juxtaposée au nom d'un programme Image:Download_icon_orange.jpg indique quant à elle que les données produits sont en cours de mise à jour par l'annonceur.

NB : Le téléchargement de données produits est possible même lorsque la disquette est de couleur orange.  Toutefois, vous devez garder à l’esprit que les données téléchargées ne
seront pas à jour.
NB : L'icône disquette est également utilisée dans la recherche programmes pour indiquer les programmes qui proposent un catalogue-produits. 

En cliquant sur l'icône disquette dans l'aperçu programme, vous pourrez accéder à la page dédiée à la nouvelle version du téléchargement des données produits (BETA). Sur cette page, vous pourrez choisir le format de téléchargement du fichier par le biais des onglets Get XML file et Get CSV file. Dans l'onglet Get update date, vous pouvez afficher la date de dernière mise à jour des données produits par l'annonceur.

Image:pdd_xml_en.jpg

Formats

Vous pouvez télécharger les données produits aux formats suivants :

  • XML
  • CSV

En renseignant votre ID partenaire et vos paramètres de configuration, vous pourrez accéder aux données souhaitées sous forme de fichier ou de lien de téléchargement. Vos paramètres de configuration auront une incidence sur la composition de l'URL transférée dans le lien de téléchargement.

Exemple de fichier XML

Un fichier de données produits au format XML se présentera comme suit :

<?xml version="1.0" encoding="utf-8"?>
<products xmlns="http://zanox.com/productdata/exportservice/v1" xmlns:xsi=http://www.w3.org /2001/XMLSchema-instance 
xsi:schemaLocation="http://zanox.com/productdata/exportservice/v1 http://productdata.zanox.com/exportservice/schema/export-1.0.xsd">
 <product zupid="a443c4be993c32b040ea6dafd6032a614e1f12334225">
    <name>Starthilfekabel 16 mm²</name>
    <program>1841</program>
    <number>AB0007</number>
    <shortDescription>Sicherheits-Starthilfekabel</longDescription>
    <price>14.99</price>
    <shippingHandling>1-2 Werktage</shippingHandling>
    <shippingHandlingCost>4.98</shippingHandlingCost>
    <lastModified>2009-10-30T10:29:00</lastModified>
    <currencyCode>EUR</currencyCode>
    <zanoxCategoryIds><id>10000</id></zanoxCategoryIds>
 </product>
</products>

Vous pouvez trouver le schéma XML à l'URL suivante : http://productdata.zanox.com/exportservice/schema/export-1.0.xsd.

NB : Si nécessaire, vous avez la possibilité de transformer le fichier XML avec l'aide d'un langage de transformation (ex: XSLT).

Exemple de fichier CSV

Un fichier de données produits au format CSV se présentera comme suit :

"Zupid","ProgramId","MerchantProductNumber","ProductName","ProductPrice","ProductPriceOld", "CurrencySymbolOfPrice","UpdateDate","ValidFromDate","ValidToDate","ProductShortDescription","ProductLongDescription", "ProductEAN","MerchantProductCategory","ZanoxProductIds","ImageSmallURL","ImageMediumURL", "ImageLargeURL","ProductManufacturerBrand","ZanoxProductLink","ZanoxProductCategoryNumber", "MerchantProductCategoryNumber","DeliveryTime","TermsOfContract"

"000000000","000","000000000","Produktname","14.90","","EUR","2006-04-27T12:00:00:000","","", "Produktkurzbeschreibung","Produktbeschreibung","","Betreiberhauptkategorie / Betreiberunterkategorie","", "http://www.betreiber.de/ Produktbilder/produktbild.jpg","http://www.betreiber.de/ Produktbilder/produktbild_mittel.jpg", "","Betreiber Kategorie","http://www.zanox-affiliate.de/ppc/?00000000000000000T&ULP=[[000000000]]","","","",""

Affichage de la dernière date de mise à jour

La mise à jour des données produits est gérée par l’annonceur. À cet égard, la date et la fréquence des mises à jour sont entièrement dépendantes de l'annonceur. La plupart des annonceurs réalisent des mises à jour mensuellement, hebdomadairement ou quotidiennement.

NB : Il est préférable que tout téléchargement soit exécuté après que l'annonceur ait effectué une mise à jour de ses données produits. 

Veillez à bien suivre les mises à jour faites pour les programmes auxquels vous êtes inscrit.

Documentation PDF

Une documentation complète sur le téléchargement de données produits est également disponible en version PDF.

Image:Icon_Download.gif Télechargez le document au format PDF (en anglais).
Outils personnels
Autres langues