AggregateRating 是谷歌唯一稳定支持的评分结构化数据类型，专为多用户评分汇总设计；直接使用 Rating 无效，必须嵌套在 Product 等支持类型内，且必需 ratingValue、reviewCount、bestRating 三字段，推荐用 JSON-LD 实现。
什么是 AggregateRating 而不是 Rating
直接用 Rating 会失效——Google 不识别这个类型。必须用 AggregateRating，它专为“多个用户打分后汇总的星级”设计，是当前搜索引擎唯一稳定支持评分结构化数据的方式。
常见错误现象：Rating 在 Google Rich Results Test 中显示“未检测到有效评分”，或星级不出现。
-
AggregateRating必须嵌套在某个主体（如Product、LocalBusiness或WebPage）内，不能单独存在 - 必需字段只有三个：
ratingValue、reviewCount、bestRating（默认是 5，但显式写上更稳妥） -
ratingValue必须是数字（如4.2），不能是字符串"4.2"，否则 JSON-LD 解析失败
用 JSON-LD 写比 Microdata 更可靠
Microdata 容易因 HTML 结构变动（比如标签换行、注释、动态插入）导致解析中断；JSON-LD 是独立 script 块，位置自由、容错强，Google 官方推荐。
示例（放在 <head> 或页面末尾 <body> 内）：
立即学习“前端免费学习笔记（深入）”；
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "无线降噪耳机",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.6,
"reviewCount": 128,
"bestRating": 5
}
}
</script>
- 注意：外层
@type必须是支持aggregateRating的类型（Product、LocalBusiness、Movie等），WebSite或Article不支持 -
reviewCount必须是整数，不能是"128"或128.0 - 如果页面同时有多个商品，每个都要独立的 JSON-LD 块，不能合并
为什么 sameAs 和 author 会影响星级显示
Google 并不校验这些字段，但缺失关键上下文时，可能拒绝展示富媒体结果——尤其是当 AggregateRating 所属实体缺少名称、URL 或可识别身份时。
- 给外层主体加
url（必须是当前页面完整 URL，含https://） - 如果是本地商家，
sameAs指向 Google Business 页面能增强可信度 - 如果是评测类文章，外层用
Article+mainEntity指向Product，比直接用Product更符合语义 - 不要在
AggregateRating内部加author—— 它不属于该类型，会被忽略
测试时最常被忽略的三件事
跑完 Google Rich Results Test 显示“有效”，不代表星级一定出现在搜索结果里。真实生效还卡在这几个点：
- 页面必须已被 Google 爬取并索引（新页面等 1–3 天再测）
-
ratingValue必须在 0.5–5.0 范围内，且小数位最多一位（4.66会失败） - 同一域名下，Google 通常只对高频访问、高信任度页面展示星级；低流量页面即使标记正确，也可能长期不显示
如果改完代码一周后仍无星级，优先检查是否用了 Product 类型但页面实际是博客评测——这时该用 Article 包裹 mainEntity，而不是硬套 Product。
