商品数据格式
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推送规格、文件格式要求、分片策略