> ## Documentation Index
> Fetch the complete documentation index at: https://learn.orbexa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ACP商品数据质量标准与治理

> ACP商品数据质量标准与治理最佳实践完整指南，涵盖商品ID与变体ID长期稳定性要求、URL编码规范与utm追踪参数校验、成人内容等禁止商品类别政策、图片分辨率与背景质量标准、variant_options规格设置，以及库存价格数据新鲜度监控和提交前质量检查清单

# 数据质量最佳实践

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

## 6.1 ID稳定性

商品ID和变体ID必须在整个生命周期内保持稳定不变。

```
正确: prod_earbuds_001 → 始终使用这个ID
错误: 每次上传生成新ID → 丢失历史数据和推荐记录
```

**为什么重要**:

* ChatGPT根据ID追踪商品的购买历史和用户偏好
* 更换ID等同于创建一个全新商品，之前的数据全部丢失
* 影响商品在AI推荐中的排序和出现频率

## 6.2 描述格式

至少提供一种描述格式。推荐使用纯文本（plain text）格式：

```json theme={null}
{
  "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` 标注面向用户的规格维度：

```json theme={null}
{
  "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可公开访问 |
| 一致性   | 同一商品的图片风格保持一致     |
| 无文字覆盖 | 避免在商品图片上添加促销文字    |

```json theme={null}
{
  "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章：测试与验证](/zh/book-4/ch7-testing) — 小批量测试、格式校验、常见错误排查