WooCommerce 商品结构化数据：官方建议什么

这一篇先把"官方建议"四个字落到具体来源上。WordPress 官方文档不规定商店插件输出什么结构化数据——它只说明插件如何通过钩子与 WordPress 交互；定义了字段、必填项和违规后果的，是 Google 的官方文档。所以本文字段要求全部引自 Google。

先把"官方"这两个字说清楚

按WordPress 插件开发手册对钩子机制的说明，钩子是一个插件与 WordPress 交互的方式。商品标记既可能来自商店组件本身，也可能来自主题或另一个 SEO 类插件——页面上有什么，取决于哪些代码被注册进来。版本差异同样存在：不同版本与配置下输出行为会变，官方没有公布可长期引用的对照表。先在商品页源码里看清现在输出了什么，再逐条比。

两类商品标记，先选对再谈字段

Google 对商品结构化数据的总览把商品标记分成两套：商品摘要用于读者不能直接下单的页面，比如评测文章，评价类字段选项更多；商家商品列表用于读者可以直接购买的页面，尺码、运费、退换货这类履约信息选项更多。官方说明两者有重叠——写全商家列表要求的商品信息，页面通常也具备商品摘要的资格——所以判断依据只有一条：这个页面上能不能直接买东西。

同一篇里还有两条对商店站点实用的口径。一是变体：标记可以帮助 Google 分清哪些是同一父商品的变体，两类标记都支持变体。二是除了页面标记，还可同时向 Google 提交商品数据源（Merchant Center 数据馈送），官方说两者同时提供能让你有资格进入更多购物呈现；有些呈现会混合使用两边的数据，比如页面标记没有价格时从数据馈送里取。

必填三项，加上价格的两条硬规则

按Google 商家商品列表指南里的必填字段，Product 上只有三项必填：name、image（官方偏好能清楚展示商品本身的图）、以及 offers。注意一处差异：商品摘要可接受 Offer 或 AggregateOffer，商家商品列表要求 Offer，因为商家必须是这个商品的卖方。

价格有两条容易踩的规则。第一，商家商品列表要求价格大于零；第二，price 与 priceSpecification.price 同时给当前价时，Google 采用 offers.price 并忽略后者。币种用三字母 ISO 4217 格式，price 与 priceCurrency 成对出现。常用推荐项是 availability、itemCondition、sku、brand.name、gtin 系列编码、description、aggregateRating 与 review、priceValidUntil（填过去日期可能导致列表不展示）。

怎么做：在商店侧逐项核对这七件事

1. 确认这页能不能直接下单。能，才走商家商品列表；只是介绍商品的页面按商品摘要走。
2. 确认页面聚焦单一商品。官方说商品类结果只支持聚焦单一商品（或同一商品多个变体）的页面，"我们店里的鞋"这种列表页不在范围内，标记应加在商品页而不是列表页上。
3. 价格与库存要和页面上显示的一致。按 结构化数据总则里关于可见内容与放置位置的要求，标记必须真实反映页面内容；页显示一个价、标记写另一个价，属于总则里"标记不准确"那一类。
4. 多币种要用不同 URL。以多种货币销售时，每种货币一个独立地址。
5. 变体各管各的。带独立 URL 的变体各自成页、标记跟着各自 URL 走，父子关系交给变体标记处理。
6. 优先把标记放进初始 HTML。官方提醒用 JavaScript 生成商品标记会让购物抓取更少、更不可靠，对价格和库存这类变化快的内容影响更直接。
7. 退换货政策写在店铺层。官方建议把全局退换货政策放在 Organization 标记下，只在个别商品有特殊政策时才用 Offer 里的 hasMerchantReturnPolicy 覆盖。

哪些页面不要加商品标记

• 分类页、标签页、站内搜索结果页。它们是列表不是商品，官方建议把标记集中到商品页。分类页怎么处理，可看站内 电商分类页怎么拿外链。
• 购物车、结账、账户页。与单个商品无关，必填项凑不齐，硬加只会制造无效项。
• 只放了"去看看别家有售"的页面。官方写明：只有顾客能在你这页直接购买的页面才有商家商品列表资格，链到其他站点售卖不算。
• 不允许售卖的品类页面。商家商品列出的内容要求明确不允许推广受广泛禁止或受监管的商品与服务信息，包括枪支与武器、娱乐性药物、烟草与电子烟、赌博相关产品。
• 页面上只露出一部分评价时。标记只写一部分评价属于总则说的误导性标记。页面上怎么显示评价，可看站内 WooCommerce 的产品详情不显示评价。

怎么核对：工具与抓取数据两条线

先跑富媒体结果测试工具清掉关键错误，再用一个真实商品 URL 走 URL 检查工具，确认可抓取、无 noindex、无登录限制，然后请求重新抓取。官方提醒上新页面可能要几天才被抓到，价格与库存类数据还要等重新处理才反映。

然后看 Search Console 里商品相关的状态报告。官方解读口径是：理想状态是有效项上升、无效项不上升。商家商品列表的报告和商品摘要的报告是分开的，要先确定页面属于哪一类，否则数字会互相打架。改模板或改配置后监控无效项是否突然增加，增加了通常意味着新的输出方式与原有输出互相影响。

边界是：商品标记不保证一定出现在结果里。总则列出的原因包括标记与主要内容不符、细节不准确、内容对用户不可见，以及页面不符合该功能指南。