가이드
eBay 상품별 정보: 의미와 입력 방법
상품별 정보는 구매자가 eBay 검색을 필터링할 때 내 상품이 노출되는지를 좌우합니다. 이 가이드는 네 가지 등급, 제품 식별자, 글자 수 제한, 카테고리의 항목을 조회하는 방법, 공급업체 사양을 깔끔한 값으로 바꾸는 방법을 다룹니다.
상품별 정보(item specifics)는 eBay 리스팅의 구조화된 이름–값 쌍입니다. 예를 들면 Brand: Nordlicht, Colour: Black, Item Width: 45 cm 같은 것입니다. eBay는 이를 구매자에게 상품에 대해 알려 주는 설명 키워드라고 설명하며, eBay API에서는 item aspects라고 부릅니다.
상품별 정보는 장식이 아닙니다. eBay는 이를 사용해 상품을 필터링된 검색 결과에 노출하고, 리스팅이 얼마나 충실한지 판단하며, 제품 카탈로그와 매칭합니다. 이를 올바르게 채우는 일은 대부분 데이터 작업입니다. 카테고리가 어떤 항목을 요구하는지 파악하고, 그 항목에 넣을 정확한 값을 갖추는 것입니다.
eBay 상품별 정보란
eBay의 모든 카테고리에는 고유한 항목(aspect) 세트가 있습니다. 노트북 카테고리는 프로세서와 화면 크기를, 의류 카테고리는 사이즈와 부문(department)을 묻고, 대부분의 카테고리는 브랜드를 묻습니다. 각 항목에는 eBay가 정한 이름이 있으며, 값은 eBay 목록에서 선택하거나 카테고리가 허용하는 경우 자유 텍스트로 직접 입력합니다.
상품별 정보는 제목과 설명 안이 아니라 그 옆에 위치합니다. 구매자는 리스팅 페이지의 구조화된 블록에서 이를 보며, eBay 검색은 왼쪽 열의 필터(브랜드, 사이즈, 색상, 상태 등)에 이를 사용합니다. 설명에만 들어 있는 세부 정보는 이러한 필터에 사용될 수 없습니다.
Required, Required Soon, Recommended, Additional
Seller Hub의 리스팅 흐름에서 eBay는 카테고리의 상품별 정보를 네 가지 등급으로 묶습니다. 이 등급은 eBay가 지금 강제하는 것, 나중에 강제할 것, 구매자가 검색하는 것을 알려 줍니다.
| 등급 | 의미 | 비워 두면 |
|---|---|---|
| Required | 신규 또는 수정 리스팅에는 반드시 입력해야 합니다 | 상품을 등록하거나 수정할 수 없습니다 |
| Required Soon | 곧 필수가 되며, 리스팅 흐름에 날짜가 표시됩니다 | 아직 강제되지 않으며 표시된 날짜부터 Required로 취급됩니다 |
| Recommended | 구매자 수요 데이터와 인기 검색어를 기준으로 합니다 | 필터링된 검색에서 리스팅이 매칭되지 않을 수 있습니다 |
| Additional | 카테고리에 대한 선택적 추가 세부 정보입니다 | 제한은 없으며, 리스팅에 담기는 세부 정보가 적어질 뿐입니다 |
상품별 정보가 검색, 필터, 구매자에 미치는 영향
eBay는 필터에 대해 분명히 말합니다. 해당하는 상품별 정보를 추가한 경우에만 필터링된 검색 결과에 상품이 노출됩니다. 브랜드나 사이즈로 검색을 필터링하는 구매자는 그 항목을 비워 둔 리스팅을 제목이 아무리 좋아도 볼 수 없습니다.
상품별 정보는 순위에도 영향을 줍니다. eBay의 Best Match 요소에는 리스팅의 충실도와 구매자의 검색어와의 일치도가 포함됩니다. eBay의 판매자 안내에 따르면 상품별 정보는 eBay, Google Shopping, 외부 검색 결과에서 발견될 가능성을 높이며, 리스팅 흐름에는 각 항목이 최근 30일 동안 얼마나 검색되었는지가 표시되므로 어떤 Recommended 항목을 우선할지 정하는 데 유용합니다.
구매자에게 상품별 정보는 설명을 읽기 전에 비교 질문에 대한 답이 됩니다. 정확한 값은 “이게 맞을까요?”라는 문의를 줄이고, 잘못된 값은 반품으로 이어집니다. 너비 45 cm로 필터링한 구매자는 45 cm를 기대합니다.
제품 식별자: Brand, MPN, UPC, EAN, ISBN, 그리고 “Does not apply”
제품 식별자는 상품별 정보 중 특별한 그룹입니다. eBay는 이를 제품 제조업체가 만든 고유 코드, 즉 UPC, EAN, ISBN 같은 GTIN과 브랜드, 제조업체 부품 번호(MPN)라고 설명하며 대부분의 카테고리에서 필수라고 밝힙니다.
식별자가 eBay 카탈로그의 제품과 일치하면 eBay가 일치 항목을 제안하고 제목, 사진, 기타 세부 정보를 미리 채울 수 있습니다. 정확히 일치하는 항목만 수락하세요. 연식이나 팩 크기가 다르면 다른 제품입니다. Inventory API에서 eBay는 하나의 GTIN이 둘 이상의 카탈로그 제품에 대응될 수 있으므로 카탈로그 매칭에 eBay 제품 ID(ePID)를 선호합니다.
- Brand: 제품에 표시된 브랜드이며, 귀하에게 판매한 회사의 이름이 아닙니다. 일반 상품의 경우 eBay 개발자 모범 사례 안내는 “Unbranded”를 권장합니다.
- MPN: 데이터 시트에 기재된 제조업체의 부품 번호 또는 모델 번호입니다. 자체 SKU를 넣어서는 안 됩니다. 카테고리에서 MPN을 요구하는 경우 Inventory API는 브랜드도 요구합니다.
- UPC, EAN, ISBN: 정확히 해당 변형(variant)에 대한 제조업체의 GTIN입니다. 사용하기 전에 체크 디지트를 검증하세요.
- “Does not apply”: 골동품이나 맞춤 제작 상품처럼 실제로 식별자가 없는 상품의 경우 eBay에서 “Does not apply”를 선택할 수 있습니다. 정확한 표현은 eBay 마켓플레이스마다 다릅니다.
eBay 상품별 정보 글자 수 제한
제한은 eBay API마다 다르므로 사용 중인 리스팅 도구가 어느 API를 쓰는지 확인하세요. 아래에 출처가 제시한 숫자는 문서화된 최댓값이며, 일부 항목은 카테고리별로 자체 최대 길이를 반환할 수 있습니다.
| 필드 | 제한 | 적용 대상 |
|---|---|---|
| 리스팅 제목 | 80자 | 모든 리스팅. eBay는 80자를 모두 사용하도록 권장 |
| 부제목 | 55자 | 선택 유료 리스팅 업그레이드 |
| 상품별 정보 값 | 65자(표준) | Trading API. 일부 항목은 더 길게 허용하며 aspectMaxLength로 표시됨 |
| 항목 이름 / 항목 값 | 40 / 50자 | Inventory API |
| Brand 및 MPN | 각각 65자 | Inventory API 제품 필드 |
| 다중 값 항목의 값 개수 | 최대 30개 | MULTI 카디널리티를 가진 항목(Taxonomy API) |
| Inventory 아이템 설명 | 4,000자 | Inventory API 제품 설명 |
| 사진 | 리스팅당 최대 24장 | Inventory API. 그룹 내 변형당 최대 12장 |
카테고리의 필수 상품별 정보를 찾는 방법
모든 곳에 공통으로 적용되는 단일 eBay 상품별 정보 목록은 없습니다. 항목과 그 등급은 리프 카테고리와 마켓플레이스에 따라 다르며 시간이 지나면서 바뀝니다. 판매하는 카테고리마다 직접 조회하세요.
리스팅이 몇 건 안 된다면 Seller Hub로 충분합니다. 리스팅 흐름에서 카테고리를 선택하면 Required, Required Soon, Recommended, Additional 상품별 정보가 검색 횟수와 Required Soon 날짜와 함께 표시됩니다. 기존 리스팅을 대량으로 수정하려면 Active Listings 페이지에서 상품별 정보가 누락된 리스팅의 Excel 파일을 내려받아 다시 업로드하거나, 여러 리스팅을 선택해 “Add item specifics”를 사용할 수 있습니다.
카탈로그가 크거나 자주 바뀐다면 같은 메타데이터를 기계 판독 형식으로 반환하는 Taxonomy API를 사용하세요.
- 상품의 리프 카테고리를 파악합니다. 항목은 상위 카테고리가 아니라 리프 카테고리별로 정의됩니다.
- 판매하는 eBay 마켓플레이스의 카테고리 트리 ID를 가져옵니다.
- GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}를 호출합니다. 두 파라미터 모두 필수입니다.
- 무엇이 필수인지 판단하려면 aspectConstraint.aspectRequired를 읽습니다. 필수 항목에도 RECOMMENDED가 반환되므로 aspectUsage에 의존하지 마세요.
- aspectMode(SELECTION_ONLY는 eBay가 제공하는 값 중 하나를 써야 한다는 뜻)와 itemToAspectCardinality(MULTI는 최대 30개 값을 허용)를 확인합니다.
- Required Soon 항목은 기한 전에 채울 수 있도록 expectedRequiredByDate를 저장해 둡니다.
- 여러 카테고리를 한꺼번에 처리하려면 카테고리 트리에서 fetch_item_aspects를 호출하세요. 모든 리프 카테고리의 항목을 반환하므로 정기적으로 사본을 갱신하세요.
항목 메타데이터 읽는 법
getItemAspectsForCategory가 반환하는 각 항목에는 채우는 방법을 알려 주는 제약 조건이 담겨 있습니다. 매핑 오류의 대부분은 이 필드로 예방할 수 있습니다.
| 필드 | 값 | 활용 방법 |
|---|---|---|
| aspectRequired | true 또는 false | 필수 항목을 판단하는 신뢰할 수 있는 신호 |
| aspectUsage | RECOMMENDED 또는 OPTIONAL | 권장 항목을 우선하되, 필수 항목도 RECOMMENDED로 표시된다는 점에 유의 |
| aspectMode | FREE_TEXT 또는 SELECTION_ONLY | SELECTION_ONLY의 경우 값을 eBay가 제공하는 값 중 하나로 맞춤 |
| itemToAspectCardinality | SINGLE 또는 MULTI | 값을 하나 보내거나, MULTI의 경우 최대 30개를 보냄 |
| aspectDataType / aspectFormat | 예: DATE, NUMBER | 날짜는 YYYY, YYYYMM 또는 YYYYMMDD, 숫자는 정수 또는 소수 |
| aspectEnabledForVariations | true 또는 false | 사이즈나 색상처럼 변형을 정의하는 데 항목을 사용할 수 있는지 여부 |
| aspectApplicableTo | PRODUCT 또는 ITEM | PRODUCT 항목은 카탈로그 제품을, ITEM 항목은 특정 상품을 설명 |
공급업체 데이터 시트 속성을 eBay 항목에 매핑하기
다른 브랜드의 상품을 재판매한다면 상품별 정보 값의 대부분은 이미 공급업체의 데이터 시트나 사양서에 있습니다. 다만 eBay의 용어로 쓰여 있지 않을 뿐입니다. 매핑은 데이터 시트의 한 줄을 항목 이름과 eBay가 받아들이는 값으로 바꾸는 작업입니다.
아래 예시는 일반적인 변환 방식을 보여 줍니다. 항목 이름은 카테고리마다 다르므로, 매핑에 의존하기 전에 카테고리 메타데이터로 각각 확인하세요.
| 데이터 시트 기재 내용 | 후보 항목 | 입력할 값 | 확인 사항 |
|---|---|---|---|
| 전체 너비 45 cm | Item Width | 45 cm | 포장 크기가 아니라 제품 전체 치수를 사용 |
| 제조업체: Nordlicht Leuchten GmbH | Brand | Nordlicht | 법인명이 아니라 제품에 표시된 브랜드 |
| 품번 NL-2210-BK | MPN | NL-2210-BK | 자체 SKU가 아니라 제조업체의 번호 |
| EAN 6291041500213 | EAN | 6291041500213 | 체크 디지트를 검증. 변형당 GTIN 하나 |
| 하우징 색상 RAL 9005 제트 블랙 | Colour | Black | eBay의 값을 선택하고 RAL 코드는 설명에 유지 |
| 겉감: 유기농 면 100% | Material | Cotton | 카테고리나 설명에서 허용하는 경우 “organic”을 언급 |
| 정격 전압 220–240 V AC | Voltage(카테고리에서 제공하는 경우) | 220–240 V | 항목 이름과 형식은 카테고리마다 다름 |
카테고리 예시: 전자제품, 의류, 완구
아래 항목은 해당 카테고리에서 흔히 요청되며, 값이 보통 어디에서 나오는지 보여 줍니다. 어디까지나 예시이고, 실제 이름과 등급은 리프 카테고리와 마켓플레이스에 따라 다르므로 위에 설명한 대로 조회하세요.
의류와 신발의 경우 eBay 도움말 페이지는 2026년에 표준화된 사이즈 값으로 전환한다고 설명하며, 이에 따라 사이즈가 없거나 불분명한 리스팅은 숨겨질 수 있습니다. 이전의 사이즈 표기 방식에 의존하기 전에 eBay의 최신 “Creating a listing” 도움말을 확인하세요.
| 카테고리 | 자주 보이는 항목 | 데이터가 보통 있는 곳 | 주의할 점 |
|---|---|---|---|
| 가전제품 | Brand(브랜드), Model(모델), MPN, Type(유형), Connectivity(연결 방식), Colour(색상) | 주문 정보와 기술 데이터 표 | 모델명과 부품 번호의 구분. 지역별 플러그 및 전압 변형 |
| 의류 | Brand(브랜드), Department(부문), Size Type(사이즈 유형), Size(사이즈), Colour(색상), Style(스타일), Material(소재) | 사이즈표와 섬유 조성 라벨 | 변형당 사이즈와 색상 하나. 일관된 사이즈 체계 |
| 완구 | Brand(브랜드), Type(유형), Age Level(연령대), Character or Franchise(캐릭터 또는 프랜차이즈), Material(소재) | 포장 문구, 연령 구분, 경고 문구 | 연령 값은 제조업체의 연령 구분 및 경고와 일치해야 함 |
상품별 정보에서 흔한 실수
상품별 정보 문제의 대부분은 eBay가 기대하는 바를 확인하지 않고 값을 복사하는 데서 생깁니다. 다음은 노출 기회를 잃거나 반품을 일으키는 가장 흔한 실수입니다.
- Required 항목만 채우고 구매자가 필터링에 사용하는 Recommended 항목은 무시하는 것.
- API 사용 시 무엇이 필수인지 판단하는 데 aspectRequired 대신 aspectUsage를 사용하는 것.
- SELECTION_ONLY 항목에 자유 텍스트 값을 입력하거나, eBay 목록과 일치하지 않는 철자의 브랜드를 입력하는 것.
- MPN에 자체 SKU를 넣거나, UPC 또는 EAN에 재판매업체가 구매한 바코드를 넣는 것.
- 제품에 실제로 있는 식별자인데 “Does not apply”를 선택하는 것.
- 단위를 섞어 쓰는 것(한 리스팅에는 45 cm, 다른 리스팅에는 450 mm). 필터가 같은 값을 나눠서 취급하게 됩니다.
- 항목이 상품 치수를 요구하는데 포장 치수를 사용하는 것.
- 항목 값에 단순한 속성 값 대신 마케팅 문구를 반복해서 넣는 것.
- 값을 한 번 설정하고 새로운 Required Soon 항목이 있는지 카테고리를 다시 확인하지 않는 것.
eBay 상품별 정보 체크리스트와 대규모 값 준비
리스팅 묶음을 게시하기 전에 카테고리별로 이 목록을 확인하세요. 시간이 오래 걸리는 부분은 보통 값을 입력하는 일이 아니라 공급업체 문서에서 정확한 값을 모으는 일입니다.
Doc2Shelf는 이 첫 단계를 돕습니다. 공급업체 PDF를 읽고 후보 속성을 추출하며, 추출마다 신뢰도 점수를 매기고 추출한 각 사실의 원본 페이지와 짧은 인용문을 보관합니다. 그런 다음 검토용으로 eBay용 문안 초안과 후보 상품별 정보 값을 준비합니다. 새로운 eBay 연결은 곧 제공될 예정이며, 이미 연결된 계정은 계속 게시할 수 있습니다. 신규 사용자는 검토를 마친 문안을 일반 CSV 또는 JSON으로 내보낸 다음(eBay 가져오기 스키마가 아닙니다) Seller Hub나 자체 리스팅 도구에 값을 입력합니다.
- 판매하는 마켓플레이스 기준으로 리프 카테고리를 확인했다.
- 모든 Required 항목을 채웠고, Required Soon 항목은 기한 전에 채웠다.
- 검색 횟수가 많은 Recommended 항목을 채웠다.
- Brand, MPN, GTIN을 제조업체 문서에서 가져와 확인했다.
- Selection-only 값을 eBay가 제공하는 값에 맞게 조정했다.
- 리스팅 전반에서 단위와 형식이 일관된다.
- 값이 문서화된 글자 수 제한 이내이다.
- 카탈로그 매칭은 정확히 같은 제품일 때만 수락했다.
자주 묻는 질문
- eBay의 상품별 정보(item specifics)란 무엇인가요?
- 브랜드, 사이즈, 색상, 소재처럼 상품에 대한 구조화된 이름–값 형식의 세부 정보입니다. eBay는 이를 검색 필터, Best Match, 카탈로그 매칭에 사용합니다. eBay API에서는 item aspects라고 부릅니다.
- Recommended 상품별 정보도 필수인가요?
- 아니요. 리스팅을 막는 것은 Required 항목뿐입니다. Recommended 항목은 구매자 수요 데이터와 인기 검색어를 바탕으로 하며, 상품은 채워 넣은 상품별 정보에 해당하는 필터링 결과에만 노출되므로 채워 두는 것이 좋습니다.
- 상품별 정보가 eBay 검색 순위에 도움이 되나요?
- 네. eBay의 Best Match는 리스팅의 충실도를 고려하며, eBay는 상품별 정보가 eBay, Google Shopping, 외부 검색 엔진에서 발견될 가능성을 높인다고 밝히고 있습니다.
- eBay의 “Does not apply”는 무슨 뜻인가요?
- 해당 유형의 제품 식별자가 없는 상품(예: 골동품이나 맞춤 제작 상품)임을 eBay에 알리는 것입니다. 실제로 그런 경우에만 사용하고, 제품에 있는 식별자를 건너뛰는 데 사용하지 마세요.
- 상품별 정보 값은 몇 자까지 가능한가요?
- Trading API의 표준 최대 길이는 65자이며 일부 항목은 더 길게 허용합니다. Inventory API에서는 항목 이름이 40자, 값이 50자로 제한됩니다.
- eBay 제목은 몇 자까지 쓸 수 있나요?
- 80자입니다. eBay는 브랜드, 모델, 주요 속성 같은 관련 세부 정보에 80자를 모두 사용하도록 권장합니다. 유료 부제목은 55자를 추가로 허용합니다.
- eBay API에서 필수 항목이 RECOMMENDED로 표시되는 이유는 무엇인가요?
- getItemAspectsForCategory에서 aspectUsage는 RECOMMENDED 또는 OPTIONAL이며, 필수 항목도 RECOMMENDED를 반환합니다. 항목이 필수인지는 aspectConstraint.aspectRequired로 확인하세요.
- 여러 리스팅에 한꺼번에 상품별 정보를 추가하려면 어떻게 하나요?
- Seller Hub의 Active Listings에서 Required, Required Soon 또는 Recommended 상품별 정보가 누락된 리스팅의 Excel 파일을 내려받아 채운 다음 다시 업로드하거나, 여러 리스팅을 선택해 “Add item specifics”를 사용하세요.