商品标识符和变体#
店铺前台渲染目标必须与商家商品目录标识同一商品。大多数集成问题都源于这两个值不匹配。
选择稳定的标识符#
使用为已准备商品显示的 productCode。在 Shopify 教程中，这是变体 SKU。Product Import API 的请求字段定义在 导入参考 中；请勿用店铺前台属性名替换这些字段名。
保持标识符完全一致，包括大小写。不要从可变的显示名称生成标识符，也不要假设平台内部商品 ID 等于一个 SKU。
映射所选变体#
| 店铺前台状态 | 渲染目标行为 |
|---|---|
| 已选择已准备的变体 | 设置其精确的 productCode |
| 选择发生变化 | 更新渲染目标，并按照您的集成指南清除过时的 SDK 状态 |
| 不存在 SKU 或匹配商品 | 保持已编写的按钮隐藏或禁用 |
| 商品卡片指向默认变体 | 始终使用该变体的标识符 |
对于 Shopify，将教程中的同步辅助函数连接到您主题的变体变更回调。对于其他店铺前台，请遵循 动态页面。
验证映射#
选择两个视觉上明显不同的商品变体。记录其目录代码，在浏览器开发者工具中检查每个渲染的 data-product-code，然后分别为其打开 Viewer。在不刷新整页的情况下导航后重复此操作。
当源系统中的标识符发生变化时，请协调商品目录导入和店铺前台发布。成功的 HTTP 导入响应仅代表已接受；在依赖新代码前，请检查 任务状态 和商品失败详情。