Outils : API et flux

Augmentez vos revenus à l'aide de l'API

Augmentez vos revenus à l'aide de l'API L'API (Application Programming Interface) figure parmi les outils d'eBay Partner Network les plus puissants à votre disposition. Elle permet en effet d'accéder à l'ensemble de votre inventaire eBay et de personnaliser vos annonces afin d'optimiser vos campagnes et d'améliorer vos taux de conversion.

Les éditeurs qui possèdent des connaissances approfondies en programmation peuvent utiliser l'API pour personnaliser entièrement l'expérience utilisateur et optimiser leurs performances. Voici quelques conseils :

Que peut-on faire avec l'API ?

L'API est l'outil le plus ouvert et le plus puissant pour la personnalisation des annonces eBay référencées sur votre site. Elle permet également d'intégrer les rapports d'eBay Partner Network à vos propres systèmes pour contrôler plus facilement vos performances.

Personnalisation des annonces eBay

Vos pouvez utiliser l'API pour personnaliser les annonces eBay en fonction de différents filtres et optimiser ainsi vos performances. Elle propose plusieurs types d'appels et de filtres destinés à vous aider à identifier la combinaison idéale pour vos visiteurs.

Par exemple, un site Web de comparaison de prix peut recourir à l'API pour afficher les produits eBay proposés par des Vendeurs Top Fiabilité, au-delà d'un certain montant et avec la livraison gratuite. Une telle intégration peut entraîner une augmentation considérable des taux de conversion.

Comment peut-on accéder à l'API ?

Vous devez d'abord vous inscrire au Programme des développeurs à la page suivante. Une fois votre inscription acceptée, accédez à la section « My Account », puis cliquez sur « Generate Productions Keys » pour obtenir un code d'application.

Sélectionnez ensuite un appel, consultez l'exemple de code, puis testez votre code d'application.

Vous pouvez alors créer votre application, la tester et la soumettre au Programme eBay des développeurs pour approbation. Une fois votre application approuvée, vous pourrez effectuer jusqu'à 5 000 requêtes quotidiennes par adresse IP. Pour plus de détails, consultez la liste de contrôle préalable à la mise en ligne (en anglais).

Quelles sont les différentes API disponibles ? Comment faut-il procéder pour filtrer les annonces ?

Nous mettons à votre disposition plusieurs API. Les plus populaires sont l'API Finding et l'API Shopping.

API Finding

L'API Finding permet de rechercher des objets au moyen de la plateforme de recherche d'eBay. Elle intègre des fonctions de recherche avancée pour les objets eBay, tout en proposant des métadonnées pratiques permettant d'affiner les résultats de recherche et d'améliorer l'expérience lors de la recherche.

Appels disponibles dans l'API Finding :

API Shopping

L'API Shopping est optimisée pour la taille, la vitesse et la convivialité des réponses. Vous pouvez faire appel à l'API Shopping pour rechercher des objets, des produits et des avis sur eBay, des informations sur les membres ou encore pour identifier les objets les plus recherchés. Vous pouvez également récupérer les données eBay publiques dans un affichage optimisé pour les acheteurs, ce qui simplifie leur utilisation par les widgets, les outils de recherche et les autres applications orientées acheteurs.

Appels disponibles dans l'API Shopping :

Autres API

D'autres API sont proposées pour vous aider à créer des contenus et des niveaux de personnalisation exceptionnels pour vos utilisateurs :

  • API Merchandising - Cette API permet de faire ressortir facilement les objets et produits qui présentent un bon rapport qualité-prix et qui sont populaires auprès des acheteurs eBay
  • API Trading - Propose un accès sécurisé et authentifié aux données privées sur eBay
  • API Best Match - Permet de comprendre les facteurs clés qui affectent le classement des résultats en cas de tri par pertinence

Nous espérons que vous aurez trouvé cet article utile. Si vous estimez qu'une présentation plus détaillée de l'API s'avère nécessaire, faites-le-nous savoir ! N'hésitez pas à publier vos commentaires ci-dessous. Nous nous ferons un plaisir de répondre à vos questions.

eBay Partner Network TV : Présentation de Matthias Klappenbach, chef de produit senior

Matthias  

Cette semaine sur eBay Partner Network TV, nous avons le plaisir d'accueillir notre chef de produit senior, Matthias Klappenbach. Matthias a rejoint l'équipe SEO d'eBay basée en Allemagne il y a cinq ans et demi. Il s'est ensuite transféré aux Etats-Unis en 2009 et a rejoint eBay Partner Network au second semestre 2012.

« Nous avons beaucoup de pain sur la planche cette année, mais notre priorité est de simplifier le produit pour les éditeurs », a déclaré Matthias. « Nous savons que certains outils ne fonctionnent pas bien aujourd'hui. Nous devons donc simplifier notre gamme d'outils. Nous voulons que nos outils soient plus efficaces et en général, nous souhaitons améliorer l'expérience des éditeurs en ce qui concerne les produits. »

Nous sommes vraiment ravis d'avoir dans notre équipe quelqu'un comme Matthias qui apporte un tel niveau d'expertise et de dévouement. Non seulement Matthias s'appuie sur notre équipe interne pour planifier notre gamme de produits, mais il lit aussi souvent les commentaires des éditeurs sur le blog, les forums et Twitter.

« Chaque semaine, je passe du temps à lire les commentaires des éditeurs, et nous les prenons vraiment en compte. Je pense que nous avons de bons moyens de communiquer avec les éditeurs, mais nous continuons à réfléchir aux améliorations que nous pouvons apporter et peut-être trouver de meilleures solutions. »

N’hésitez pas à nous laisser vos commentaires !

Conseils pour une année 2013 rémunératrice | Présentation des outils

ePN_Tools_FR

Vous trouverez ci-dessous une courte liste d'outils pour vous aider à rentabiliser au mieux l'année 2013, et ce, dès le début. Cette liste fournit un aperçu des outils les plus importants d'eBay Partner Network et des applications possibles. Ces outils vous permettront d'améliorer la qualité de votre trafic tout en optimisant votre intégration à eBay.

Utilisation du Générateur de liens pour créer des liens vers des offres spéciales sur eBay

Outil polyvalent et convivial, le Générateur de liens (accessible sur eBay Partner Network à la section Outils > Générateur de liens) permet de créer des liens textuels simples et de générer rapidement et en toute simplicité du code HTML/JavaScript pour rediriger les utilisateurs vers les pages de destination eBay de votre choix.

Comme vous l'avez peut-être déjà remarqué, le champ « Texte du lien » est facultatif. Si vous avez simplement besoin d'un code pour associer du contenu textuel, des images ou des vidéos à une URL individuelle, vous pouvez ignorer ce champ.

Link generator_FR

Si vous souhaitez intégrer le code HTML à plusieurs endroits, mais pour des pages de destination eBay différentes, vous pouvez toujours réutiliser le code de base et remplacer les URL cibles individuelles respectives dans le code (après « mpre= »). Au besoin, vous pouvez aussi modifier l'identifiant de la campagne et l'identifiant personnel dans le code. Vous trouverez également de plus amples informations à ce sujet dans cet article du blog.

Utilisation de la Bannière Personnalisée pour intégrer facilement des offres eBay en cours

L'outil Bannière Personnalisée d'eBay (Outils > Widgets > Bannière Personnalisée) permet d'intégrer facilement une bannière Flash individuelle affichant des offres eBay en cours pertinentes par rapport au contenu de vos pages. Il s'agit d'une bannière attrayante dont la mise à jour est automatique et qui offre la possibilité de cibler des groupes d'utilisateurs de manière plus efficace.

Pour utiliser la Bannière Personnalisée, commencez par sélectionner une mise en page parmi les différents modèles proposés. Vous pouvez définir la taille de la bannière et le style de ses éléments individuels.

custom banner_FR

Définissez ensuite le contenu de la bannière. Vous pouvez diriger le contenu à afficher pour votre groupe cible en fonction de mots-clés positifs et négatifs, de catégories, de vendeurs, de catégories de prix, etc. Une fois la configuration de votre bannière terminée, le code nécessaire à son intégration sera généré automatiquement.

custom banner_2_FR

Uilisation du Générateur d'éléments graphiques pour créer un logo ou des bannières à champs de recherche.

Pour cela aussi, vous disposez de plusieurs options de configuration, comme la taille et le type de bannière. Depuis la mi-janvier, des éléments graphiques affichant le nouveau logo eBay et intégrant une technologie optimisée destinée à améliorer l'expérience utilisateur sont disponibles. Au cours de ce déploiement, les éléments graphiques les plus utilisés ont été mis à jour automatiquement dans notre système et chargés sur les pages de nos partenaires par distribution push. Si, contre toute attente, vous trouvez encore d'anciens éléments graphiques sur vos pages, veuillez les mettre à jour avant le 28 février. Après cette date, il ne sera plus possible d'afficher les anciens éléments graphiques.

Utilisation de l'API d'eBay pour générer davantage de trafic de haute qualité

Pour les plus technophiles d'entre vous, l'API d'eBay est un outil particulièrement utile. En effet, cette interface de programmation vous donne accès à la vaste la base de données d'eBay. L'API permet à votre site Web ou à votre application d'accéder aux informations enregistrées, comme les détails sur les produits ou les vendeurs, en interrogeant la base de données d'eBay en temps réel.

Pour pouvoir intégrer l'API eBay, vous devez d'abord vous inscrire sur le portail des développeurs eBay. Vous recevrez ensuite un code d'application individuel qui vous permettra d'accéder aux données actuellement répertoriées sur eBay. Une fois cette étape terminée, vous pouvez générer les appels API de votre choix.

Vous pouvez créer des appels simples à l'aide de l'API eBay Finding. L'API Finding permet de filtrer les données par catégories, mots-clés et vendeurs pour trouver exactement ce que vous cherchez. Pour de plus amples informations à ce sujet, consultez le portail des développeurs.

Une fois que vous avez généré l'appel API, vous devez convertir les informations fournies par l'appel dans un format lisible pour les visiteurs de votre site Web. En général, vous avez la possibilité de demander le renvoi de données au format JSON, SOAP, XML ou texte. Pour obtenir davantage d'informations de base sur l'utilisation de l'API, consultez ce document.

Nous espérons que cette présentation des outils vous aidera à intégrer le contenu eBay à vos pages de manière optimale et à cibler les groupes d'utilisateurs souhaités afin de générer du trafic de haute qualité vers eBay et d'être rémunéré en conséquence. Si vous avez des questions ou des suggestions à ce sujet, n'hésitez pas à les publier ci-dessous !

 

Fin de la prise en compte des recherches avec astérisques

MISE A JOUR 30/10/12: Nous avons pris en compte vos retours et avons travaillé en interne pour trouver des solutions pour ceux d’entre vous qui ont été impactés par la fin de la prise en compte de la recherche avec astérisques. Concrètement, nous avons pu reporter la fin de cette prise en charge jusqu’au 5 novembre. La date butoir du 5 novembre concernera les pays suivants : US, UK, Autralie, Italie, France et Canada. La mise à jour pour le reste de l’Europe, sauf pour l’Allemagne, prendra effet à partir de mi-novembre. Pour l’Allemagne, la date limite pourrait se situer en janvier 2013. Nous espérons que cela donnera aux éditeurs concernés plus de temps pour mettre à jour leurs requêtes et minimiser d’éventuelles conséquences négatives sur leurs activités. En parallèle, nous sommes actuellement en train de travailler avec notre équipe produits sur une FAQs que nous espérons publier dans les prochains jours.

Vous êtes nombreux à demander s'il serait possible de continuer à utiliser des astérisques dans les recherches effectuées sur les outils comme l'API Finder ou dans les flux RSS. Nous regrettons que cela ne soit plus possible à partir du 29 octobre 2012. Cette fonctionnalité permettait aux utilisateurs d'ajouter un astérisque à leur mot-clé afin d'inclure toutes les variantes orthographiques d'un objet. Ainsi, le mot-clé « ip* » permettait d'afficher les annonces dont le titre contenait les mots « ipod, ipods, ipad, ipads, ipadd », etc. dans les résultats de recherche. eBay ne prend pas plus en charge les recherches avec un astérisque en raison des récentes modifications apportées au moteur de recherche qui prend déjà en compte de nombreuses variantes orthographiques. Par ailleurs, les résultats de recherche sont désormais affichés plus rapidement et plus efficacement.

Nous sommes conscients des dérangements qui seront causés à certains d'entre vous.

Nous ne pouvons pas revenir sur la fin de la prise en charge des recherches avec astérisque ou le calendrier établi par eBay. Cependant, veuillez nous excuser pour le manque de communication concernant ce changement. Nous cherchons à comprendre comment cela a pu se produire et nous nous engageons à améliorer notre manière de communiquer avec nos partenaires à l’avenir.

 Nous vous remercions de votre collaboration et nous vous prions de nous excuser pour les gênes occasionnées par le manque de préavis.

Modification des catégories d'eBay

eBay a mis a jour ses catégories le lundi 10 septembre. Cette mise à jour affecte les éditeurs qui ajoutent des numéros de catégorie dans les bannières personnalisées, les flux RSS, le Générateur de liens ou tout widget offrant l'option d'inclure des numéros de catégorie.

Les catégories mises à jour sont les suivantes :

  • Art, Antiquités
  • PME, Artisans, Agriculteurs
  • Photo, Caméscopes
  • Vêtements, Accessoires
  • Monnaies
  • Informatique, Réseaux
  • Image, Son
  • DVD, Cinéma
  • Auto, Moto
  • Beauté, Bien-être, Parfums
  • Maison, Jardin, Bricolage
  • Bijoux, Montres
  • Musique, CD, Vinyles
  • Instruments de musique
  • Services
  • Jeux, Jouets, Figurines
  • Tout le reste

Vous trouverez plus de détails sur les modifications ici.

Ces changements impactent de nombreux sites eBay dans le monde, notamment : US, CA, UK, AU, AT, FR, DE, Motors, IT, BENL, NL, ES, CH, IN, IE et CAFR. En tout, entre 30 et 50 millions d'objets ont changé de catégorie au cours de cette mise à jour. Pour plus d'informations, vous pouvez consulter les Nouveautés vendeurs prévues à l'automne 2012.

Vous avez des questions sur ces changements ? N'hésitez pas à laisser vos commentaires ci-dessous.

Notification finale concernant la migration vers la version RSS 2.0 – Délai : 31 mai

Comme annoncé par e-mail et sur notre blog (ici et ici), la version RSS 1.0 est désormais obsolète et n'est donc plus prise en charge. Le délai pour la migration vers le système RSS 2.0 est fixé au 31 mai 2012. Après cette date, la version RSS 1.0 ne sera plus en service. Les éditeurs qui utilisent le système RSS 1.0 devront migrer vers la version RSS 2.0 avant cette date pour éviter toute interruption de service.

Nous avons reçu un certain nombre de questions relatives au processus de migration. Par conséquent, nous avons compilé quelques documents utiles, notamment plusieurs articles de blog qui peuvent faciliter cette migration :

Les éditeurs utilisant WordBay, phpBay et BANS trouveront à la fin de cet article des informations complémentaires concernant la compatibilité de la version RSS 2.0.

Enfin, si vous pensez être déjà passé à la version RSS 2.0, mais que vous souhaitez vérifier, comparez les structures URL ci-dessous avec le début des URL que vous utilisez :

  • RSS 2 : http://rest.ebay.com/...
  • RSS 1 : http://rss.api.ebay.com/ws/rssapi...

Nous espérons vous avoir fourni toutes les informations utiles pour que vous puissiez correctement opérer la migration vers la version RSS 2.0 avant le 31 mai. Pour toute question, contactez le Service clients qui se fera un plaisir de vous aider.

N'hésitez pas à laisser vos commentaires ou vos questions d'ordre général dans la section des commentaires ci-dessous.

Conseils pour des stratégies de recherche efficaces avec le Générateur de flux RSS

Depuis la mise en œuvre du système RSS 2.0 sur eBay Partner Network en mai 2011, nous avons passé en revue les caractéristiques de vos requêtes RSS et les résultats renvoyés. Nous avons identifié plusieurs cas de figure où il est possible d'obtenir des résultats plus pertinents en adaptant légèrement vos requêtes.

Limitez les expressions-clés à moins de 100 caractères Lorsque les expressions-clés sont très longues, les résultats s'avèrent parfois un peu étranges même si la requête peut être exécutée. En limitant les mots/expressions-clés à environ 100 caractères, vous obtiendrez des résultats plus pertinents. La limite suggérée à 100 caractères concerne à la fois l'inclusion et l'exclusion de mots-clés.

Combinez les mots-clés en expressions et évitez les articles, les pronoms, les conjonctions et les prépositions Lors de la sélection des mots-clés, combinez-les autant que possible en expressions en plaçant celles-ci entre guillemets doubles. Veillez en outre à soigner votre orthographe, et utilisez des substantifs et des adjectifs lorsque cela est possible. Evitez d'utiliser des articles (un, le…), des pronoms (il, elle…), des conjonctions (et, ou…) ou des prépositions (vers, à…) dans vos requêtes.

L'exemple ci-dessous illustre l'utilisation d'une expression-clé :

(GPS de sport et portable, GPS pour véhicule, GPS et navigation, GPS pour auto, GPS avec trafic et carte)-TomTom

http://rest.ebay.com/epn/v1/find/item.rss?keyword=%28sports+and+handheld+GPS%2Cvehicle+GPS%2CGPS+and+Navigation%2CAuto+GPS%2CGPS+with+Traffic+and+Map%29+-Tomtom&categoryId1=3270&sortOrder=BestMatch&programid=1&campaignid=5336539146&toolid=10039&listingType1=All&lgeo=1&feedType=rss

Cette requête vise à renvoyer des résultats concernant des systèmes GPS, en excluant les annonces dont le titre contient le mot-clé « TomTom ».  Il serait possible d'améliorer les résultats de cet exemple en ajoutant des mots-clés à occurrences multiples, comme « GPS portables », entre guillemets doubles :

(GPS Trafic Cartes,”GPS+Auto”,”GPS+Véhicule”,”GPS portable”)-TomTom

http://rest.ebay.com/epn/v1/find/item.rss?keyword=%28GPS+Traffic+Maps%2C%22Auto+GPS%22%2C%22Vehicle+GPS%22%2C%22Handheld+GPS%22%29+-Tomtom&categoryId1=3270&sortOrder=BestMatch&programid=1&campaignid=5336539146&toolid=10039&listingType1=All&lgeo=1&feedType=rss

 

Pensez aux variantes des mots-clés comme le singulier et le pluriel Lorsqu'un utilisateur eBay saisit par exemple « robes rouges » dans la zone de texte située sur la page des résultats de recherche d'eBay, la recherche sur le terme « robes » est étendue de manière automatique pour inclure également le mot-clé « robe ». Ce n'est pas le cas pour les mots-clés des requêtes RSS.

Gardez ce point à l'esprit lorsque vous choisissez vos mots-clés. Pensez à toutes les variantes possibles, comme le singulier et le pluriel (par ex. « train » et « trains »), les versions avec et sans trait d'union (par ex. « plate-forme » et « plateforme »), ainsi qu'à toutes les autres variantes imaginables et aux fautes d'orthographe courantes.

Remarque : vous ne devez pas vous soucier de l'utilisation des majuscules pour les mots-clés. Les recherches ne font pas la distinction entre les lettres majuscules et les lettres minuscules.

Utilisez les catégories pour améliorer la précision, en particulier pour les mots-clés pouvant apparaître dans plusieurs catégories L'utilisation des limitations des catégories est un excellent moyen pour améliorer la précision et l'exactitude des résultats de recherche, en particulier pour les mots-clés qui peuvent être employés dans plusieurs catégories. Si vous n'avez pas consulté vos mots-clés par catégorie depuis un certain temps, il peut être intéressant de les aligner sur les catégories eBay les plus courantes.

Remarque : les hiérarchies des catégories varient selon les sites eBay locaux. Consultez cet article récent à propos des dernières mises à jour des catégories par pays.

 

Personnalisez les critères de tri pour la méthode promotionnelle de votre site Identifiez le critère de tri optimal pour vos résultats de recherche, en fonction de celui qui s'avère le plus efficace pour la génération de conversions à l'aide de la méthode promotionnelle de votre site. Les options de tri sont disponibles à la section « Recherche approfondie » dans le processus de création du Générateur de flux RSS.

Le plus souvent, le paramètre par défaut « Pertinence » fonctionnera correctement. Toutefois, dans certains cas, le tri par prix ou par date de fin générera des résultats plus pertinents et des taux de conversion plus élevés. Vous pouvez également envisager l'ajout de filtres basés sur la catégorie de prix et la distance, ainsi que sur votre méthode promotionnelle.

 

Collaborez avec des fournisseurs tiers Enfin, nous avons reçu plusieurs questions de la part d'éditeurs qui utilisent des outils tiers avec le système RSS 2.0. Nous avons discuté avec certains de ces fournisseurs tiers, qui confirment l'existence de versions mises à jour compatibles avec le système RSS 2.0 :

WordBay : Mark Daniels de WordBay nous a indiqué que la version la plus récente (1.7) du module d'extension WordBay Wordpress était compatible avec le système RSS 2.0. Il s'agit d'une mise à jour gratuite destinée aux acheteurs des versions antérieures.

phpBay : Wade Wells de phpBay nous a indiqué que phpBay Pro version 4.x (sortie fin 2011) était compatible avec le système RSS 2.0. Pour procéder à la mise à jour, les clients peuvent accéder à leur compte en ligne et télécharger la dernière version. Celle-ci inclut un manuel de l'utilisateur contenant des informations et des instructions. Les forums phpBay proposent des actualités et une section d'aide. Les clients qui ont besoin d'assistance pour se connecter à la boutique en ligne et aux forums peuvent utiliser la page de contact du site principal.

BANS : la version standard de Build A Niche Store (BANS) est uniquement compatible avec le système RSS 1.0. Tao Schencks, un membre de la communauté de développement, nous a indiqué qu'une mise à jour compatible avec le système RSS 2.0 était vendue séparément sur le site.

Exclusion de responsabilité : la communication de ces informations ne doit en aucun cas être interprétée comme une recommandation de la part d'eBay Partner Network. En outre, eBay Partner Network ne fournit aucune assistance relative à ces produits, outils et mises à jour tiers, ni aux autres services tiers. eBay Partner Network n'a testé aucun de ces outils et ne propose aucune garantie y afférente, notamment en ce qui concerne la compatibilité avec ses propres produits présents et à venir. Pour toute question concernant la compatibilité, la mise à jour, l'implémentation, l'optimisation et le dépannage des flux RSS 2.0 à l'aide de ces outils, adressez-vous directement aux fournisseurs concernés. eBay Partner Network décline toute responsabilité quant au contenu de ces sites externes et ne cautionne en aucun cas ces contenus.

 

 

Optimiser vos flux RSS

 

La plupart des utilisateurs peuvent générer un nouveau lien vers les flux RSS 2.0 pour leurs applications en toute simplicité grâce au Générateur de flux RSS disponible sur le portail des éditeurs d'eBay Partner Network. Il suffit d'ouvrir une session sur le portail à l'aide de vos identifiants eBay Partner Network, puis de sélectionner Outils > Widgets > Générateur de flux RSS. Le Générateur de flux RSS vous guidera alors pas à pas tout au long de la procédure de génération du lien.

  1. A la section Détails sur l'affilié, sélectionnez un programme (par ex. eBay Etats-Unis), un nom ou un identifiant de campagne, et éventuellement un identifiant personnalisé.
  2. A la section Contenu de la publicité, vous serez invité à choisir au moins un mot-clé. Si vous le souhaitez, vous pouvez également sélectionner un nom ou un identifiant de campagne, ainsi que des mots-clés ou des catégories spécifiques à exclure de la recherche.
  3. (Facultatif) A la section Recherche approfondie, vous pouvez sélectionner un critère de tri (l'option Pertinence est généralement recommandée), le pseudo de vendeurs spécifiques, une catégorie de prix, un rayon par rapport à un code postal particulier, ainsi que le type d'annonces (par ex. Enchères et Achat immédiat).
  4. Enfin, cliquez sur le bouton Générer un lien RSS pour obtenir l'URL de vos flux RSS et afficher un aperçu des résultats.

Les utilisateurs plus expérimentés qui souhaitent personnaliser davantage leurs liens RSS manuellement peuvent se baser sur la liste de critères de tri supplémentaires disponible sur cette page.

Pour de plus amples informations sur l'utilisation et l'optimisation des mots-clés et d'autres critères de tri dans le système RSS 2.0, qui repose sur l'API Finding, consultez les pages suivantes du site du Programme eBay des développeurs :

Guide de migration de l'API Shopping FindItemsAdvanced vers l'API Finding findItemsAdvanced http://developer.ebay.com/Devzone/finding/Concepts/map_FindItemsAdvanced_2_FindingService.html

Différences entre l'API Shopping FindItemAdvance et l'API Finding http://developer.ebay.com/Devzone/finding/Concepts/MakingACall.html#diffs

API Finding : guide de l'utilisateur http://developer.ebay.com/devzone/finding/Concepts/FindingAPIGuide.html

Nous publierons dans les semaines à venir d'autres conseils pour vous aider à optimiser vos résultats dans le système RSS 2.0.

Pensez donc à consulter régulièrement le blog d'eBay Partner Network !

Important – Migration vers le système RSS 2.0

Comme nous l'avions annoncé précédemment, le système RSS 1.0 est désormais obsolète et n'est plus pris en charge. Le délai pour la migration vers le système RSS 2.0 a été prolongé jusqu'au 31 mai 2012. Après cette date, la version RSS 1.0 ne sera plus en service. Les éditeurs qui utilisent le système RSS 1.0 devront migrer vers la version RSS 2.0 avant cette date pour éviter toute interruption de service. Nous savons que certains d'entre vous ont rencontré des difficultés avec les flux RSS le mois dernier. Aussi, nous tenions à leur présenter nos excuses pour la frustration et les problèmes occasionnés. Nous avons mis la priorité sur l'optimisation et l'amélioration de la stabilité des flux RSS 2.0 durant la migration de nos éditeurs vers ce nouveau système.

Au cours des prochaines semaines, nous mettrons à la disposition des éditeurs des informations et des ressources supplémentaires pour les aider à implémenter plus facilement le système RSS 2.0 et à l'optimiser pour leurs propres sites. De plus amples informations seront disponibles ici prochainement.

Nous mettons tout en œuvre pour vous garantir une transition en douceur et nous vous remercions à nouveau pour votre coopération. N'hésitez pas à nous contacter si vous avez la moindre question.

Il est temps d'actualiser votre flux RSS

Flux rss Le 18 avril, nous avons lancé RSS v2 sur une plate-forme améliorée à partir de notre API Finding. Vous vous souvenez sans doute que nous avons parlé sur notre blog de ces changements et de l'importance de migrer vers la nouvelle version le 1er avril. Comme annoncé, l'infrastructure sous-jacente au RSS v1 a cessé d'être prise en charge le 30 juin 2011. Nous avons pensé que l'occasion est venue de rappeler et d'encourager tous nos éditeurs qui utilisent encore RSS v1 à migrer vers RSS v2.

Pour ceux d'entre vous qui ont eu par le passé des problèmes avec la migration vers RSS v2 à cause d'incohérences entre les champs de données fournis, ces problèmes ont été résolus.  Tous les champs disponibles dans RSS v1 ont été conservés dans RSS v2, bien qu'ils nécessitent un mappage. RSS v2 présente également une stabilité et une évolutivité plus grandes. Il existe plusieurs paramètres et filtres facultatifs qui vous permettront de profiter des avantages de RSS v2, notamment la possibilité de limiter les objets renvoyés par un pays particulier. Téléchargez tous les mappages ainsi que les paramètres et filtres facultatifs ici.

Vous pouvez encore accéder au flux RSS à partir du portail ePN sous Outils > Widgets dans l'interface de votre compte. Nous mettrons bientôt à jour le contenu de l'aide en veillant à inclure une description de tous les paramètres et filtres utilisés avec RSS v2.

Si vous avez des questions, n'hésitez pas à laisser vos commentaires ci-dessous. Nous espérons que tout le monde passera rapidement à RSS v2 !

Utilisation de l'outil de test de l'API d'eBay

L'API d'eBay est un système complet qui vous permet d'appeler des données directement à partir des serveurs d'eBay. Elle diffère du flux, qui désigne un fichier autonome contenant des références à des objets mis en vente sur eBay. Le site Web du Programme des développeurs eBay contient un outil de test de l'API complet permettant de vérifier les résultats des appels à l'API avec un ou plusieurs paramètres disponibles. Cet outil peut être utilisé directement par les développeurs ou les partenaires qui souhaitent tester des appels de base à l'API avant de les intégrer à un site Web. Présentation détaillée de l'API

Outil de test de l'API

Configuration d'un appel à l'API

La partie gauche de la page de l'outil vous permet de définir le type d'appel à l'API que vous souhaitez effectuer ainsi que sa destination. Vous trouverez ci-dessous une description de l'objet et des conditions d'utilisation de chaque section.

Options Sandbox et Production L'option Sandbox permet d'utiliser des bases de données de test contenant des données ou des objets fictifs. L'option Production utilise les bases de données en ligne contenant les objets actuellement mis en vente sur eBay. Utilisez l'option Sandbox pour tester les appels destinés à eBay, tels que ceux de l'API Trading. Vous pourrez ensuite utiliser l'option Production pour activer l'appel une fois testé. Utilisez l'option Production pour extraire des informations, notamment pour rechercher des objets, des catégories et des vendeurs.

Jeu de clés Cette section sera renseignée automatiquement dès que vous aurez configuré vos clés de développeur à l'aide de votre page de compte de développeur.

Sélection d'une API Il existe de nombreuses API disponibles présentant chacune des fonctionnalités différentes. Les API Shopping et Finding permettent de rechercher des objets en vente. L'API Trading permet de mettre en vente et de vendre des objets, etc. Un guide complet des différentes API est disponible dans le centre de documentation. Dans le cadre de cet article, nous nous intéresserons principalement à l'API Finding.

Sélection d'un appel à l'API Vous pouvez effectuer différents types d'appels pour chaque API. Par exemple, dans l'API Finding, l'appel le plus utile et le plus courant est findItemsAdvanced, qui offre la flexibilité la plus élevée dans la recherche d'objets. Cependant, l'API Finding comporte d'autres appels, par exemple pour rechercher des objets par catégorie ou par nom de Boutique. Un guide complet présentant les différents appels disponibles et leurs fonctionnalités est disponible dans le centre de documentation.

Sélection d'un modèle Après avoir configuré votre type d'appel, vous pouvez créer un appel et modifier les critères de recherche de l'appel que vous avez défini. Les modèles permettent d'ajouter facilement des exemples de champs de critères de recherche dans le champ de requête situé à droite. Vous pouvez modifier ou supprimer ces critères à tout moment. Sélectionnez Full/Generic pour ajouter des champs vides dans la zone XML Request.  Sélectionnez Partial/Pre-Filled pour ajouter des exemples de champs de base déjà pré-remplis. Cela permet aux gens qui ne connaissent pas l'outil d'apprendre à l'utiliser pour faire des recherches. Pour afficher un exemple comprenant les paramètres de suivi ePN, sélectionnez l'option Full/Generic. Les paramètres apparaîtront dans les balises <affiliate>.

Sélection des variations d'appels/champs à inclure Le contenu du champ Select Call Variation/Fields to Include dépend du modèle sélectionné, mais encore une fois, il s'agit simplement d'une méthode rapide pour ajouter des champs de recherche dans la zone XML Request. Si vous avez choisi un modèle Full/Generic, vous pouvez ajouter uniquement les champs requis ou ajouter tous les champs possibles. Si vous choisissez d'ajouter tous les champs possibles, ceux-ci apparaîtront dans la zone XML Request située à droite. Vous pouvez alors parcourir la liste des champs et choisir ceux que vous souhaitez utiliser. Par exemple, vous pouvez décider de conserver la recherche par mots-clés et de supprimer la recherche par catégorie. Pour ce faire, sélectionnez la ligne <keywords>string</keywords> et ajoutez vos mots-clés en fonction de vos besoins. Sélectionnez ensuite la ligne <categoryId>string</categoryId> et supprimez-la. En utilisant de cette façon tous les champs possibles, vous pouvez afficher toutes les possibilités et exploiter pleinement un appel à l'API donnée.

Sélection d'une version de requête d'appel En règle générale, ce paramètre reste inchangé. Cependant, vous pouvez être amené à le modifier dans des circonstances très spécifiques, notamment lorsqu'une API a subi des modifications et causé des problèmes.

Sélection d'un code de site eBay compte de multiples sites Web destinés chacun à un usage particulier (par exemple, pour un pays spécifique ou pour eBay Auto aux Etats-Unis). Les objets mis en vente en France sont répertoriés dans le site français, ceux mis en vente en Allemagne dans le site allemand, etc. Les catégories des sites diffèrent également en fonction de la langue et des besoins du pays. Un appel à l'API ne peut être effectué que vers un seul site eBay. C'est pourquoi le code du site doit être spécifié. Si vous souhaitez effectuer un appel vers plusieurs sites, vous devez créer plusieurs appels à l'API.

Définition des valeurs de la requête

Une fois que vous avez configuré l'outil en fonction de l'appel à l'API que vous souhaitez créer, passez à la partie droite de la page de l'outil pour modifier les valeurs de requête de votre appel. Vous trouverez ci-dessous une description de chacune des sections disponibles :

Web Service URI (Endpoint) Cette section correspond à l'URL de l'API que vous utilisez. L'option Select an API renseigne automatiquement cette adresse, mais vous pouvez la modifier manuellement si vous le souhaitez.

HTTP Headers Comme précédemment, ces données sont automatiquement renseignées en fonction des choix effectués lors de la configuration de votre appel à l'API dans la partie de gauche. Vous pouvez les modifier manuellement si besoin.

XML Request Cette zone contient les données qui seront envoyées à l'API et déterminent les résultats attendus. Les paramètres de recherche sont contenus au sein de balises XML, par exemple : <entriesPerPage>2</entriesPerPage>. Les valeurs indiquées entre les balises (dans cet exemple, 2) correspondent aux valeurs que vous modifiez lorsque vous créez un appel. Pour vous familiariser avec l'outil, nous vous conseillons d'utiliser les exemples pré-remplis. Une documentation complète pour chaque paramètre est disponible dans le centre de documentation.

Affichage des résultats

Une fois que vous avez défini tous vos paramètres, soumettez votre recherche. Les résultats s'afficheront dans la zone Call Response au format XML. En voici un aperçu :

Si vous n'obtenez aucun résultat, modifiez votre appel pour étendre la recherche. Dès que vous êtes satisfait de votre appel, vous pouvez l'intégrer à un site Web (https://developer.ebay.com/quickstartguide/).

Exemple d'utilisation

Vous trouverez ci-dessous un exemple d'utilisation de l'outil pour obtenir une liste des shorts bleus immédiatement en vente au Royaume-Uni.

1. Sélectionnez l'environnement Production, car nous recherchons des objets mis en vente sur eBay.

2. Sélectionnez l'API Finding, car nous recherchons des objets.

3. Utilisez l'appel findItemsAdvanced pour pouvoir spécifier des paramètres avancés pour rechercher un type d'objet spécifique.

4. Définissez le modèle Full/Generic et ajoutez tous les champs possibles à l'appel. Cela vous permettra d'utiliser facilement tous les paramètres dont vous avez besoin et de supprimer les autres.

5. Choisissez UK comme code de site.

6. Sélectionnez la catégorie correspondant aux shorts.  Pour connaître le numéro de catégorie à utiliser, consultez la page (http://listings.ebay.co.uk/)  des catégories d'eBay. Vous pouvez également utiliser l'outil de catégorie CGMlab (http://ebay.cgmlab.co.uk/tool-categorytree.php) pour obtenir des détails sur les différentes catégories disponibles.

7. Définissez des filtres d'annonce pour inclure les enchères de type Achat immédiat, Prix fixe et Prix fixe Boutique eBay. Vous obtiendrez ainsi l'ensemble des objets pouvant être achetés immédiatement. Une liste complète des filtres d'annonce disponibles pour findItemsAdvanced est disponible sur le site (http://developer.ebay.com/DevZone/Finding/CallRef/types/ItemFilterType.html).

8. Définissez un filtre d'aspect pour rechercher uniquement les objets ayant comme couleur principale le bleu. Pour connaître les différents aspects possibles d'une catégorie donnée, consultez la page de cette catégorie (dans cet exemple, il s'agit de la page (http://clothes.shop.ebay.co.uk/Shorts-/15689/i.html?LH_LocatedIn=1&_armrs=1&_dmd=1&_mdo=Clothes-Shoes-Accessories&_mspp=&_pcats=1059%2C11450&_salic=3)). Pour obtenir des informations supplémentaires sur les filtres d'aspect, consultez la documentation sur les appels disponible à la page (http://developer.ebay.com/DevZone/Finding/CallRef/findItemsAdvanced.html#Request.aspectFilter).

9. Spécifiez vos paramètres de suivi ePN. L'identifiant du réseau pour eBay Partner Network est 9. Utilisez la balise du code de traçage <trackingId> comme identifiant de campagne.  La balise <geoTargeting> est destinée à une utilisation ultérieure. Vous pouvez lui attribuer la valeur 0.

10. Supprimez tous les champs non utilisés dans la zone XML Request. Etant donné que nous avons choisi d'inclure tous les champs possibles pour ajouter plus facilement ceux que nous voulions, de nombreux champs seront inutilisés. Ces champs peuvent avoir une incidence sur vos résultats et doivent donc être supprimés. Vous trouverez ci-dessous un exemple de l'appel complet obtenu :

11. Une fois l'appel effectué, vous recevrez une liste de résultats. Ces résultats contiennent les détails de l'appel et des objets renvoyés, ainsi que des messages d'erreur si l'appel a échoué. Vous pouvez utiliser ces données pour modifier les paramètres de configuration de l'appel, le renvoyer et essayer différentes solutions pour obtenir de meilleurs résultats.

Options d'implémentation

L'outil de test de l'API permet d'afficher facilement un appel à l'API et de modifier ses options pour obtenir l'appel qui répond le mieux à vos besoins. Un appel à l'API peut être implémenté de plusieurs manières et sous de nombreux format.  Des exemples d'appels à l'API Finding aux formats XML et URL standard sont disponibles à l'adresse suivante :

http://developer.ebay.com/DevZone/finding/CallRef/findItemsAdvanced.html#Samples

Pour obtenir des informations plus générales sur toutes les options de formats de requête et de réponse, consultez la page suivante :

http://developer.ebay.com/DevZone/finding/Concepts/MakingACall.html

Prochaines modifications de l'API Finding pour les affiliés

L'API eBay est l'outil le plus puissant que nous mettons actuellement à la disposition des éditeurs. Elle permet d'obtenir des informations en temps réel pour toutes les annonces eBay et offre la flexibilité nécessaire pour répondre aux besoins de chaque application. L'API Finding est l'API la plus utilisée pour accéder à des résultats de recherche sur eBay car elle offre de nombreux filtres et d'autres critères de recherche. Elle représente l'évolution la plus récente de la technologie de recherche d'eBay et offre des performances et une évolutivité accrues par rapport aux API de recherche précédentes.

Au cours de la semaine du 23 mai, nous apporterons certaines modifications aux URL fournies dans les appels à l'API eBay Finding. Comme vous le savez sans doute, de nombreux appels aux API eBay renvoient des liens eBay Partner Network au format correct si vous fournissez vos informations de suivi dans l'appel à l'API.

Voici un exemple d'appel à l'API Finding avec suivi de l'affilié :

http://svcs.ebay.com/services/search/FindingService/v1?OPERATION-NAME=findItemsByKeywords&SERVICE-VERSION=1.9.0&SECURITY-APPNAME=Your-App-ID&RESPONSE-DATA-FORMAT=XML&REST-PAYLOAD&affiliate.networkId=9&affiliate.trackingId=1234567890&affiliate.customId=mycustomid&
sortOrder=EndTime&paginationInput.entriesPerPage=2&keywords=elmo

La réponse à cet appel comporte actuellement des URL semblables à celle-ci :

http://rover.ebay.com/rover/1/711-53200-19255-0/1?campid=1234567890&customid=mycustomid&toolid=0&mpre=http%3A%2F%2Fcgi.ebay.com%2F
Sesame-Street-Fisher-Price-2008-Farmer-Country-Elmo-11-%2F190527439548%3Fpt%3DLH_DefaultDomain_0

Nous allons mettre à jour ce lien en y ajoutant le code d'outil approprié et une structure de lien simplifiée pour le numéro de l'objet (pour remplacer la structure de l'URL personnalisée actuellement utilisée). Deux nouveaux paramètres vont également être ajoutés : lgeo et vectorid. Ils sont destinés à un usage interne et ne doivent pas être modifiés. Après ces modifications, le lien se présentera comme suit :

http://rover.ebay.com/rover/1/711-53200-19255-0/1?ff3=2&toolid=10041&campid=1234567890&customid=mycustomid&lgeo=0&vectorid=229466&item
=190527439548

Il est essentiel que vous adoptiez ces modifications dans vos applications. En fournissant vos informations de suivi et en utilisant le bon code d'outil, vous vous assurerez d'obtenir les URL eBay Partner Network correctes et le code d'outil correct sera renseigné automatiquement pour être utilisé dans vos rapports. Pour savoir comment spécifier vos informations de suivi eBay Partner Network, consultez la Documentation de l'API Finding.

Prenez également le temps de nous communiquer votre pseudo du Programme des développeurs eBay en vous connectant au portail eBay Partner Network et en accédant aux sections Compte > Informations sur votre activité. En liant vos comptes au sein d'eBay Partner Network, vous nous permettez de vous offrir un meilleur service en cas de problème lié à l'API et de vous communiquer directement toute mise à jour concernant les API.

Vous utilisez toujours les API Shopping et Trading pour les appels de recherche ?

Le blog du Programme des développeurs eBay contient des informations supplémentaires concernant la disparition progressive des appels aux API suivants souvent utilisés par les affiliés :

• API Shopping : FindItemsAdvanced et FindItems • API Trading : GetSearchResults et GetCategoryListings

Ces appels aux API ne seront plus disponibles après le mois d'octobre 2011. Si vous les utilisez encore, il est possible que vous commenciez à recevoir des messages d'avertissement dès le début du mois de juin. Faute d'un traitement adéquat des messages d'erreur envoyés par l'API, le fonctionnement normal de vos applications risque d'être perturbé.

Voici certains points importants de l'article de blog du Programme des développeurs qui vous aideront peut-être à planifier votre migration des appels aux API Shopping/Trading vers l'API Finding.

Fonctionnalités disponibles uniquement dans l'API Finding :

1. Recherche d'histogrammes d'aspect et filtrage des résultats en fonction des aspects et/ou domaines

2. Prise en charge de nouvelles options de recherche :

  • Histogramme et filtres Etat de l'objet
  • Recherches restreintes pouvant couvrir jusqu'à 3 catégories en même temps
  • Filtres Livraison prioritaire
  • Filtre Vendeurs Top Notés uniquement
  • Filtre Retours acceptés uniquement

3. API de recherche d'images (findItemsByImage) : extension des options eBay dans la catégorie Mode pour les développeurs dans le cadre de la fonctionnalité A voir aussi.

4. Trois tailles de photos de la galerie : 140x140, 96x96, 80x80 à choisir en fonction des besoins de l'application.

5. Améliorations futures des filtres URL de la photo, Versions multiples, LocatedIn, etc. à venir en mai.

Comment en savoir plus sur la migration vers l'API Finding ?

Les guides de migration suivants présentent les champs de valeurs et de résultats pour GetSearchResults dans l'API Trading et FindItemsAdvanced dans l'API Shopping en les mettant en correspondance avec les champs de findItemsAdvanced dans l'API Finding :

N'hésitez pas à contacter le Programme des développeurs eBay pour toute question ou pour en savoir plus sur l'API Finding ou sur la migration.

-L'équipe eBay Partner Network

Un nouveau Générateur de flux RSS va bientôt être disponible!

Nous allons bientôt améliorer le flux RSS grâce aux innovations technologiques issues des recherches eBay. A compter du 18 avril, nous proposerons ainsi un Générateur de flux RSS mis à jour sur l’interface eBay Partner Network, qui possédera à la fois un nouveau format et un nouveau Tool ID dans son URL.

Le Générateur de flux RSS existant ne sera plus disponible dans l’interface ePN après le 17 avril. Toutefois, l'URL de votre flux RSS existant fonctionnera jusqu'au 30 Juin. Nous vous conseillons donc de rapidement basculer vers le nouveau Générateur de flux RSS pour être sûr d’obtenir des résultats plus pertinents dans votre flux RSS.

En plus de proposer des résultats de recherches plus pertinents, le nouveau Générateur de flux RSS vous permettra également de filtrer les annonces des meilleurs vendeurs eBay sur votre flux RSS, ainsi que d’exclure des catégories particulières de vos résultats si cela s’avère nécessaire.

Pour trouver le Générateur de flux RSS, connectez-vous à votre compte eBay Partner Network, cliquez sur Outils> Widgets > Générateur de flux RSS, ou cliquez ici.

L’équipe eBay Partner Network

Changements au niveau des limites d'appel aux API

A partir du 1er mars 2011, les limites d'appel aux API Shopping, Finding et Merchandising seront calculées différemment. Pour plus de détails, consultez cet article. Qu'est-ce que cela signifie pour vous ?

Si votre application génère plus de 5 000 appels par jour, procédez à une vérification de compatibilité pour obtenir une augmentation de vos limites d'appel et éviter ainsi toute interruption de service au niveau de votre application.

Cordialement,

L'équipe eBay Partner Network

Optimisation des Flux RSS et résolution des problèmes

Bonjour chers Partenaires, Comme vous le savez peut-être, une optimisation prévue des Flux RSS d’eBay Partner Network a provoqué une erreur de redirection, mais cette dernière a désormais été corrigée. Le problème a commencé le 9 Février et a été résolu le 16 Février. Veuillez noter que seuls les affiliés non Américains ont été affectés. Un bonus sera reversé sur le paiement de Février à tous les affiliés qui ont été touchés par ce problème.

Nous vous remercions de la patience dont vous avez fait preuve durant la période de résolution du problème.

L’équipe eBay Partner Network

Flux RSS : collaboration entre eBay Partner Network et Widgetbox

Bonjour à tous, eBay Partner Network a récemment travaillé avec Widgetbox dans le but d'offrir à ses affiliés la possibilité de créer des widgets personnalisés à partir de n'importe quel flux RSS eBay. Dès le mercredi 9 septembre à 14h (PST), une nouvelle fonctionnalité sera disponible dans l'onglet Outils de l'interface eBay Partner Network. Grâce à elle, vous pourrez transformer le flux RSS que vous avez créé en un widget personnalisable à l'aide des outils Blidget et Blidget Pro de Widgetbox.

Dans le Générateur de flux RSS d'eBay Partner Network, accédez en un clic à l'éditeur de blidget et créez instantanément votre blidget personnalisé. Vous pourrez choisir parmi plusieurs mises en page, arrière-plans, modèles, couleurs et en-têtes. Vous voulez avoir accès à des fonctions avancées pour personnaliser davantage votre widget ? Utilisez la version Pro ! Cette nouvelle fonctionnalité de widget RSS fonctionne pour les programmes de tous les pays sur eBay Partner Network.

blidget-pro-de-widgetbox 

Comment procéder ? Suivez les étapes ci-dessous, c'est très simple !

  1) Créez un compte : vous devez avoir un compte Widgetbox ainsi qu'un compte eBay Partner Network . 2) Configurez votre flux RSS : sur eBay Partner Network, accédez à l'onglet « Outils » puis cliquez sur la section « Widgets ». Dans le Générateur de flux RSS, renseignez toutes les informations nécessaires puis cliquez sur « Générer un lien RSS ». 3) Créez des blidgets ! Une fois le lien créé, cliquez sur le lien à côté de « URL du Widget » pour transformer votre flux RSS en widget personnalisable dans Widgetbox. Vous êtes alors redirigé vers une page Widgetbox pour finaliser votre personnalisation.

  Cordialement,

  L'équipe eBay Partner Network