Guide
Caractéristiques de l’objet eBay : de quoi il s’agit et comment les renseigner
Les caractéristiques de l’objet déterminent si les acheteurs trouvent votre article lorsqu’ils filtrent leurs recherches sur eBay. Ce guide présente les quatre niveaux, les identifiants produit, les limites de caractères, la façon de consulter les attributs d’une catégorie et celle de transformer les spécifications fournisseurs en valeurs propres.
Les caractéristiques de l’objet sont les paires nom–valeur structurées d’une annonce eBay : Marque : Nordlicht, Couleur : Noir, Largeur de l’article : 45 cm. eBay les décrit comme des mots-clés descriptifs qui renseignent l’acheteur sur votre article, et dans les API d’eBay, on les appelle des attributs d’article (item aspects).
Elles ne sont pas décoratives. eBay les utilise pour placer votre article dans les résultats de recherche filtrés, pour évaluer le degré de complétude d’une annonce et pour la rapprocher de son catalogue de produits. Bien les renseigner relève surtout d’un travail sur les données : savoir quels attributs une catégorie attend et disposer de valeurs exactes pour les remplir.
Ce que sont les caractéristiques de l’objet eBay
Chaque catégorie eBay a son propre ensemble d’attributs. Une catégorie d’ordinateurs portables peut demander le processeur et la taille d’écran, une catégorie de vêtements la taille et le rayon, et la plupart des catégories demandent la marque. Chaque attribut porte un nom choisi par eBay et une valeur que vous fournissez, soit sélectionnée dans la liste d’eBay, soit saisie en texte libre lorsque la catégorie le permet.
Les caractéristiques de l’objet figurent à côté de votre titre et de votre description, et non à l’intérieur. Les acheteurs les voient dans un bloc structuré sur la page de l’annonce, et la recherche d’eBay les utilise pour les filtres de la colonne de gauche — marque, taille, couleur, état, etc. Un détail qui n’apparaît que dans votre description ne peut pas être utilisé par ces filtres.
Obligatoire, Bientôt obligatoire, Recommandé et Supplémentaire
Dans le parcours de mise en vente de Seller Hub, eBay répartit les caractéristiques de l’objet d’une catégorie en quatre niveaux. Le niveau indique ce qu’eBay impose dès maintenant, ce qu’il imposera plus tard et ce que recherchent les acheteurs.
| Niveau | Signification | Si vous le laissez vide |
|---|---|---|
| Obligatoire | Doit être renseigné pour toute annonce nouvelle ou modifiée | Vous ne pouvez pas mettre en vente ni modifier l’article |
| Bientôt obligatoire | Deviendra obligatoire ; le parcours de mise en vente indique la date | Pas encore appliqué ; traité comme Obligatoire à partir de la date indiquée |
| Recommandé | Fondé sur les données de demande des acheteurs et les recherches populaires | L’annonce peut passer à côté de recherches filtrées correspondantes |
| Supplémentaire | Détail complémentaire facultatif pour la catégorie | Pas de blocage ; l’annonce comporte simplement moins de détails |
Comment les caractéristiques de l’objet influencent la recherche, les filtres et les acheteurs
eBay est clair sur les filtres : votre article n’apparaît dans les résultats de recherche filtrés que si vous avez ajouté la caractéristique correspondante. Un acheteur qui filtre une recherche par Marque ou par Taille ne voit jamais une annonce dont ce champ est vide, même si son titre est excellent.
Les caractéristiques de l’objet influencent aussi le classement. Les facteurs de Meilleur résultat (Best Match) d’eBay incluent le degré de complétude de l’annonce et sa proximité avec les termes de recherche de l’acheteur. Les conseils d’eBay aux vendeurs indiquent que les caractéristiques de l’objet augmentent vos chances d’être trouvé sur eBay, Google Shopping et dans les résultats de recherche externes, et le parcours de mise en vente montre à quelle fréquence chaque caractéristique a été recherchée au cours des 30 derniers jours — un moyen utile pour décider quels attributs Recommandés traiter en priorité.
Pour les acheteurs, les caractéristiques de l’objet répondent aux questions de comparaison avant même qu’ils ne lisent la description. Des valeurs exactes réduisent les messages « est-ce que cela convient ? », et de mauvaises valeurs entraînent des retours : un acheteur qui a filtré sur une largeur de 45 cm attend 45 cm.
Identifiants produit : Marque, MPN, UPC, EAN, ISBN et « Non applicable »
Les identifiants produit forment un groupe particulier de caractéristiques de l’objet. eBay les décrit comme des codes uniques créés par le fabricant du produit — des GTIN tels que l’UPC, l’EAN et l’ISBN, ainsi que la marque et la référence fabricant (MPN) — et indique qu’ils sont obligatoires dans la plupart des catégories.
Lorsqu’un identifiant correspond à un produit du catalogue d’eBay, eBay propose la correspondance et peut préremplir le titre, les photos et d’autres détails. N’acceptez que les correspondances exactes : une autre année de modèle ou une autre taille de lot est un produit différent. Dans l’Inventory API, eBay privilégie un identifiant de produit eBay (ePID) pour la correspondance avec le catalogue, car un même GTIN peut correspondre à plusieurs produits du catalogue.
- Marque : la marque indiquée sur le produit, et non le nom de l’entreprise qui vous l’a vendu. Pour les articles génériques, les bonnes pratiques de la documentation développeur d’eBay suggèrent « Unbranded ».
- MPN : la référence ou le numéro de modèle du fabricant figurant sur la fiche technique. N’y mettez jamais votre propre SKU. Lorsqu’une catégorie exige un MPN, l’Inventory API exige aussi une marque.
- UPC, EAN ou ISBN : le GTIN du fabricant pour cette variante exacte. Validez le chiffre de contrôle avant de l’utiliser.
- « Non applicable » : pour les articles qui n’ont réellement aucun identifiant, comme les antiquités ou les articles sur mesure, eBay permet de sélectionner « Non applicable ». La formulation exacte varie selon la place de marché eBay.
Limites de caractères des caractéristiques de l’objet eBay
Les limites diffèrent selon les API d’eBay ; vérifiez donc laquelle utilise votre outil de mise en vente. Lorsqu’une source donne un nombre ci-dessous, il s’agit du maximum documenté ; certaines catégories peuvent renvoyer leur propre longueur maximale pour certains attributs.
| Champ | Limite | Où cela s’applique |
|---|---|---|
| Titre de l’annonce | 80 caractères | Toutes les annonces ; eBay conseille d’utiliser les 80 |
| Sous-titre | 55 caractères | Option payante facultative de l’annonce |
| Valeur d’une caractéristique de l’objet | 65 caractères (standard) | Trading API ; certains attributs autorisent davantage, indiqué par aspectMaxLength |
| Nom de l’attribut / valeur de l’attribut | 40 / 50 caractères | Inventory API |
| Marque et MPN | 65 caractères chacun | Champs produit de l’Inventory API |
| Valeurs d’un attribut à valeurs multiples | Jusqu’à 30 | Attributs de cardinalité MULTI (Taxonomy API) |
| Description d’un article d’inventaire | 4 000 caractères | Description produit de l’Inventory API |
| Photos | Jusqu’à 24 par annonce | Inventory API ; jusqu’à 12 par variante dans un groupe |
Comment trouver les caractéristiques obligatoires d’une catégorie
Il n’existe pas de liste unique de caractéristiques de l’objet eBay : les attributs et leurs niveaux dépendent de la catégorie finale et de la place de marché, et ils évoluent avec le temps. Consultez-les pour chaque catégorie dans laquelle vous vendez.
Pour quelques annonces, Seller Hub suffit : choisissez la catégorie dans le parcours de mise en vente et il affiche les caractéristiques Obligatoires, Bientôt obligatoires, Recommandées et Supplémentaires, avec les nombres de recherches et toute date « Bientôt obligatoire ». Pour corriger en masse des annonces existantes, la page Annonces actives permet de télécharger un fichier Excel des annonces auxquelles il manque des caractéristiques puis de le recharger, ou de sélectionner plusieurs annonces et d’utiliser « Ajouter des caractéristiques de l’objet ».
Pour un catalogue volumineux ou changeant, utilisez la Taxonomy API, qui renvoie les mêmes métadonnées sous forme lisible par machine :
- Identifiez la catégorie finale de l’article. Les attributs sont définis par catégorie finale, et non par catégorie parente.
- Récupérez l’identifiant de l’arborescence des catégories de la place de marché eBay sur laquelle vous vendez.
- Appelez GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}. Les deux paramètres sont obligatoires.
- Lisez aspectConstraint.aspectRequired pour déterminer ce qui est obligatoire. Ne vous fiez pas à aspectUsage : il renvoie aussi RECOMMENDED pour les attributs obligatoires.
- Notez aspectMode (SELECTION_ONLY signifie que vous devez utiliser l’une des valeurs d’eBay) et itemToAspectCardinality (MULTI autorise jusqu’à 30 valeurs).
- Conservez expectedRequiredByDate pour les attributs Bientôt obligatoires afin de les renseigner avant l’échéance.
- Pour de nombreuses catégories à la fois, appelez fetch_item_aspects sur l’arborescence des catégories, qui renvoie les attributs de chaque catégorie finale, et actualisez régulièrement votre copie.
Lire les métadonnées d’un attribut
Chaque attribut renvoyé par getItemAspectsForCategory comporte des contraintes qui indiquent comment le renseigner. Ces champs permettent d’éviter la plupart des erreurs de correspondance.
| Champ | Valeurs | Que faire de ce champ |
|---|---|---|
| aspectRequired | true ou false | Le signal fiable pour un attribut obligatoire |
| aspectUsage | RECOMMENDED ou OPTIONAL | Privilégiez les attributs recommandés, mais n’oubliez pas que les attributs obligatoires affichent aussi RECOMMENDED |
| aspectMode | FREE_TEXT ou SELECTION_ONLY | Pour SELECTION_ONLY, normalisez votre valeur sur l’une des valeurs d’eBay |
| itemToAspectCardinality | SINGLE ou MULTI | Envoyez une valeur, ou jusqu’à 30 pour MULTI |
| aspectDataType / aspectFormat | p. ex. DATE, NUMBER | Dates au format YYYY, YYYYMM ou YYYYMMDD ; nombres entiers ou décimaux |
| aspectEnabledForVariations | true ou false | Indique si l’attribut peut servir à définir des variantes, comme la taille ou la couleur |
| aspectApplicableTo | PRODUCT ou ITEM | Les attributs PRODUCT décrivent le produit du catalogue ; les attributs ITEM décrivent votre article précis |
Faire correspondre les attributs d’une fiche technique fournisseur aux attributs eBay
Si vous revendez d’autres marques, la plupart des valeurs de caractéristiques existent déjà dans la fiche technique ou la fiche de spécifications du fournisseur — simplement pas avec les mots d’eBay. La correspondance consiste à transformer une ligne de fiche technique en un nom d’attribut et une valeur qu’eBay accepte.
Les exemples ci-dessous montrent les transformations typiques. Les noms d’attributs varient selon la catégorie ; confirmez donc chacun d’eux avec les métadonnées de la catégorie avant de vous appuyer sur la correspondance.
| La fiche technique indique | Attribut candidat | Valeur à saisir | À vérifier |
|---|---|---|---|
| Largeur hors tout 45 cm | Largeur de l’article | 45 cm | Utilisez la dimension hors tout, et non la taille de l’emballage |
| Fabricant : Nordlicht Leuchten GmbH | Marque | Nordlicht | La marque figurant sur le produit, et non la raison sociale |
| Réf. article NL-2210-BK | MPN | NL-2210-BK | Le numéro du fabricant, et non votre SKU |
| EAN 6291041500213 | EAN | 6291041500213 | Validez le chiffre de contrôle ; un GTIN par variante |
| Couleur du boîtier RAL 9005 noir profond | Couleur | Noir | Choisissez la valeur d’eBay ; conservez le code RAL dans la description |
| Extérieur : 100 % coton biologique | Matière | Coton | Mentionnez « biologique » lorsque la catégorie ou la description le permet |
| Tension nominale 220–240 V CA | Tension, si la catégorie la propose | 220–240 V | Les noms et formats des attributs varient selon la catégorie |
Exemples de catégories : électronique, vêtements et jouets
Les attributs ci-dessous sont couramment demandés dans ces catégories et montrent d’où proviennent généralement les valeurs. Ils sont donnés à titre d’illustration uniquement : les noms et niveaux réels dépendent de la catégorie finale et de la place de marché ; consultez-les donc comme décrit plus haut.
Pour les vêtements et les chaussures, les pages d’aide d’eBay décrivent le passage en 2026 à des valeurs de taille normalisées, avec lequel les annonces dont les tailles sont manquantes ou peu claires peuvent être masquées. Consultez l’aide actuelle d’eBay « Créer une annonce » avant de vous appuyer sur d’anciennes conventions de taille.
| Catégorie | Attributs que vous verrez souvent | Où se trouvent généralement les données | Points de vigilance |
|---|---|---|---|
| Électronique grand public | Marque, Modèle, MPN, Type, Connectivité, Couleur | Informations de commande et tableaux de données techniques | Nom du modèle et référence ; variantes régionales de prise et de tension |
| Vêtements | Marque, Rayon, Type de taille, Taille, Couleur, Style, Matière | Guides des tailles et étiquettes de composition des fibres | Une taille et une couleur par variante ; systèmes de tailles cohérents |
| Jouets | Marque, Type, Tranche d’âge, Personnage ou franchise, Matière | Texte de l’emballage, âge recommandé et avertissements | Les valeurs d’âge doivent correspondre à l’âge recommandé par le fabricant et aux avertissements |
Erreurs courantes dans les caractéristiques de l’objet
La plupart des problèmes de caractéristiques de l’objet viennent de valeurs copiées sans vérifier ce qu’attend eBay. Ce sont les erreurs qui coûtent le plus souvent de la visibilité ou provoquent des retours.
- Ne renseigner que les attributs Obligatoires et ignorer les attributs Recommandés sur lesquels les acheteurs filtrent.
- Utiliser aspectUsage au lieu d’aspectRequired pour déterminer ce qui est obligatoire lorsque l’on travaille avec l’API.
- Saisir une valeur en texte libre dans un attribut SELECTION_ONLY, ou une orthographe de marque qui ne correspond pas à la liste d’eBay.
- Mettre votre SKU dans MPN, ou un code-barres acheté auprès d’un revendeur dans UPC ou EAN.
- Choisir « Non applicable » pour un identifiant que le produit possède réellement.
- Mélanger les unités (45 cm sur une annonce, 450 mm sur une autre), de sorte que les filtres séparent une même valeur.
- Utiliser les dimensions de l’emballage alors que l’attribut demande celles de l’article.
- Répéter des formules marketing dans les valeurs d’attributs au lieu de valeurs simples et factuelles.
- Renseigner les valeurs une fois pour toutes sans jamais revérifier la catégorie pour de nouveaux attributs Bientôt obligatoires.
Checklist des caractéristiques de l’objet eBay et préparation des valeurs à grande échelle
Parcourez cette liste pour chaque catégorie avant la mise en ligne d’un lot d’annonces. Le plus long est généralement de rassembler des valeurs exactes à partir des documents fournisseurs, et non de les saisir.
Doc2Shelf vous aide pour cette première étape. Il lit les PDF fournisseurs, extrait des attributs candidats — en attribuant à chaque extraction un indice de confiance et en conservant la page source et une courte citation pour chaque fait extrait — et prépare des brouillons de texte ciblés eBay et des valeurs candidates de caractéristiques de l’objet, à valider par vos soins. Les nouvelles connexions eBay arriveront bientôt ; les comptes déjà connectés peuvent continuer à publier. Les nouveaux utilisateurs exportent le texte validé en CSV ou JSON générique, qui n’est pas un schéma d’import eBay, puis saisissent les valeurs dans Seller Hub ou dans leur propre outil de mise en vente.
- Catégorie finale confirmée pour la place de marché sur laquelle vous vendez.
- Tous les attributs Obligatoires renseignés ; attributs Bientôt obligatoires renseignés avant leur date.
- Attributs Recommandés ayant un nombre élevé de recherches renseignés.
- Marque, MPN et GTIN repris des documents du fabricant et vérifiés.
- Valeurs à sélection imposée normalisées sur les valeurs d’eBay.
- Unités et formats cohérents d’une annonce à l’autre.
- Valeurs dans les limites de caractères documentées.
- Correspondances de catalogue acceptées uniquement lorsqu’il s’agit exactement du même produit.
Questions fréquentes
- Que sont les caractéristiques de l’objet sur eBay ?
- Ce sont des informations structurées nom–valeur sur un article, comme la marque, la taille, la couleur et la matière. eBay les utilise pour les filtres de recherche, le Meilleur résultat (Best Match) et la correspondance avec le catalogue. Dans les API d’eBay, on les appelle des attributs d’article (item aspects).
- Les caractéristiques de l’objet recommandées sont-elles obligatoires ?
- Non. Seules les caractéristiques Obligatoires bloquent une annonce. Les caractéristiques Recommandées reposent sur les données de demande des acheteurs et les recherches populaires, et votre article n’apparaît dans les résultats filtrés que pour les caractéristiques que vous avez renseignées ; il vaut donc la peine de les compléter.
- Les caractéristiques de l’objet améliorent-elles le classement dans la recherche eBay ?
- Oui. Le Meilleur résultat (Best Match) d’eBay tient compte du degré de complétude d’une annonce, et eBay affirme que les caractéristiques de l’objet augmentent vos chances d’être trouvé sur eBay, Google Shopping et les moteurs de recherche externes.
- Que signifie « Non applicable » sur eBay ?
- Cela indique à eBay que l’article n’a pas d’identifiant produit de ce type, par exemple une antiquité ou un article fait sur mesure. Ne l’utilisez que si c’est vrai ; ne l’utilisez pas pour éviter de renseigner un identifiant que le produit possède.
- Quelle peut être la longueur d’une valeur de caractéristique de l’objet ?
- Le maximum standard est de 65 caractères dans la Trading API, et certains attributs en autorisent davantage. Dans l’Inventory API, les noms d’attributs sont limités à 40 caractères et les valeurs à 50.
- Combien de caractères un titre eBay peut-il comporter ?
- Quatre-vingts. eBay recommande d’utiliser les 80 caractères pour des informations pertinentes comme la marque, le modèle et les principaux attributs. Un sous-titre payant permet d’ajouter 55 caractères.
- Pourquoi l’API eBay affiche-t-elle un attribut obligatoire comme RECOMMENDED ?
- Dans getItemAspectsForCategory, aspectUsage vaut soit RECOMMENDED, soit OPTIONAL, et les attributs obligatoires renvoient aussi RECOMMENDED. Vérifiez aspectConstraint.aspectRequired pour savoir si un attribut est obligatoire.
- Comment ajouter des caractéristiques de l’objet à de nombreuses annonces à la fois ?
- Dans les Annonces actives de Seller Hub, téléchargez le fichier Excel des annonces auxquelles il manque des caractéristiques Obligatoires, Bientôt obligatoires ou Recommandées, complétez-le et rechargez-le — ou sélectionnez plusieurs annonces et utilisez « Ajouter des caractéristiques de l’objet ».