JSON-LD：用于富结果和理解的结构化数据

JSON-LD（用于链接数据的 JavaScript 对象表示法）是一种标记你的内容的方式，以便搜索引擎更好地理解它。

Google Search 支持 JSON-LD、Microdata 与 RDFa；如果网站条件允许，通常推荐 JSON-LD。它与可见 HTML 分开，便于模板维护，但也更容易发生“页面写一套、Schema 写另一套”的不一致。

JSON-LD 做什么

• 描述内容: 告诉搜索引擎你的内容代表什么（文章、产品、FAQ 等）
• 获得展示资格: 受支持且符合政策的标记可以让页面获得相应富结果资格，但不保证一定展示
• 澄清歧义: 帮助搜索引擎理解实体和关系

JSON-LD 存在于你的页面头部（或正文）中的 <script type="application/ld+json"> 块中。

从页面用途选择类型

• 文章: 用于博客文章和新闻内容
• 产品: 用于带有价格和可用性的电商产品
• QAPage: 用于用户可以围绕一个问题提交答案的页面，不是普通 FAQ 页的替代品
• 组织: 用于公司信息和品牌
• LocalBusiness: 用于带有地址和营业时间的本地企业
• BreadcrumbList: 用于面包屑导航

你不需要使用每个类型。选择与你的内容匹配的类型。

先判断页面最主要、用户可见的用途。产品详情页可以使用 Product；编辑评测必须展示与 Review 属性一致的真实证据；分类页不能把多个商品卡片拼成一个虚构商品。还要同时检查 Google 当前支持的搜索功能：Schema.org 类型合法，不代表 Google 一定提供对应富结果。

建立稳定的实体图谱

一个页面可以有多个 JSON-LD 块，但相关实体最好使用稳定的 @id 连接，避免同一作者或组织在不同模板里变成多个略有差异的对象。文章页面通常需要连接：

• Article 与 canonical URL
• author 与 Person 作者页
• publisher 与统一的 Organization
• isPartOf 与网站实体
• BreadcrumbList 与页面可见面包屑

身份字段应使用绝对 URL，并在全站模板中保持一致。不要编造用户无法在页面上核实的评分、价格、日期、资质或实体关系。

发布前 QA 顺序

1. 逐个解析 JSON-LD 块，先排除 JSON 语法错误。
2. 确认类型与页面主要可见内容一致。
3. 对照当前 Google 功能文档检查必填和建议属性。
4. 核对 canonical、@id、日期、币种、库存和图片 URL。
5. 使用 Rich Results Test检查 Google 功能，再用 Schema.org validator 检查词汇层问题。
6. 检查真实部署 URL；模板、hydration、缓存或边缘重写都可能让线上输出与本地不同。

测试结构化数据

使用 Google 的 富结果测试 或我们的 Schema 标记工具 来验证 JSON-LD，并以 Google 的结构化数据政策作为搜索资格依据。

要避免的常见错误：

• 标记用户不可见的内容
• 误导性或不准确的标记
• 过度使用 schema 只是为了希望获得富结果

使用结构化数据来澄清，而不是欺骗。

测试通过并不代表 QA 结束。模板发布后应持续观察 Search Console enhancement 报告。如果大量 URL 的 valid items 同时下降，应先检查共享模板、部署产物、canonical 与数据源，而不是逐页盲目修改。

链接回术语表

快速定义：JSON-LD。

相关术语

• Schema 标记
• 富摘要
• 元标签