Poradnik
Cechy przedmiotu w eBay: czym są i jak je wypełniać
Cechy przedmiotu decydują o tym, czy kupujący znajdą Twój przedmiot, filtrując wyniki wyszukiwania eBay. Ten poradnik omawia cztery poziomy, identyfikatory produktu, limity znaków, sposób wyszukiwania aspektów kategorii oraz zamianę specyfikacji dostawcy na czyste wartości.
Cechy przedmiotu to ustrukturyzowane pary nazwa–wartość w ofercie eBay: Marka: Nordlicht, Kolor: czarny, Szerokość przedmiotu: 45 cm. eBay opisuje je jako opisowe słowa kluczowe, które informują kupującego o Twoim przedmiocie, a w interfejsach API eBay nazywane są aspektami przedmiotu.
Nie są ozdobą. eBay wykorzystuje je do umieszczania Twojego przedmiotu w przefiltrowanych wynikach wyszukiwania, do oceny kompletności oferty i do dopasowania jej do katalogu produktów. Ich poprawne wypełnienie to przede wszystkim praca na danych: wiedza, jakich aspektów oczekuje kategoria, i posiadanie dokładnych wartości do wpisania.
Czym są cechy przedmiotu w eBay
Każda kategoria eBay ma własny zestaw aspektów. Kategoria laptopów może pytać o procesor i rozmiar ekranu, kategoria odzieży o rozmiar i dział, a większość kategorii pyta o markę. Każdy aspekt ma nazwę wybraną przez eBay i wartość, którą podajesz — wybraną z listy eBay lub wpisaną jako dowolny tekst, tam gdzie kategoria na to pozwala.
Cechy przedmiotu znajdują się obok tytułu i opisu, a nie w nich. Kupujący widzą je w ustrukturyzowanym bloku na stronie oferty, a wyszukiwarka eBay używa ich do filtrów w lewej kolumnie — marka, rozmiar, kolor, stan i tak dalej. Szczegół, który pojawia się tylko w opisie, nie może być użyty przez te filtry.
Wymagane, Wymagane wkrótce, Zalecane i Dodatkowe
W procesie tworzenia ofert w Seller Hub eBay grupuje cechy przedmiotu kategorii w cztery poziomy. Poziom informuje, co eBay egzekwuje teraz, co będzie egzekwować później i czego szukają kupujący.
| Poziom | Co oznacza | Jeśli zostawisz puste |
|---|---|---|
| Wymagane | Muszą być wypełnione w każdej nowej lub zmienianej ofercie | Nie możesz wystawić ani zmienić przedmiotu |
| Wymagane wkrótce | Staną się wymagane; proces wystawiania pokazuje datę | Jeszcze nie egzekwowane; traktowane jako Wymagane od wskazanej daty |
| Zalecane | Na podstawie danych o popycie kupujących i popularnych wyszukiwaniach | Oferta może nie pojawiać się w pasujących przefiltrowanych wyszukiwaniach |
| Dodatkowe | Opcjonalne dodatkowe szczegóły dla kategorii | Brak blokady; oferta po prostu zawiera mniej szczegółów |
Jak cechy przedmiotu wpływają na wyszukiwanie, filtry i kupujących
eBay mówi o filtrach wprost: Twój przedmiot pojawia się w przefiltrowanych wynikach wyszukiwania tylko wtedy, gdy dodasz odpowiednią cechę przedmiotu. Kupujący, który filtruje wyszukiwanie według marki lub rozmiaru, nigdy nie zobaczy oferty, w której to pole zostało puste, choćby jej tytuł był świetny.
Cechy przedmiotu wpływają także na pozycję w wynikach. Czynniki Best Match w eBay obejmują kompletność oferty i to, jak ściśle odpowiada ona frazom wyszukiwanym przez kupującego. Wskazówki eBay dla sprzedawców mówią, że cechy przedmiotu zwiększają szanse na znalezienie w eBay, Google Shopping i zewnętrznych wynikach wyszukiwania, a proces wystawiania pokazuje, jak często każda cecha była wyszukiwana w ciągu ostatnich 30 dni — to przydatny sposób na ustalenie, którym zalecanym aspektom nadać priorytet.
Dla kupujących cechy przedmiotu odpowiadają na pytania porównawcze, zanim przeczytają opis. Dokładne wartości zmniejszają liczbę wiadomości „czy to będzie pasować?”, a błędne wartości prowadzą do zwrotów: kupujący, który filtrował po szerokości 45 cm, oczekuje 45 cm.
Identyfikatory produktu: marka, MPN, UPC, EAN, ISBN i „Nie dotyczy”
Identyfikatory produktu to szczególna grupa cech przedmiotu. eBay opisuje je jako unikalne kody nadawane przez producenta produktu — kody GTIN, takie jak UPC, EAN i ISBN, a także marka i numer części producenta (MPN) — i podaje, że są wymagane w większości kategorii.
Gdy identyfikator pasuje do produktu w katalogu eBay, eBay sugeruje dopasowanie i może wstępnie wypełnić tytuł, zdjęcia i inne szczegóły. Akceptuj wyłącznie dokładne dopasowania: inny rok modelu lub rozmiar opakowania to inny produkt. W Inventory API eBay preferuje identyfikator produktu eBay (ePID) do dopasowania do katalogu, ponieważ jeden GTIN może odpowiadać więcej niż jednemu produktowi w katalogu.
- Marka: marka widoczna na produkcie, a nie nazwa firmy, która sprzedała go Tobie. W przypadku towarów generycznych wskazówki eBay dla deweloperów dotyczące dobrych praktyk sugerują „Unbranded”.
- MPN: numer części lub modelu producenta z karty katalogowej. Nigdy nie wpisuj tu własnego SKU. Jeśli kategoria wymaga MPN, Inventory API wymaga także marki.
- UPC, EAN lub ISBN: kod GTIN producenta dla dokładnie tego wariantu. Przed użyciem sprawdź cyfrę kontrolną.
- „Nie dotyczy”: w przypadku przedmiotów, które naprawdę nie mają identyfikatora, takich jak antyki lub wyroby na zamówienie, eBay pozwala wybrać „Nie dotyczy”. Dokładne brzmienie różni się w zależności od serwisu eBay.
Limity znaków cech przedmiotu w eBay
Limity różnią się między interfejsami API eBay, więc sprawdź, z którego korzysta Twoje narzędzie do ofert. Jeśli źródło podaje liczbę poniżej, jest to udokumentowane maksimum; poszczególne kategorie mogą dla niektórych aspektów zwracać własną maksymalną długość.
| Pole | Limit | Gdzie obowiązuje |
|---|---|---|
| Tytuł oferty | 80 znaków | Wszystkie oferty; eBay zaleca wykorzystanie wszystkich 80 |
| Podtytuł | 55 znaków | Opcjonalne płatne rozszerzenie oferty |
| Wartość cechy przedmiotu | 65 znaków (standardowo) | Trading API; niektóre aspekty dopuszczają więcej, co pokazuje aspectMaxLength |
| Nazwa aspektu / wartość aspektu | 40 / 50 znaków | Inventory API |
| Marka i MPN | po 65 znaków | Pola produktu w Inventory API |
| Wartości w aspekcie wielowartościowym | Do 30 | Aspekty z licznością MULTI (Taxonomy API) |
| Opis pozycji asortymentu (inventory item) | 4000 znaków | Opis produktu w Inventory API |
| Zdjęcia | Do 24 na ofertę | Inventory API; do 12 na wariant w grupie |
Jak znaleźć wymagane cechy przedmiotu dla kategorii
Nie istnieje jedna lista cech przedmiotu w eBay: aspekty i ich poziomy zależą od kategorii końcowej i serwisu oraz zmieniają się w czasie. Sprawdzaj je dla każdej kategorii, w której sprzedajesz.
Przy kilku ofertach wystarczy Seller Hub: wybierz kategorię w procesie wystawiania, a zobaczysz cechy Wymagane, Wymagane wkrótce, Zalecane i Dodatkowe, wraz z liczbą wyszukiwań i datą dla cech Wymagane wkrótce. Aby poprawić istniejące oferty zbiorczo, strona Aktywne oferty pozwala pobrać plik Excel z ofertami bez cech i wgrać go ponownie albo zaznaczyć kilka ofert i użyć opcji „Dodaj cechy przedmiotu”.
W przypadku dużego lub zmieniającego się katalogu użyj Taxonomy API, które zwraca te same metadane w formie czytelnej maszynowo:
- Ustal kategorię końcową przedmiotu. Aspekty są zdefiniowane dla kategorii końcowej, a nie dla kategorii nadrzędnej.
- Pobierz identyfikator drzewa kategorii dla serwisu eBay, w którym sprzedajesz.
- Wywołaj GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}. Oba parametry są wymagane.
- Odczytaj aspectConstraint.aspectRequired, aby ustalić, co jest obowiązkowe. Nie polegaj na aspectUsage: zwraca RECOMMENDED także dla aspektów wymaganych.
- Zwróć uwagę na aspectMode (SELECTION_ONLY oznacza, że musisz użyć jednej z wartości eBay) i itemToAspectCardinality (MULTI dopuszcza do 30 wartości).
- Zapisuj expectedRequiredByDate dla aspektów Wymagane wkrótce, aby wypełnić je przed terminem.
- Dla wielu kategorii naraz wywołaj fetch_item_aspects na drzewie kategorii, które zwraca aspekty dla każdej kategorii końcowej, i regularnie odświeżaj swoją kopię.
Odczytywanie metadanych aspektów
Każdy aspekt zwracany przez getItemAspectsForCategory zawiera ograniczenia, które mówią, jak go wypełnić. To właśnie te pola pozwalają zapobiec większości błędów mapowania.
| Pole | Wartości | Co z nim zrobić |
|---|---|---|
| aspectRequired | true lub false | Wiarygodny sygnał aspektu wymaganego |
| aspectUsage | RECOMMENDED lub OPTIONAL | Nadaj priorytet aspektom zalecanym, ale pamiętaj, że wymagane również pokazują RECOMMENDED |
| aspectMode | FREE_TEXT lub SELECTION_ONLY | Dla SELECTION_ONLY znormalizuj swoją wartość do jednej z wartości eBay |
| itemToAspectCardinality | SINGLE lub MULTI | Wyślij jedną wartość lub do 30 dla MULTI |
| aspectDataType / aspectFormat | np. DATE, NUMBER | Daty jako YYYY, YYYYMM lub YYYYMMDD; liczby jako całkowite lub dziesiętne |
| aspectEnabledForVariations | true lub false | Czy aspekt może służyć do definiowania wariantów, takich jak rozmiar lub kolor |
| aspectApplicableTo | PRODUCT lub ITEM | Aspekty PRODUCT opisują produkt z katalogu; aspekty ITEM opisują Twój konkretny przedmiot |
Mapowanie atrybutów z karty katalogowej dostawcy na aspekty eBay
Jeśli odsprzedajesz marki innych producentów, większość wartości cech przedmiotu już istnieje w karcie katalogowej lub karcie specyfikacji dostawcy — tylko nie w słowach eBay. Mapowanie polega na zamianie wiersza z karty katalogowej na nazwę aspektu i wartość, którą eBay zaakceptuje.
Poniższe przykłady pokazują typowe przekształcenia. Nazwy aspektów różnią się w zależności od kategorii, więc przed poleganiem na mapowaniu potwierdź każdą z nich w metadanych kategorii.
| Karta katalogowa podaje | Kandydujący aspekt | Wartość do wpisania | Sprawdź |
|---|---|---|---|
| Szerokość całkowita 45 cm | Szerokość przedmiotu | 45 cm | Użyj wymiaru całkowitego, a nie rozmiaru opakowania |
| Producent: Nordlicht Leuchten GmbH | Marka | Nordlicht | Marka widoczna na produkcie, a nie nazwa podmiotu prawnego |
| Nr artykułu NL-2210-BK | MPN | NL-2210-BK | Numer producenta, a nie Twoje SKU |
| EAN 6291041500213 | EAN | 6291041500213 | Sprawdź cyfrę kontrolną; jeden GTIN na wariant |
| Kolor obudowy RAL 9005 głęboka czerń | Kolor | Czarny | Wybierz wartość eBay; kod RAL zachowaj w opisie |
| Wierzch: 100% bawełna organiczna | Materiał | Bawełna | Wspomnij o „organicznej”, jeśli pozwala na to kategoria lub opis |
| Napięcie znamionowe 220–240 V AC | Napięcie, jeśli kategoria je oferuje | 220–240 V | Nazwy i formaty aspektów różnią się w zależności od kategorii |
Przykłady kategorii: elektronika, odzież i zabawki
Poniższe aspekty są często wymagane w tych kategoriach i pokazują, skąd zwykle pochodzą wartości. Mają charakter wyłącznie poglądowy: rzeczywiste nazwy i poziomy zależą od kategorii końcowej i serwisu, więc sprawdź je w sposób opisany wyżej.
W przypadku odzieży i obuwia strony pomocy eBay opisują przejście w 2026 r. na standaryzowane wartości rozmiarów, w ramach którego oferty z brakującymi lub niejasnymi rozmiarami mogą zostać ukryte. Sprawdź aktualną pomoc eBay „Tworzenie oferty”, zanim zaczniesz polegać na starszych konwencjach rozmiarów.
| Kategoria | Aspekty, które często zobaczysz | Gdzie zwykle znajdują się dane | Na co uważać |
|---|---|---|---|
| Elektronika użytkowa | Marka, Model, MPN, Typ, Łączność, Kolor | Informacje o zamawianiu i tabele danych technicznych | Nazwa modelu a numer części; regionalne warianty wtyczek i napięcia |
| Odzież | Marka, Dział, Typ rozmiaru, Rozmiar, Kolor, Styl, Materiał | Tabele rozmiarów i etykiety ze składem włókien | Jeden rozmiar i kolor na wariant; spójne systemy rozmiarów |
| Zabawki | Marka, Typ, Poziom wiekowy, Postać lub franczyza, Materiał | Tekst na opakowaniu, ograniczenia wiekowe i ostrzeżenia | Wartości wieku muszą odpowiadać oznaczeniu wieku i ostrzeżeniom producenta |
Typowe błędy w cechach przedmiotu
Większość problemów z cechami przedmiotu wynika z kopiowania wartości bez sprawdzenia, czego oczekuje eBay. To błędy, które najczęściej kosztują widoczność lub powodują zwroty.
- Wypełnianie tylko aspektów Wymaganych i pomijanie Zalecanych, według których filtrują kupujący.
- Używanie aspectUsage zamiast aspectRequired do ustalenia, co jest obowiązkowe, podczas pracy z API.
- Wpisywanie dowolnego tekstu w aspekcie SELECTION_ONLY albo pisownia marki niezgodna z listą eBay.
- Wpisywanie SKU w polu MPN lub kodu kreskowego kupionego od odsprzedawcy w polu UPC lub EAN.
- Wybieranie „Nie dotyczy” dla identyfikatora, który produkt faktycznie ma.
- Mieszanie jednostek (45 cm w jednej ofercie, 450 mm w innej), przez co filtry dzielą tę samą wartość.
- Używanie wymiarów opakowania tam, gdzie aspekt pyta o wymiary przedmiotu.
- Powtarzanie fraz marketingowych w wartościach aspektów zamiast zwykłych wartości atrybutów.
- Ustawienie wartości raz i nigdy więcej niesprawdzanie kategorii pod kątem nowych aspektów Wymagane wkrótce.
Lista kontrolna cech przedmiotu w eBay i przygotowanie wartości na dużą skalę
Przejdź tę listę dla każdej kategorii, zanim partia ofert pójdzie na żywo. Wolną częścią zwykle jest zebranie dokładnych wartości z dokumentów dostawców, a nie ich wpisywanie.
Doc2Shelf pomaga w tym pierwszym kroku. Odczytuje pliki PDF dostawców, wyodrębnia kandydujące atrybuty — oceniając pewność każdej ekstrakcji i zachowując dla każdego wyodrębnionego faktu stronę źródłową i krótki cytat — oraz przygotowuje przeznaczone dla eBay robocze teksty i kandydujące wartości cech przedmiotu do Twojej weryfikacji. Nowe połączenia z eBay pojawią się wkrótce; konta już połączone mogą nadal publikować. Nowi użytkownicy eksportują zweryfikowane teksty jako ogólny plik CSV lub JSON, który nie jest schematem importu eBay, a następnie wpisują wartości w Seller Hub lub we własnym narzędziu do ofert.
- Kategoria końcowa potwierdzona dla serwisu, w którym sprzedajesz.
- Wszystkie aspekty Wymagane wypełnione; aspekty Wymagane wkrótce wypełnione przed ich datą.
- Zalecane aspekty o dużej liczbie wyszukiwań wypełnione.
- Marka, MPN i GTIN pobrane z dokumentów producenta i sprawdzone.
- Wartości typu „tylko wybór” znormalizowane do wartości eBay.
- Jednostki i formaty spójne w całych ofertach.
- Wartości mieszczą się w udokumentowanych limitach znaków.
- Dopasowania do katalogu akceptowane tylko wtedy, gdy to dokładnie ten sam produkt.
Najczęściej zadawane pytania
- Czym są cechy przedmiotu w eBay?
- To ustrukturyzowane szczegóły typu nazwa–wartość dotyczące przedmiotu, takie jak marka, rozmiar, kolor i materiał. eBay używa ich do filtrów wyszukiwania, Best Match i dopasowania do katalogu. W interfejsach API eBay nazywane są aspektami przedmiotu.
- Czy zalecane cechy przedmiotu są wymagane?
- Nie. Ofertę blokują tylko cechy Wymagane. Zalecane opierają się na danych o popycie kupujących i popularnych wyszukiwaniach, a Twój przedmiot pojawia się w przefiltrowanych wynikach tylko dla wypełnionych cech, więc warto je uzupełnić.
- Czy cechy przedmiotu pomagają w pozycji w wyszukiwarce eBay?
- Tak. Best Match w eBay bierze pod uwagę kompletność oferty, a eBay podaje, że cechy przedmiotu zwiększają szanse na znalezienie w eBay, Google Shopping i zewnętrznych wyszukiwarkach.
- Co oznacza „Nie dotyczy” w eBay?
- Informuje eBay, że przedmiot nie ma identyfikatora produktu danego typu, na przykład antyk lub przedmiot wykonany na zamówienie. Używaj tej opcji tylko wtedy, gdy to prawda; nie używaj jej, aby pominąć identyfikator, który produkt ma.
- Jak długa może być wartość cechy przedmiotu?
- Standardowe maksimum to 65 znaków w Trading API, a niektóre aspekty dopuszczają więcej. W Inventory API nazwy aspektów są ograniczone do 40 znaków, a wartości do 50.
- Ile znaków może mieć tytuł w eBay?
- Osiemdziesiąt. eBay zaleca wykorzystanie wszystkich 80 znaków na istotne szczegóły, takie jak marka, model i kluczowe atrybuty. Płatny podtytuł pozwala na kolejne 55 znaków.
- Dlaczego API eBay pokazuje wymagany aspekt jako RECOMMENDED?
- W getItemAspectsForCategory aspectUsage ma wartość RECOMMENDED lub OPTIONAL, a aspekty wymagane również zwracają RECOMMENDED. Sprawdź aspectConstraint.aspectRequired, aby zobaczyć, czy aspekt jest obowiązkowy.
- Jak dodać cechy przedmiotu do wielu ofert naraz?
- W Aktywnych ofertach w Seller Hub pobierz plik Excel z ofertami bez cech Wymaganych, Wymaganych wkrótce lub Zalecanych, uzupełnij go i wgraj ponownie — albo zaznacz kilka ofert i użyj opcji „Dodaj cechy przedmiotu”.