BLOG / productgroup-variant-sku-gtin.mdx
ProductGroup、Variant、SKU 与 GTIN:商品身份的安全失败指南
不猜测缺失身份,正确建模商品家族、选项组合、市场与语言文档、稳定 URL、SKU 和 GTIN。
商品身份应该不断缩小选择范围,不能制造不存在的确定性。v0.10 要求每个 Variant 必须包含非空的商家 sku。现实商品没有商家 SKU 时,目前无法生成符合 sku.md/0.10-draft 的 Product Document;稳定来源 ID 仍有用途,但不能替代 sku。GTIN 与 MPN 可以缺失。
SKU.md 是由商家托管的商品发现与稳定商品知识:agent 可以找到商品、理解有来源的事实,并知道去哪里复查实时商业状态;它不是新的结账协议。
四类身份回答不同问题
| 概念 | 回答什么 | 可以缺失吗 |
|---|---|---|
| ProductGroup | 属于哪个相关商品家族 | 没有家族模型时可以 |
| Variant | 哪个精确选项组合可购买 | 声称可选商品时不应缺失 |
| SKU | 商家分配的库存引用是什么 | 不可以,v0.10 要求每个 Variant 都有 |
| GTIN | 注册的全球贸易项目是什么 | 可以 |
Schema.org Product 支持 sku、gtin、isVariantOf 等属性,但词汇存在不代表商家一定填过或治理过这些值。SKU.md 应保留已知身份,不能从标题或 URL 片段猜测。GTIN 和 MPN 可以缺失,但商家 sku 是 v0.10 的合规要求。
Variant 必须覆盖完整选项组合
如果一件蓝色夹克还有 S、M、L,“蓝色夹克”就不够精确。Variant 应包含其来源系统用于区分可购买项目的完整选项。两个候选即使标题相同,只要版型、市场、包装数量或材料不同,消费者就不能靠相似度替用户选择。
- 从稳定来源解析 Product 家族。
- 匹配所有必需选项名称和值。
- 比较稳定 Variant ID 与必需的商家 SKU;存在 GTIN 时再一并核对。
- 标识冲突或仍有多个候选时停止。
市场、语言与 URL 不是身份捷径
商家可能为同一 Variant 发布多语页面,也可能有市场专属 Variant,或拥有文案相似的不同商品。content_language 只说明文档语言,market 只限定商业上下文;两者都不能单独证明两个文档描述同一 Variant。
Canonical 与 parent URL 应跨修订保持稳定。把退役商品跳转到分类页可以帮助人类,但不能把旧文档事实悄悄贴到新商品上;有明确替代或停产知识时,应单独表达。
缺失或冲突时安全失败
| 情况 | 安全结果 |
|---|---|
| GTIN 缺失 | 其他身份精确时,不带 GTIN 继续 |
| 商家 SKU 缺失 | 不发明 SKU;商家完成分配与治理前,不能生成合规的 v0.10 Product Document |
| SKU 相同但 Variant ID 冲突 | 停止并报告不一致 |
| 两个 Variant 匹配部分选项 | 询问缺失选项 |
| 市场页改变了可购买项目 | 重新进行独立映射判断 |
稳定来源 ID 仍可用于匹配和补救,但不能替代 sku。遇到歧义就停止,可以避免把一段写得很好的 Fact、Claim 或 Disclosure 套到错误商品上。
延伸阅读
阅读AI 商业权威交接理解精确匹配回环,再用商品事实与证据治理管理知识。