Skip to main content

商品数据格式

ACP的商品数据模型分为两层:Product(商品)和 Variant(变体)。每个Product必须包含至少一个Variant。

2.1 Feed Header(数据源头标识)

每个数据文件或API调用必须包含Feed Header,标识数据来源:

2.2 Product对象

ID稳定性: 商品ID在整个生命周期内必须保持不变。更换ID会导致ChatGPT丢失该商品的历史数据和推荐记录。

2.3 Variant对象(变体)

每个Variant代表商品的一个具体规格(如颜色/尺码组合):

2.4 Price对象

所有价格使用ISO 4217最小货币单位(分/cents):
注意: $79.99 在ACP中表示为 7999,¥399 表示为 39900。日元等无小数货币直接使用面值。

2.5 Description对象

至少提供一种格式。推荐使用 plain

2.6 Availability对象

商品下架: 设置 is_eligible_search=false 或在下次全量快照中省略该商品。

2.7 Media对象

第一张图片是主图: 在media数组中,第一个 type: "image" 的条目会作为ChatGPT展示的主图。

2.8 Category对象

支持的分类体系:
  • merchant: 商家自定义分类
  • google_product_category: Google商品分类标准
  • shopify: Shopify分类标准

2.9 VariantOption对象

用于描述变体的用户可见规格:
常见选项:颜色、尺码、材质、容量等。

2.10 Seller对象(适用于平台型商家)

Link对象的 type 枚举:privacy_policy / terms_of_service / refund_policy / shipping_policy / faq 使用持久性公共URL: 卖家链接必须是稳定的、长期有效的公共URL。

2.11 Barcode对象

2.12 完整Product示例


下一章: 文件上传集成 — SFTP推送规格、文件格式要求、分片策略