HTML代码中Review与AggregateRating综合评价标记实战-html教程-PHP中文网

google不显示aggregaterating富媒体结果，主因是结构错误：aggregaterating须与review同属一个thing（如product），而非嵌套其中；ratingvalue、reviewcount需为纯数字且符合范围；必须同时提供至少一条含author、reviewbody、reviewrating的review实例。

html代码中review与aggregaterating综合评价标记实战

为什么Google不显示你的AggregateRating富媒体结果

大概率是 Review 和 AggregateRating 的嵌套结构或属性值不符合 Google 的 Structured Data Testing Tool（现为 Rich Results Test）校验要求。Google 要求 AggregateRating 必须作为 Review 的直接父级（或同级并存于同一 Item），且 ratingValue、reviewCount 必须为纯数字，不能带单位或空格。

reviewCount 值必须是整数（如 127，不是 "127" 或 127.0）
ratingValue 必须在 bestRating 定义的范围内（默认 5，若设 bestRating: 10，则 ratingValue: 8.5 合法，但 ratingValue: 9.2 可能被截断）
如果页面同时有多个 Review，AggregateRating 应放在最外层 itemscope 内，而非每个 Review 里重复声明

用JSON-LD还是Microdata？选错就白写

优先用 JSON-LD —— Google 明确推荐，解析更稳定，且不会干扰 HTML 渲染逻辑。Microdata 容易因 DOM 结构变动（比如模板引擎插入空 div）导致 itemprop 断链，而 JSON-LD 是独立 script 块，只要 script 标签没被删，数据就可靠。

JSON-LD 必须放在或开头/结尾，不能嵌在其他 script 中（如被 Vue/React 的 hydration 覆盖）
Microdata 若必须用，itemscope 容器必须包裹全部相关属性，且 itemprop="review" 的元素不能是 <script></script> 或 <meta>
不要混用：同一页面既写 JSON-LD 又写 Microdata 描述同一实体，Google 可能取其一或报冲突

AggregateRating + Review 共存时的正确嵌套方式

常见错误是把 AggregateRating 塞进某个具体 Review 里——它不属于某一条评价，而是整体统计。正确结构是让两者同属一个 Thing（如 Product 或 LocalBusiness），AggregateRating 通过 aggregateRating 属性挂载，Review 通过 review 属性挂载。

Gateway Monitor Installer

在 macOS 上通过 LaunchAgent 安装、更新、运行和移除 OpenClaw Gateway Monitor + Gateway Watchdog。适用于用户请求一键部署监控的场景。

下载

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "无线降噪耳机 Pro",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": 243,
    "bestRating": "5"
  },
  "review": [
    {
      "@type": "Review",
      "author": {"@type": "Person", "name": "张伟"},
      "datePublished": "2024-03-12",
      "reviewBody": "降噪效果超出预期，续航也扎实。",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5"
      }
    }
  ]
}

review 是数组，哪怕只有一条也要写成 [{...}]
reviewRating 是单条评价的星级，类型是 Rating，不是 AggregateRating
aggregateRating 字段名不能拼错（常见误写为 aggregatedRating 或 aggregate_rating）

本地测试时 Rich Results Test 总提示“Missing field 'review'”

不是真缺 review，而是你只写了 AggregateRating，没提供至少一条 Review 实例。Google 要求：要展示星级富媒体，必须同时提供聚合数据 + 至少一条真实评价（哪怕只是示意数据）。

即使页面实际不展示用户评论，JSON-LD 里也得硬塞一条最小化 Review（含 author、reviewBody、reviewRating）
reviewBody 不能为空字符串，也不能是占位符如 "用户评价内容"，建议用简短通用句，如 "多位用户反馈音质清晰、佩戴舒适。"
若用 CMS 动态生成，确保后端在无真实评论时 fallback 到一条静态 Review，而不是 omit 该字段