跳转到主要内容

​
数据质量最佳实践

商品数据质量直接影响在ChatGPT中的展示效果和转化率。本章汇总ACP对数据质量的要求和建议。

​
6.1 ID稳定性

商品ID和变体ID必须在整个生命周期内保持稳定不变。 
正确: prod_earbuds_001 → 始终使用这个ID
错误: 每次上传生成新ID → 丢失历史数据和推荐记录
为什么重要:
  • ChatGPT根据ID追踪商品的购买历史和用户偏好
  • 更换ID等同于创建一个全新商品，之前的数据全部丢失
  • 影响商品在AI推荐中的排序和出现频率

​
6.2 描述格式

至少提供一种描述格式。推荐使用纯文本（plain text）格式： 
{
  "description": {
    "format": "plain",
    "content": "Premium wireless earbuds with active noise cancellation, 30-hour battery life, and IPX5 water resistance."
  }
}
描述应该：
  • 准确反映商品的实际特性
  • 包含关键规格参数（尺寸、重量、材质等）
  • 避免营销夸张用语
  • 便于AI理解和检索

​
6.3 变体特定字段

以下字段应该在每个Variant上独立设置，而非仅在Product层面：
字段说明原因
title变体标题区分不同规格
url变体页面URL直达具体规格页面
description变体描述描述特定规格的差异
media变体图片展示对应颜色/款式的图片
availability库存状态不同规格可能库存不同
price价格不同规格可能价格不同

​
variant_options

使用 variant_options 标注面向用户的规格维度： 
{
  "variant_options": [
    { "name": "Color", "value": "Midnight Black" },
    { "name": "Size", "value": "256GB" }
  ]
}
这些维度会在ChatGPT的商品展示中作为可选项呈现给用户。

​
6.4 URL规范

​
添加追踪参数

在所有商品URL中添加 utm_medium=feed 参数，用于追踪来自ACP的流量： 
https://store.example.com/products/earbuds-pro?utm_medium=feed

​
使用持久公开URL

商家链接（seller URL）必须：
  • 使用持久的公开URL（durable public URLs）
  • 不包含会过期的session token或临时参数
  • 确保长期可访问
正确: https://store.example.com/products/earbuds-pro
错误: https://store.example.com/session/abc123/products/earbuds-pro

​
URL编码

所有URL必须合法且正确编码： 
正确: https://store.example.com/products/my%20earbuds
错误: https://store.example.com/products/my earbuds
空格使用 %20 编码，特殊字符按URL编码规范处理。

​
6.5 禁止内容

以下类别的商品不得通过ACP提交：
类别说明
成人内容色情或露骨的性内容
酒精/烟草/赌博酒精饮品、尼古丁产品、赌博服务
武器枪械、弹药、管制刀具
处方药品需医生处方的药物
未授权金融服务无牌照的金融或投资产品
违法商品任何违反当地法律的商品
欺骗性商品虚假宣传、仿冒品、误导性商品
提交禁止内容可能导致商家账户被暂停或终止。

​
6.6 数据新鲜度

保持库存和价格数据的时效性：
数据类型更新频率建议
库存状态实时或每小时
价格变化变化时立即更新
新品上架立即通过API推送
商品下架立即更新或在次日快照中移除
促销信息提前创建，到期自动过期
过时的库存和价格数据会导致用户体验差（如用户尝试购买已缺货的商品），并可能影响商家在平台上的展示权重。

​
6.7 图片质量指南

要求说明
清晰度高分辨率，商品细节清晰可见
背景纯白或纯色背景优先
角度主图展示商品正面，辅图展示多角度
格式JPEG或PNG，URL可公开访问
一致性同一商品的图片风格保持一致
无文字覆盖避免在商品图片上添加促销文字
{
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/products/earbuds-pro-front.jpg"
    },
    {
      "type": "image",
      "url": "https://cdn.example.com/products/earbuds-pro-side.jpg"
    }
  ]
}

​
6.8 质量检查清单

在提交商品数据前，逐项确认：
  • 所有ID稳定且唯一
  • 每个Product至少有一个Variant
  • 每个Variant有标题、价格、库存状态
  • 价格使用minor units（分，非元）
  • 至少提供一种描述格式
  • URL合法且正确编码
  • URL包含 utm_medium=feed 追踪参数
  • 图片URL可公开访问
  • 不包含禁止类别的商品
  • 变体特定字段已在Variant层独立设置
下一章: 第7章：测试与验证 — 小批量测试、格式校验、常见错误排查