Shopify 评价墙页面配方
评价页的顾客任务是：在决定是否信任这家店之前，一次看到来自不同来源的口碑证据，并能自己点过去核对。访客通常从首页证据条、页脚或商品页的「查看全部」进入，已经知道品牌，尚未确定信任；这是店铺层面的判断，不是某件商品的选购。它属于 Shopify page template type，默认 page.json 可以成立，来源稳定、分区固定时才值得 page.reviews.json。
独立评价页还是商品页评价区
| 情形 | 更合适的承载 |
|---|---|
| 顾客在判断某件商品是否合适 | 商品页评价区，见评价展示与标准商品页 |
| 评价来源在店铺层面（第三方平台主页、店铺服务评价） | 独立评价页 |
| 同时有自有评价、第三方评价和授权的顾客内容，需要分开说清来源 | 独立评价页 |
| 只有自有商品评价，且数量不多 | 只放商品页，不单开评价页 |
| 没有任何可核对的评价来源 | 不建页 |
商品评价的汇总只能由该商品自己的评价计算，不同商品的评价不混用（评价展示）。所以评价页不制造「全店评分」：自有评价按商品分组，并链接回各商品页评价区；只有评价系统本身存在店铺级评价对象且口径写明时，才展示店铺级分数。这是本库的编辑口径。
评价结构化数据只在商品页语境处理。评价页不输出商品的 aggregateRating 标记，第三方平台的星级也不进入自有商品的标记，依据与限制见评价展示「评分结构化数据」。
页面内容清单
来自内容类型的部分
| 优先级 | 页面内容 | 回答的问题 | 来源边界 |
|---|---|---|---|
| 核心 | 自有评价 | 买过的人怎么说 | 顾客评价：评价对象、来源、验证标准、审核与激励规则 |
| 可选 | 第三方平台评价 | 独立平台上的评分怎样 | 第三方评价平台：平台名、评分体系、评价总数、快照日期、主页链接 |
| 可选 | 用户生成内容 | 真实顾客拿到商品后的样子 | 用户生成内容：原帖链接、授权范围、利益关系披露 |
| 可选 | 精选顾客证言 | 有哪些具体个案 | 顾客证言：逐条授权，不冒充整体 |
| 可选 | 评价规则说明 | 评价怎样收集、「已验证」指什么 | 引用评价系统规则，回答见FAQ 子集 |
| 可选 | 数字摘要 | 评分与评价总数是多少 | 数据证明：口径、窗口与来源 |
页面专属或运行时的部分
| 优先级 | 页面内容 | 回答的问题 | 来源边界 |
|---|---|---|---|
| 核心 | 来源说明 | 这一页各区的数据从哪来、为何不合并 | 页面专属正文 |
| 核心 | 评分与评价总数 | 当前值是多少 | 运行时数据，由评价系统按已发布评价计算，不手写 |
| 可选 | 联系与申诉入口 | 评价有异议或想补充找谁 | Support & Contact |
页面组合
以下顺序是待验证假设。它先说明来源，再由证据条给出概览，然后各区分别展开。
| 顺序 | 模块 | 回答的问题 | 缺失时 |
|---|---|---|---|
| 1 | 来源说明（页面专属） | 各区为什么不能合并成一个分数 | 保留一句话，不删 |
| 2 | 证据条 × List 或 Grid | 各来源概览与入口 | 零项整条不渲染；一项写成一句带口径的文字 |
| 3 | 自有评价 × 评价展示 | 按商品分组的评价与汇总 | 零评价写「暂无评价」并保留入口；不借用其他来源 |
| 4 | 第三方平台评价 × List | 各平台的评分、总数与日期 | 无平台主页或评价不足时删除，不用自有评价冒充 |
| 5 | 用户生成内容 × Masonry 或 Grid | 真实顾客的图片与视频 | 没有获得授权的内容就删除，不用模特图代替 |
| 6 | 评价规则 FAQ 子集 | 怎样收集、审核与是否有激励 | 规则未定则不写，不用泛称 |
| 7 | 联系入口 | 有异议怎么办 | 保留一个真实入口 |
最小成立组合是：来源说明 → 一个来源清楚的评价区 → 联系入口。证据条只在已有两个以上来源时才有意义。
默认不出现：自动轮播只放高分评价、没有来源的「98% 满意」、没有链接回平台主页的评分截图、把不同商品评价平均成一个分数、订阅弹窗遮挡评价。证据条里已经展示的评分，下方区块可以展开，但不再另放一个来源不同的分数。
内容 × 展现形式
| 内容 | 首选形式 | 适用条件 | 退化方式 |
|---|---|---|---|
| 评分与总数 | List：「平均分 / 量表，共 N 条」 | 取自同一时点的运行时数据 | 隐藏，不显示缓存分数 |
| 自有评价列表 | 单列 List，分页 | 逐条可读、筛选口径可见 | 少量评价只列出实际条目，不画分布图 |
| 第三方评价 | List，分平台一行 | 每行有平台名、总数、快照日期与主页链接 | 文字一句，或撤下 |
| 用户生成内容 | Masonry 或 Grid | 每条可回到原帖并已授权 | 单条放在文字旁并写明来源 |
| 证言 | 引言卡片 | 每条有授权与背景 | 删除 |
| 评价规则 | 静态问答或 Accordion | 有真实规则 | 删除 |
状态与退化
- 零项：没有任何可核对的评价来源，页面不发布，也不用「口碑之选」类占位语。
- 一个来源：直接写明来源、评分、总数与日期，不做「多来源」布局。
- 多来源：各区分别标注来源，每个数字保留自己的平台名和评价总数，不合并、不平均。
- 某一来源失效：只撤下该区，其余照常，不保留无法核对的截图或旧数字；这与证据条「各项独立失效」一致。
- 评价系统加载中或失败：加载中用与最终布局同高的占位；失败时隐藏评分与列表，不显示旧缓存。
- 旧评价：显示日期；商品改版后旧评价可能不再适用，按版本区分或标注。
- 跨市场与语言：评价是否随市场与语言变化未核验；不同市场展示不同集合时，汇总与列表必须取同一集合。评价保留原语言，翻译须标明。
- 无 JavaScript：评论列表与来源链接应能读到；第三方小组件不可用时退化为带链接的文字。
Shopify Theme 实现
| 层次 | 建议职责 |
|---|---|
| 资源 | Page 保存来源说明与评价规则；评价数据本身保存在评价系统或平台，不复制进 Page 正文 |
| Template | 默认 page.json；分区固定后再建立 page.reviews.json。alternate 命名为 template-name.template-suffix.json，可在后台分配、在主题编辑器预览 |
| Sections | 来源说明、证据条、自有评价、第三方评价、用户内容、规则 FAQ、联系分开为可排序 section |
| Blocks | 单个平台、单条精选评价、单个授权内容 |
| Settings | 内容选择与布局；不提供隐藏低分评价或修改评分的开关 |
官方 JSON 模板页写明每个模板最多 25 个 section、每个 section 最多 50 个 block；官方页没有规定 section 必须叫 main。
评价数据能否在 Page 中展示（官方页所读，核验于 2026-09-29）：
- 标准评价 metaobject 是面向经批准评价应用的受限定义；商品上的
reviews.rating（平均分）与reviews.rating_count（评价总数）是商品级 metafield，在 Shopify 后台不可见、商家不可编辑，只能通过 GraphQL Admin API 访问与校验。 - Liquid 的 rating 对象页以
product.metafields.namespace.fieldname.rating为读取示例，说明评分读取以商品对象为起点。 - Page 对象页列出的属性包括标题、正文、句柄、
metafields与template_suffix，没有商品数据；all_products可按 handle 取商品，官方写明每页最多 20 个唯一 handle，超出时建议改用集合，该页没有讲它能否读取 metafield。 - 评价 metaobject 条目能否在店面的 Liquid 中读取，标准评价页没有明确说明。
据此，评价页里的商品级评分能否直接读取，所读官方页面没有给出确认路径，属于未核验：需要在目标主题与所用评价应用里实测，并以其文档为准。第三方评价小组件通常通过主题编辑器的 App blocks（仅兼容主题可用，且可能只在部分页面类型可用）或 App embeds（任何主题版本可用）加入，见Extend your theme with apps。本文不推荐具体应用，也未核验任何应用能否在 Page 模板中渲染。固定主题版本中的评价相关实现见 Horizon 徽章、评价与订阅。
发布检查
- 自有评价、第三方评价与用户内容三类来源被清楚分区，没有混算或混称「顾客评分」；
- 每个第三方分数带平台名、评价总数、快照日期并链接回平台主页；
- 用户生成内容有原帖链接与授权记录，存在赠品或合作时已在内容旁披露；
- 自有评价的汇总、分布与列表条数一致，被撤回的评价同步消失；
- 评价页没有输出商品
aggregateRating，第三方星级没有进入自有商品的标记； - 每个数字都能在权威条目中找到同一个值和同一个统计时点；
- 键盘与读屏下星级有文字等价，无 JavaScript 时列表仍可读；
- 评价邀请方式一致且公平，没有为评价提供激励却不披露。
待继续完善
- 商品级评分与评价列表在 Page 模板中的实际读取方式未核验；
- 第三方小组件的可访问性、性能与在 Page 中的可用性未测；
- 缺少一份标注为虚构的评价页线框与逐状态样稿；
- 各地区对评价展示、激励披露与差评处理的法规未核对，需要法务或合规确认。