指南
eBay 商品属性(Item Specifics):含义及填写方法
商品属性决定买家在 eBay 搜索中使用筛选条件时能否找到您的商品。本指南涵盖四个层级、产品标识符、字符数限制、如何查询类目的属性,以及如何将供应商规格转换为规范的属性值。
商品属性是 eBay 商品列表上结构化的“名称–值”对,例如:品牌:Nordlicht,颜色:黑色,商品宽度:45 厘米。eBay 将其描述为向买家介绍您商品的描述性关键词,在 eBay 的 API 中称为 item aspects(商品属性)。
它们不只是装饰。eBay 利用它们将您的商品放入经筛选的搜索结果,评判商品列表的完整程度,并将其与产品目录相匹配。把它们填好主要是一项数据工作:了解类目需要哪些属性,并拥有准确的值来填写。
什么是 eBay 商品属性
每个 eBay 类目都有自己的一组属性。笔记本电脑类目可能要求填写处理器和屏幕尺寸,服装类目要求填写尺码和部门,而大多数类目都要求填写品牌。每个属性都有一个由 eBay 指定的名称和一个由您提供的值——值可以从 eBay 的列表中选择,或在类目允许时以自由文本输入。
商品属性与标题和描述并列,而不包含在其中。买家在商品页面上的结构化区块中看到它们,eBay 搜索也用它们来生成左侧栏的筛选条件——品牌、尺码、颜色、成色等。仅出现在描述中的细节无法被这些筛选条件使用。
必填、即将必填、推荐和附加
在 Seller Hub 的刊登流程中,eBay 将类目的商品属性分为四个层级。该层级会告诉您 eBay 目前强制要求什么、以后将强制要求什么,以及买家在搜索什么。
| 层级 | 含义 | 如果留空 |
|---|---|---|
| 必填(Required) | 任何新建或修改的商品列表都必须填写 | 无法刊登或修改该商品 |
| 即将必填(Required Soon) | 将变为必填;刊登流程会显示日期 | 目前尚未强制执行;自所显示的日期起按必填处理 |
| 推荐(Recommended) | 基于买家需求数据和热门搜索 | 商品列表可能无法匹配经筛选的搜索 |
| 附加(Additional) | 该类目可选的额外详情 | 无限制;商品列表只是详情较少 |
商品属性如何影响搜索、筛选和买家
eBay 对筛选的说法很明确:只有添加了相应的商品属性,您的商品才会出现在经筛选的搜索结果中。按品牌或尺码筛选搜索的买家,永远看不到漏填该字段的商品列表,无论其标题多么出色。
商品属性还会影响排名。eBay 的 Best Match(最佳匹配)排序因素包括商品列表的完整程度及其与买家搜索词的匹配程度。eBay 的卖家指南称,商品属性会增加您的商品在 eBay、Google Shopping 和外部搜索结果中被发现的机会,而且刊登流程会显示每个属性在过去 30 天内被搜索的频率——这是决定优先填写哪些推荐属性的有用参考。
对买家而言,商品属性能在他们阅读描述之前回答比较类问题。准确的值能减少“这个合适吗?”之类的咨询,错误的值则会导致退货:按 45 厘米宽度筛选的买家期望收到的就是 45 厘米。
产品标识符:品牌、MPN、UPC、EAN、ISBN 以及“不适用”
产品标识符是一类特殊的商品属性。eBay 将其描述为产品制造商创建的唯一代码——UPC、EAN 和 ISBN 等 GTIN,以及品牌和制造商零件编号 (MPN)——并称大多数类目都要求提供。
当标识符与 eBay 产品目录中的某个产品匹配时,eBay 会推荐该匹配项,并可预填标题、照片和其他详情。请只接受完全匹配的结果:不同的型号年份或包装规格就是不同的产品。在 Inventory API 中,eBay 更倾向于使用 eBay 产品 ID (ePID) 进行目录匹配,因为一个 GTIN 可能对应多个目录产品。
- 品牌:产品上显示的品牌,而不是向您出售该商品的公司名称。对于通用商品,eBay 开发者最佳实践指南建议填写“Unbranded”。
- MPN:数据表中的制造商零件编号或型号。切勿在此填写您自己的 SKU。如果类目要求填写 MPN,Inventory API 同时还要求填写品牌。
- UPC、EAN 或 ISBN:该确切变体的制造商 GTIN。使用前请验证校验位。
- “不适用”(Does not apply):对于确实没有标识符的商品,如古董或定制商品,eBay 允许选择“Does not apply”。具体措辞因 eBay 站点而异。
eBay 商品属性字符数限制
各 eBay API 的限制不同,因此请确认您的刊登工具使用的是哪一个。下文中凡来源给出数字的,均为文档记载的最大值;个别类目针对某些属性可能返回各自的最大长度。
| 字段 | 限制 | 适用范围 |
|---|---|---|
| 商品标题 | 80 个字符 | 所有商品列表;eBay 建议用满 80 个字符 |
| 副标题 | 55 个字符 | 可选的付费刊登升级 |
| 商品属性值 | 65 个字符(标准) | Trading API;部分属性允许更长,以 aspectMaxLength 显示 |
| 属性名称 / 属性值 | 40 / 50 个字符 | Inventory API |
| 品牌和 MPN | 各 65 个字符 | Inventory API 产品字段 |
| 多值属性中的值 | 最多 30 个 | 基数为 MULTI 的属性(Taxonomy API) |
| 库存商品描述 | 4,000 个字符 | Inventory API 产品描述 |
| 照片 | 每个商品列表最多 24 张 | Inventory API;一组变体中每个变体最多 12 张 |
如何查找类目的必填商品属性
并不存在统一的 eBay 商品属性清单:属性及其层级取决于末级类目和站点,而且会随时间变化。请针对您销售的每个类目分别查询。
对于少量商品列表,Seller Hub 就足够了:在刊登流程中选择类目,它会显示必填、即将必填、推荐和附加属性,以及搜索次数和任何“即将必填”的日期。要批量修复现有商品列表,可在“在售商品”页面下载缺少属性的商品列表 Excel 文件并重新上传,或选择多个商品列表后使用“添加商品属性”。
对于规模较大或经常变化的目录,请使用 Taxonomy API,它以机器可读的形式返回相同的元数据:
- 确定商品的末级类目。属性是按末级类目定义的,而不是按上级类目。
- 获取您销售所在 eBay 站点的类目树 ID。
- 调用 GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}。两个参数均为必填。
- 读取 aspectConstraint.aspectRequired 来判断哪些属性是必填的。不要依赖 aspectUsage:对必填属性它同样返回 RECOMMENDED。
- 留意 aspectMode(SELECTION_ONLY 表示必须使用 eBay 提供的值之一)和 itemToAspectCardinality(MULTI 最多允许 30 个值)。
- 保存“即将必填”属性的 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 厘米 | 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(棉) | 在类目或描述允许时注明“有机” |
| 额定电压 220–240 V AC | Voltage(如果类目提供) | 220–240 V | 属性名称和格式因类目而异 |
类目示例:电子产品、服装和玩具
下列属性是这些类目中常被要求填写的,并说明数值通常来自何处。它们仅作示例:实际名称和层级取决于末级类目和站点,因此请按上述方法查询。
对于服装和鞋类,eBay 帮助页面介绍了 2026 年向标准化尺码值的转变,届时缺失或不明确尺码的商品列表可能会被隐藏。在依赖旧的尺码惯例之前,请查看 eBay 当前的“创建商品列表”帮助。
| 类目 | 常见属性 | 数据通常所在位置 | 注意事项 |
|---|---|---|---|
| 消费类电子产品 | Brand(品牌)、Model(型号)、MPN、Type(类型)、Connectivity(连接方式)、Colour(颜色) | 订购信息和技术数据表 | 型号名称与零件编号的区别;各地区插头和电压的变体 |
| 服装 | Brand(品牌)、Department(部门)、Size Type(尺码类型)、Size(尺码)、Colour(颜色)、Style(款式)、Material(材质) | 尺码表和纤维成分标签 | 每个变体一种尺码和颜色;尺码体系保持一致 |
| 玩具 | Brand(品牌)、Type(类型)、Age Level(适用年龄)、Character or Franchise(角色或系列)、Material(材质) | 包装文字、年龄分级和警告 | 年龄值必须与制造商的年龄分级和警告一致 |
常见的商品属性错误
大多数商品属性问题源于未核实 eBay 的要求就直接复制数值。以下是最常导致曝光减少或引起退货的错误。
- 只填写必填属性,而忽略买家会用来筛选的推荐属性。
- 使用 API 时,用 aspectUsage 而不是 aspectRequired 来判断哪些属性是必填的。
- 在 SELECTION_ONLY 属性中输入自由文本值,或者品牌的拼写与 eBay 列表不一致。
- 在 MPN 中填写您的 SKU,或在 UPC 或 EAN 中填写转售商购买的条形码。
- 对产品实际具有的标识符选择“Does not apply”。
- 混用单位(一个商品列表用 45 厘米,另一个用 450 毫米),导致筛选条件将同一个值拆分开来。
- 在属性要求填写商品尺寸时,使用了包装尺寸。
- 在属性值中重复营销用语,而不是填写简明的属性值。
- 一次性设置好属性值后,不再复查类目是否出现新的“即将必填”属性。
eBay 商品属性检查清单与大规模准备属性值
在一批商品列表上线之前,请针对每个类目逐项核对此清单。通常耗时的部分是从供应商文档中收集准确的值,而不是录入。
Doc2Shelf 可以帮助完成这第一步。它读取供应商 PDF,提取候选属性——为每次提取打置信度评分,并为每个提取的事实保留来源页面和一小段引文——并准备针对 eBay 的文案草稿和候选商品属性值,供您审核。新的 eBay 连接即将推出;已连接的账户可继续发布。新用户可将审核后的文案导出为通用 CSV 或 JSON(这不是 eBay 的导入架构),然后在 Seller Hub 或自己的刊登工具中录入这些值。
- 已确认所销售站点对应的末级类目。
- 所有必填属性均已填写;“即将必填”属性在日期之前填写完毕。
- 搜索次数较高的推荐属性已填写。
- 品牌、MPN 和 GTIN 取自制造商的文档并经过核对。
- 仅限选择的值已规范化为 eBay 提供的值。
- 各商品列表的单位和格式保持一致。
- 各值均在文档记载的字符数限制之内。
- 仅在确为同一产品时才接受目录匹配。
常见问题解答
- eBay 上的商品属性是什么?
- 它们是关于商品的结构化“名称–值”详情,例如品牌、尺码、颜色和材质。eBay 将其用于搜索筛选、Best Match 和目录匹配。在 eBay 的 API 中,它们称为 item aspects。
- 推荐的商品属性是必填的吗?
- 不是。只有必填属性才会阻止商品列表的刊登。推荐属性基于买家需求数据和热门搜索,而且您的商品只会在您已填写的属性对应的筛选结果中出现,因此值得填写完整。
- 商品属性有助于提高 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)中,下载缺少必填、即将必填或推荐属性的商品列表 Excel 文件,填写后重新上传——或者选择多个商品列表,使用“添加商品属性”。