Shopify PDP 结构化数据上线前 QA 检查清单

Shopify 商品详情页不只是转化页面。它同时也是搜索引擎、Merchant Feed、富结果、站内搜索、推荐系统和数据分析会读取的结构化数据源。如果页面视觉上没问题，但结构化数据和真实页面状态不一致，搜索引擎拿到的信号就会变弱甚至出错。

这份清单适合在 Shopify 新主题发布、商品模板迁移、变体逻辑调整、评价导入或 SEO 清理前使用。目标不是把所有 schema 字段都塞进去，而是让 Product、Offer、Review、Breadcrumb 和 canonical 数据与真实店铺状态一致。

先确认结构化数据里到底应该代表哪一个商品。商品名称、品牌、handle、canonical URL、主图、SKU、GTIN 和变体关系，都应该指向客户和搜索引擎需要识别的那个正式商品页。

当商品有重复落地页、区域 URL、活动链接或旧商品记录时，这一步尤其重要。如果结构化数据指向一个身份，canonical 和内链又指向另一个身份，富结果和排名信号就可能被拆散。

• 检查 JSON-LD 的商品名称是否和页面 H1 或主商品标题一致。
• 确认 canonical URL 是首选 PDP 地址，而不是集合筛选页或活动 URL。
• 使用应该出现在搜索和社交预览中的主商品图。
• 让 SKU、GTIN、MPN 和品牌字段与 Shopify 商品数据及 Merchant Feed 保持一致。

很多 Shopify schema 问题来自变体。页面可能展示尺码、颜色、套装或订阅，但结构化数据只输出一个笼统的 Offer。简单商品这样处理可能没问题，但如果价格、库存、币种或 SKU 会随变体变化，就需要更谨慎。

上线前先决定变体策略。有些店铺只输出一个聚合 Offer，有些店铺会输出关键变体的多个 Offer。无论选择哪种方式，schema 都不能把无货变体标成有货，不能输出过期价格，也不能在不同市场里混用币种。

• 测试有货、低库存、售罄、预售和停产商品。
• 确认变体价格、划线价、币种、SKU 和库存状态与前台状态一致。
• 检查订阅、套装和批发价规则，避免 schema 暴露误导性的消费者价格。
• 避免在主题片段里写死 availability。

Review schema 只有在它对应真实、可见或可访问的客户评价时才有价值。导入评价、评价插件和迁移后的评价平台，都可能让商品页出现过期的评分汇总或缺少单条评价上下文。

上线前，把结构化数据里的 review count 和 rating value 与前台评价模块对照。如果评价由 app 注入，要确认 schema 出现在初始 HTML、app 输出里，还是根本没有出现。没有有效评价支撑的商品，不要输出 aggregate rating。

• 让 rating value、review count 和 best rating 与可见评价来源一致。
• 页面没有展示支撑评价时，移除 aggregate rating 标记。
• 主题调整后重新检查评价 app，因为 app block 移动时 schema 不一定一起移动。

Breadcrumb schema 应该描述客户能理解的页面路径，而不是把商品所属的所有集合都输出出来。Shopify 商品经常属于多个 collection，所以改版或商品分类迁移时很容易选错面包屑。

先确定首选商品层级，再从集合入口、搜索结果、推荐模块和直接访问 PDP 几个路径测试。结构化面包屑要足够稳定，能支持搜索上下文，同时也要和前台导航体验一致。

• 使用一个首选商品路径，不要输出所有 collection 归属。
• 除非活动集合就是长期路径，否则不要把临时活动或折扣集合写进面包屑。
• 检查面包屑 URL 是否返回 200，并且在需要收录时允许索引。

不要只验证主题 snippet 或本地测试数据。要测试来自 live preview 或 staging 域名的真实 URL，并覆盖不同模板、市场、语言和库存状态。结构化数据可能会受到 hydration、app 注入、本地化或市场定价规则影响。

工具可以组合使用：用 Rich Results Test 看富结果资格，用 Schema Markup Validator 看语法，用浏览器 view-source 看初始 HTML，再用渲染后的 DOM 检查 app 注入数据。按商品类型记录问题，避免最后变成笼统的 SEO 清理任务。

• 至少测试一个简单商品、一个多变体商品、一个售罄商品和一个带评价商品。
• 如果 app 或客户端组件会添加 schema，同时检查初始 HTML 和渲染后 DOM。
• 如果店铺使用 Shopify Markets 或多语言 app，必须验证本地化商品页。

结构化数据不应该孤立存在。把 PDP schema 与 Merchant Feed 字段、analytics 商品 ID、Search Console 增强报告和内部商品导出进行对照。差异通常说明 Shopify 数据、app 数据和前端模板已经发生漂移。

在投放广告、上线购物 Feed 或发布大版本主题前，这一步尤其重要。如果商品 Feed 显示一个价格，而 PDP schema 显示另一个价格，后续可能出现 Feed 被拒、富结果资格下降或报表混乱。

• 对照 PDP schema 和商品 Feed 中的商品 ID、SKU、标题、图片、价格、库存和 URL。
• 确认 analytics item ID 与 schema 使用的是同一套商品或变体身份。
• 上线后持续观察 Search Console 的商品摘要和 Merchant listing 报告。

商品 schema 很容易被小的主题改动破坏。开发者移动了价格模块，运营更换了评价 app，本地化规则改变了 URL，或者新商品模板绕过了 JSON-LD 片段，都可能让 PDP schema 失效。解决方法是建立一份轻量回归清单。

清单要短到团队愿意执行。把它放进主题发布、app 更新、商品模板修改、评价迁移和商品 Feed 工作的发布流程里。

• 为每一种主要商品状态保留一组代表性 PDP URL。
• 主题发布前跑一次 schema 校验，上线后再跑一次。
• 记录标题、价格、库存、评价、面包屑和 canonical URL 的数据源。