Gids
Artikelkenmerken op eBay: wat ze zijn en hoe u ze invult
Artikelkenmerken bepalen of kopers uw artikel vinden wanneer ze de eBay-zoekresultaten filteren. Deze gids behandelt de vier niveaus, productidentificatiecodes, de tekenlimieten, hoe u de aspecten van een categorie opzoekt en hoe u leveranciersspecificaties omzet in nette waarden.
Artikelkenmerken (item specifics) zijn de gestructureerde naam-waardeparen in een eBay-vermelding: Merk: Nordlicht, Kleur: Zwart, Artikelbreedte: 45 cm. eBay beschrijft ze als beschrijvende trefwoorden die een koper iets over uw artikel vertellen, en in de API’s van eBay heten ze item aspects.
Ze zijn geen versiering. eBay gebruikt ze om uw artikel in gefilterde zoekresultaten te plaatsen, om te beoordelen hoe volledig een vermelding is en om het te koppelen aan de productcatalogus. Ze goed invullen is vooral een kwestie van gegevens: weten welke aspecten een categorie verwacht en over juiste waarden beschikken om erin te zetten.
Wat artikelkenmerken op eBay zijn
Elke eBay-categorie heeft een eigen set aspecten. Een categorie laptops kan om processor en schermgrootte vragen, een categorie kleding om maat en afdeling, en de meeste categorieën vragen om het merk. Elk aspect heeft een naam die eBay kiest en een waarde die u invult, ofwel gekozen uit de lijst van eBay, ofwel als vrije tekst getypt waar de categorie dat toestaat.
Artikelkenmerken staan naast uw titel en beschrijving, niet erin. Kopers zien ze in een gestructureerd blok op de vermeldingspagina, en de zoekfunctie van eBay gebruikt ze voor de filters in de linkerkolom — merk, maat, kleur, staat enzovoort. Een detail dat alleen in uw beschrijving staat, kan door die filters niet worden gebruikt.
Verplicht, Binnenkort verplicht, Aanbevolen en Aanvullend
In de vermeldingsflow van Seller Hub deelt eBay de artikelkenmerken van een categorie in vier niveaus in. Het niveau vertelt u wat eBay nu afdwingt, wat het later gaat afdwingen en waarnaar kopers zoeken.
| Niveau | Wat het betekent | Als u het leeg laat |
|---|---|---|
| Verplicht | Moet worden ingevuld voor elke nieuwe of gewijzigde vermelding | U kunt het artikel niet aanbieden of wijzigen |
| Binnenkort verplicht | Wordt verplicht; de vermeldingsflow toont de datum | Nog niet afgedwongen; wordt vanaf de getoonde datum als Verplicht behandeld |
| Aanbevolen | Gebaseerd op gegevens over de vraag van kopers en populaire zoekopdrachten | De vermelding kan gefilterde zoekopdrachten missen |
| Aanvullend | Optionele extra details voor de categorie | Geen blokkade; de vermelding bevat gewoon minder details |
Hoe artikelkenmerken zoekresultaten, filters en kopers beïnvloeden
eBay is duidelijk over filters: uw artikel verschijnt alleen in gefilterde zoekresultaten als u het bijbehorende artikelkenmerk hebt toegevoegd. Een koper die een zoekopdracht filtert op Merk of Maat ziet een vermelding waarin dat veld leeg is nooit, hoe goed de titel ook is.
Artikelkenmerken beïnvloeden ook de rangschikking. Tot de Best Match-factoren van eBay behoren hoe volledig de vermelding is en hoe goed ze overeenkomt met de zoektermen van de koper. De verkopersrichtlijnen van eBay stellen dat artikelkenmerken uw kans vergroten om te worden gevonden op eBay, Google Shopping en in externe zoekresultaten, en de vermeldingsflow toont hoe vaak elk kenmerk de afgelopen 30 dagen is gezocht — een handige manier om te bepalen welke Aanbevolen aspecten u voorrang geeft.
Voor kopers beantwoorden artikelkenmerken de vergelijkingsvragen nog voordat ze de beschrijving lezen. Juiste waarden verminderen berichten als „past dit wel?”, en onjuiste waarden leiden tot retouren: een koper die op een breedte van 45 cm heeft gefilterd, verwacht 45 cm.
Productidentificatiecodes: Merk, MPN, UPC, EAN, ISBN en „Niet van toepassing”
Productidentificatiecodes zijn een bijzondere groep artikelkenmerken. eBay beschrijft ze als unieke codes die door de producent van het product zijn gemaakt — GTIN’s zoals UPC, EAN en ISBN, plus het merk en het onderdeelnummer van de fabrikant (MPN) — en zegt dat ze in de meeste categorieën verplicht zijn.
Wanneer een identificatiecode overeenkomt met een product in de eBay-catalogus, stelt eBay die match voor en kan het de titel, foto’s en andere details vooraf invullen. Accepteer alleen exacte matches: een ander modeljaar of een andere verpakkingsgrootte is een ander product. In de Inventory API geeft eBay de voorkeur aan een eBay-product-ID (ePID) voor catalogusmatching, omdat één GTIN naar meer dan één catalogusproduct kan verwijzen.
- Merk: het merk dat op het product staat, niet de naam van het bedrijf dat het aan u heeft verkocht. Voor generieke goederen stelt de best-practicegids voor ontwikkelaars van eBay „Unbranded” voor.
- MPN: het onderdeel- of modelnummer van de fabrikant uit het gegevensblad. Zet hier nooit uw eigen SKU. Wanneer een categorie een MPN vereist, vereist de Inventory API ook een merk.
- UPC, EAN of ISBN: de GTIN van de fabrikant voor precies die variant. Valideer het controlecijfer voordat u de code gebruikt.
- „Niet van toepassing”: voor artikelen die echt geen identificatiecode hebben, zoals antiek of maatwerk, kunt u bij eBay „Niet van toepassing” selecteren. De exacte bewoording verschilt per eBay-marktplaats.
Tekenlimieten voor artikelkenmerken op eBay
De limieten verschillen per API van eBay, dus controleer welke API uw vermeldingstool gebruikt. Waar een bron hieronder een getal noemt, is dat het gedocumenteerde maximum; afzonderlijke categorieën kunnen voor sommige aspecten een eigen maximumlengte teruggeven.
| Veld | Limiet | Waar het van toepassing is |
|---|---|---|
| Titel van de vermelding | 80 tekens | Alle vermeldingen; eBay adviseert alle 80 te gebruiken |
| Ondertitel | 55 tekens | Optionele betaalde upgrade van de vermelding |
| Waarde van een artikelkenmerk | 65 tekens (standaard) | Trading API; sommige aspecten staan meer toe, weergegeven als aspectMaxLength |
| Aspectnaam / aspectwaarde | 40 / 50 tekens | Inventory API |
| Merk en MPN | 65 tekens elk | Productvelden van de Inventory API |
| Waarden in een aspect met meerdere waarden | Maximaal 30 | Aspecten met MULTI-cardinaliteit (Taxonomy API) |
| Beschrijving van een inventarisartikel | 4.000 tekens | Productbeschrijving in de Inventory API |
| Foto’s | Maximaal 24 per vermelding | Inventory API; maximaal 12 per variatie in een groep |
Zo vindt u de verplichte artikelkenmerken van een categorie
Er bestaat geen enkele lijst met artikelkenmerken voor eBay: aspecten en hun niveaus hangen af van de eindcategorie (leaf category) en de marktplaats, en ze veranderen na verloop van tijd. Zoek ze op voor elke categorie waarin u verkoopt.
Voor een handvol vermeldingen volstaat Seller Hub: kies de categorie in de vermeldingsflow en u ziet de Verplichte, Binnenkort verplichte, Aanbevolen en Aanvullende kenmerken, met zoekaantallen en eventuele datum voor Binnenkort verplicht. Om bestaande vermeldingen in bulk te herstellen, kunt u op de pagina Actieve vermeldingen een Excel-bestand downloaden met vermeldingen waarin kenmerken ontbreken en dat weer uploaden, of meerdere vermeldingen selecteren en „Artikelkenmerken toevoegen” gebruiken.
Gebruik voor een grote of veranderende catalogus de Taxonomy API, die dezelfde metadata in machineleesbare vorm teruggeeft:
- Bepaal de eindcategorie (leaf category) van het artikel. Aspecten worden per eindcategorie gedefinieerd, niet per bovenliggende categorie.
- Haal de categorieboom-ID op voor de eBay-marktplaats waarop u verkoopt.
- Roep GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id} aan. Beide parameters zijn verplicht.
- Lees aspectConstraint.aspectRequired om te bepalen wat verplicht is. Vertrouw niet op aspectUsage: dat geeft ook voor verplichte aspecten RECOMMENDED terug.
- Let op aspectMode (SELECTION_ONLY betekent dat u een van de waarden van eBay moet gebruiken) en itemToAspectCardinality (MULTI staat tot 30 waarden toe).
- Sla expectedRequiredByDate op voor aspecten die Binnenkort verplicht zijn, zodat u ze vóór de deadline kunt invullen.
- Roep voor veel categorieën tegelijk fetch_item_aspects aan op de categorieboom, dat de aspecten voor elke eindcategorie teruggeeft, en ververs uw kopie regelmatig.
De aspectmetadata lezen
Elk aspect dat getItemAspectsForCategory teruggeeft, bevat beperkingen die aangeven hoe u het moet invullen. Met deze velden kunt u de meeste mappingfouten voorkomen.
| Veld | Waarden | Wat u ermee doet |
|---|---|---|
| aspectRequired | true of false | Het betrouwbare signaal voor een verplicht aspect |
| aspectUsage | RECOMMENDED of OPTIONAL | Geef voorrang aan aanbevolen aspecten, maar onthoud dat verplichte aspecten ook RECOMMENDED tonen |
| aspectMode | FREE_TEXT of SELECTION_ONLY | Normaliseer uw waarde bij SELECTION_ONLY naar een van de waarden van eBay |
| itemToAspectCardinality | SINGLE of MULTI | Stuur één waarde, of bij MULTI maximaal 30 |
| aspectDataType / aspectFormat | bijv. DATE, NUMBER | Datums als YYYY, YYYYMM of YYYYMMDD; getallen als geheel getal of decimaal |
| aspectEnabledForVariations | true of false | Of het aspect kan worden gebruikt om variaties te definiëren, zoals maat of kleur |
| aspectApplicableTo | PRODUCT of ITEM | PRODUCT-aspecten beschrijven het catalogusproduct; ITEM-aspecten beschrijven uw specifieke artikel |
Attributen uit het leveranciersgegevensblad mappen naar eBay-aspecten
Als u merken van anderen doorverkoopt, staan de meeste waarden voor artikelkenmerken al in het gegevensblad of specificatieblad van de leverancier — alleen niet in de woorden van eBay. Mappen is het werk om een regel uit het gegevensblad om te zetten in een aspectnaam en een waarde die eBay accepteert.
De onderstaande voorbeelden laten de typische omzettingen zien. Aspectnamen verschillen per categorie, dus controleer elk ervan aan de hand van de metadata van de categorie voordat u op de mapping vertrouwt.
| Gegevensblad vermeldt | Mogelijk aspect | In te voeren waarde | Controle |
|---|---|---|---|
| Totale breedte 45 cm | Artikelbreedte | 45 cm | Gebruik de totale afmeting, niet de afmeting van de verpakking |
| Fabrikant: Nordlicht Leuchten GmbH | Merk | Nordlicht | Het merk op het product, niet de naam van de rechtspersoon |
| Artikelnr. NL-2210-BK | MPN | NL-2210-BK | Het nummer van de fabrikant, niet uw SKU |
| EAN 6291041500213 | EAN | 6291041500213 | Valideer het controlecijfer; één GTIN per variant |
| Kleur behuizing RAL 9005 gitzwart | Kleur | Zwart | Kies de waarde van eBay; houd de RAL-code in de beschrijving |
| Buitenstof: 100% biologisch katoen | Materiaal | Katoen | Vermeld „biologisch” waar de categorie of beschrijving dat toelaat |
| Nominale spanning 220–240 V AC | Spanning, als de categorie dit aanbiedt | 220–240 V | Aspectnamen en -formaten verschillen per categorie |
Categorievoorbeelden: elektronica, kleding en speelgoed
De onderstaande aspecten worden in deze categorieën vaak gevraagd en laten zien waar de waarden meestal vandaan komen. Ze zijn slechts illustratief: de feitelijke namen en niveaus hangen af van de eindcategorie en de marktplaats, dus zoek ze op zoals hierboven beschreven.
Voor kleding en schoenen beschrijven de helppagina’s van eBay een overstap in 2026 naar gestandaardiseerde maatwaarden, waarbij vermeldingen met ontbrekende of onduidelijke maten mogelijk worden verborgen. Raadpleeg de actuele helppagina van eBay over het maken van een vermelding voordat u op oudere maatconventies vertrouwt.
| Categorie | Aspecten die u vaak ziet | Waar de gegevens meestal staan | Let op |
|---|---|---|---|
| Consumentenelektronica | Merk, Model, MPN, Type, Connectiviteit, Kleur | Bestelinformatie en tabellen met technische gegevens | Modelnaam versus onderdeelnummer; regionale stekker- en spanningsvarianten |
| Kleding | Merk, Afdeling, Maattype, Maat, Kleur, Stijl, Materiaal | Maattabellen en etiketten met de vezelsamenstelling | Eén maat en kleur per variant; consistente maatsystemen |
| Speelgoed | Merk, Type, Leeftijdsniveau, Personage of franchise, Materiaal | Verpakkingstekst, leeftijdsindicatie en waarschuwingen | Leeftijdswaarden moeten overeenkomen met de leeftijdsindicatie en waarschuwingen van de fabrikant |
Veelgemaakte fouten bij artikelkenmerken
De meeste problemen met artikelkenmerken ontstaan doordat waarden worden gekopieerd zonder te controleren wat eBay verwacht. Dit zijn de fouten die het vaakst zichtbaarheid kosten of retouren veroorzaken.
- Alleen de Verplichte aspecten invullen en de Aanbevolen aspecten waarop kopers filteren negeren.
- Bij gebruik van de API aspectUsage gebruiken in plaats van aspectRequired om te bepalen wat verplicht is.
- Een vrije-tekstwaarde invoeren in een SELECTION_ONLY-aspect, of een spelling van een merk die niet overeenkomt met de lijst van eBay.
- Uw SKU in MPN zetten, of een door een wederverkoper gekocht streepjescode in UPC of EAN.
- „Niet van toepassing” kiezen voor een identificatiecode die het product wel degelijk heeft.
- Eenheden door elkaar gebruiken (45 cm in de ene vermelding, 450 mm in de andere), waardoor filters dezelfde waarde splitsen.
- De afmetingen van de verpakking gebruiken waar het aspect om de afmetingen van het artikel vraagt.
- Marketingzinnen herhalen in aspectwaarden in plaats van gewone attribuutwaarden.
- Waarden eenmalig instellen en de categorie nooit opnieuw controleren op nieuwe Binnenkort verplichte aspecten.
Checklist voor artikelkenmerken op eBay en waarden op schaal voorbereiden
Loop deze lijst door voor elke categorie voordat een batch vermeldingen live gaat. Het trage deel is meestal het verzamelen van juiste waarden uit leveranciersdocumenten, niet het invoeren ervan.
Doc2Shelf helpt bij die eerste stap. Het leest leveranciers-pdf’s, extraheert mogelijke attributen — elke extractie krijgt een betrouwbaarheidsscore en per geëxtraheerd feit worden de bronpagina en een kort citaat bewaard — en bereidt voor eBay bedoelde concepttekst en mogelijke waarden voor artikelkenmerken voor, ter beoordeling door u. Nieuwe eBay-koppelingen komen binnenkort; accounts die al zijn gekoppeld, kunnen blijven publiceren. Nieuwe gebruikers exporteren de gecontroleerde tekst als generieke CSV of JSON, wat geen importschema van eBay is, en voeren de waarden vervolgens in via Seller Hub of hun eigen vermeldingstool.
- Eindcategorie (leaf category) bevestigd voor de marktplaats waarop u verkoopt.
- Alle Verplichte aspecten ingevuld; Binnenkort verplichte aspecten ingevuld vóór hun datum.
- Aanbevolen aspecten met veel zoekopdrachten ingevuld.
- Merk, MPN en GTIN overgenomen uit de documenten van de fabrikant en gecontroleerd.
- Selection-only-waarden genormaliseerd naar de waarden van eBay.
- Eenheden en formaten consistent over vermeldingen heen.
- Waarden binnen de gedocumenteerde tekenlimieten.
- Catalogusmatches alleen geaccepteerd wanneer het precies hetzelfde product is.
Veelgestelde vragen
- Wat zijn artikelkenmerken op eBay?
- Het zijn gestructureerde naam-waardegegevens over een artikel, zoals merk, maat, kleur en materiaal. eBay gebruikt ze voor zoekfilters, Best Match en catalogusmatching. In de API’s van eBay heten ze item aspects.
- Zijn aanbevolen artikelkenmerken verplicht?
- Nee. Alleen Verplichte kenmerken blokkeren een vermelding. Aanbevolen kenmerken zijn gebaseerd op gegevens over de vraag van kopers en populaire zoekopdrachten, en uw artikel verschijnt alleen in gefilterde resultaten voor de kenmerken die u hebt ingevuld, dus het loont om ze aan te vullen.
- Helpen artikelkenmerken bij de zoekrangschikking op eBay?
- Ja. Best Match van eBay houdt rekening met hoe volledig een vermelding is, en eBay stelt dat artikelkenmerken uw kans vergroten om te worden gevonden op eBay, Google Shopping en externe zoekmachines.
- Wat betekent „Niet van toepassing” op eBay?
- Het geeft eBay aan dat het artikel geen productidentificatiecode van dat type heeft, bijvoorbeeld een antiek of op maat gemaakt artikel. Gebruik het alleen wanneer dat klopt; gebruik het niet om een identificatiecode over te slaan die het product wel heeft.
- Hoe lang mag de waarde van een artikelkenmerk zijn?
- Het standaardmaximum is 65 tekens in de Trading API, en sommige aspecten staan er meer toe. In de Inventory API zijn aspectnamen beperkt tot 40 tekens en waarden tot 50.
- Hoeveel tekens mag een eBay-titel hebben?
- Tachtig. eBay raadt aan alle 80 tekens te gebruiken voor relevante details zoals merk, model en belangrijke attributen. Met een betaalde ondertitel komen er nog 55 tekens bij.
- Waarom toont de eBay-API een verplicht aspect als RECOMMENDED?
- In getItemAspectsForCategory is aspectUsage RECOMMENDED of OPTIONAL, en verplichte aspecten geven ook RECOMMENDED terug. Controleer aspectConstraint.aspectRequired om te zien of een aspect verplicht is.
- Hoe voeg ik artikelkenmerken toe aan veel vermeldingen tegelijk?
- Download in Actieve vermeldingen van Seller Hub het Excel-bestand met vermeldingen waarin Verplichte, Binnenkort verplichte of Aanbevolen kenmerken ontbreken, vul het in en upload het opnieuw — of selecteer meerdere vermeldingen en gebruik „Artikelkenmerken toevoegen”.