illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 Google Search Central 官方文档（developers.google.com/search/docs/appearance/structured-data）+ Schema.org 词汇表 + Search Gallery 编写，对照 2026-07 Search Central 最新规则

速查 ​

  • 三格式：JSON-LD（Recommended）/ Microdata（legacy）/ RDFa（仍维护）
  • JSON-LD 载体：<script type="application/ld+json">，三件套 @context=https://schema.org / @type / @id
  • 核心类型：Organization / BreadcrumbList / Article / Product / Offer / FAQPage / HowTo / Event / LocalBusiness / VideoObject
  • 校验：Rich Results Test（输 URL 非 code）
  • 功能目录：Search Gallery
  • 重大变更：2020 data-vocabulary.org sunset；2023-08 FAQ 限缩；2023-09-13 HowTo 完全弃用
  • 质量红线：markup 必须如实描述可见内容，违反 manual action（不影响常规排名）
  • 不保证原则：markup 正确 ≠ 一定显示富结果
  • 完整说明见 入门 / 核心指南

三种格式对比表 ​

维度JSON-LDMicrodataRDFa
载体<script type="application/ld+json">HTML 标签属性内联HTML 标签属性内联
位置<head> 或 <body>多在 <body><head> 或 <body>
类型标识@typeitemtypetypeof
属性标识@context 内的字段名itempropproperty
作用域JSON 自然嵌套itemscopevocab
实体标识@iditemidresource / about
词汇表@context="https://schema.org"itemtype="https://schema.org/X"vocab="https://schema.org/"
Google 推荐度Recommended（唯一）支持（legacy）支持
W3C 状态JSON-LD 1.1 推荐Note（停止演进）RDFa 1.1 推荐
JS 动态注入友好麻烦麻烦
嵌套表达JSON 树形，清晰HTML 嵌套，深层复杂HTML 嵌套，深层复杂
规模化维护出错少易漏字段易漏字段

新实现一律选 JSON-LD。判别格式：@context/@type 是 JSON-LD；itemscope/itemprop 是 Microdata；vocab/typeof/property 是 RDFa。

Schema.org 类型速查 ​

类型用途必需属性（Google）推荐属性
Organization站点背后的组织name、urllogo、sameAs、contactPoint
BreadcrumbList面包屑层级itemListElement（≥2 ListItem，每项 item/name/position）—
Article文章（含 NewsArticle / BlogPosting）无headline、image、datePublished、dateModified、author[]、publisher
Product商品nameimage、offers、aggregateRating、review、brand
Offer商品价格（嵌套于 Product.offers）price、priceCurrency、availabilityshippingDetails、hasMerchantReturnPolicy
FAQPageFAQ 页（2023-08 起限缩）mainEntity（Question 数组）—
HowTo教程（2023-09-13 完全弃用）step（HowToStep 数组）totalTime、supply、tool
Event线下 / 线上活动name、startDate、locationendDate、eventStatus、offers、organizer
LocalBusiness实体店 / 餐厅name、address（PostalAddress）telephone、openingHoursSpecification、geo、aggregateRating
VideoObject视频name、uploadDatedescription、thumbnailUrl、contentUrl、duration
Recipe食谱name、recipeIngredient、recipeInstructionscookTime、nutrition、aggregateRating
Review单条评论itemReviewed、author、reviewRatingdatePublished、reviewBody
AggregateRating聚合评分ratingValue、reviewCount 或 ratingCountbestRating、worstRating
JobPosting招聘信息title、datePosted、description、hiringOrganization、jobLocationemploymentType、salaryCurrency
SoftwareApp软件应用name、operatingSystemapplicationCategory、aggregateRating、offers

每类先查 Search Gallery 该类型的 feature guide 确认最新规则——schema.org 是词汇全集，Google 只支持其子集且各 feature 有自己的「必需 / 推荐」要求。

Article 推荐图像规格 ​

比例用途
16x9横屏主图（最常用）
4x3中屏
1x1方形缩略
  • 最小像素：≥ 50K 像素（单张）
  • 格式：JPG / PNG / WebP / GIF
  • URL 必须 crawlable：不被 robots.txt / noindex / 登录墙阻挡

@graph 多实体完整示例 ​

json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://example.com/#org",
      "name": "IllegalCreed",
      "url": "https://example.com",
      "logo": {
        "@type": "ImageObject",
        "url": "https://example.com/logo.png"
      },
      "sameAs": [
        "https://github.com/IllegalCreed",
        "https://twitter.com/IllegalCreed"
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "https://example.com",
      "name": "IllegalCreed",
      "publisher": { "@id": "https://example.com/#org" }
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://example.com/seo/structured-data/#breadcrumb",
      "itemListElement": [
        { "@type": "ListItem", "position": 1, "name": "SEO", "item": "https://example.com/seo/" },
        { "@type": "ListItem", "position": 2, "name": "结构化数据" }
      ]
    },
    {
      "@type": "Article",
      "@id": "https://example.com/seo/structured-data/#article",
      "headline": "结构化数据深度指南",
      "image": "https://example.com/img/structured-data.jpg",
      "datePublished": "2026-07-22T08:00:00+08:00",
      "dateModified": "2026-07-22T10:00:00+08:00",
      "author": [
        { "@type": "Person", "name": "张三", "url": "https://example.com/author/zhangsan" }
      ],
      "publisher": { "@id": "https://example.com/#org" },
      "isPartOf": { "@id": "https://example.com/#website" },
      "breadcrumb": { "@id": "https://example.com/seo/structured-data/#breadcrumb" }
    }
  ]
}

@graph 让多个实体在单个 <script> 内通过 @id 互相引用，Google 能正确建立 Organization → WebSite → Article → BreadcrumbList 的关联。

同页多 item 处理 ​

方式适用示例
Nesting主 item 与子 item 强归属Recipe 嵌套 aggregateRating / video
Individual items + @id多个独立 item 互相引用Recipe 与其 VideoObject 用 @id 串联

不用 @id 串联，Google 不知道 video 属于该 Recipe，可能漏掉 video rich result。

校验与监控工具 ​

工具用途
Rich Results Test输 URL 校验页面可生成哪些 rich result（输 code 会因 JS/CORS 误报）
URL Inspection看渲染后 HTML 是否含 JSON-LD
Search Console Performance对比有 / 无结构化数据页面的点击 / 曝光
Rich result status report每类 rich result 的覆盖率与错误
Manual Actions report是否因 spammy markup 被处罚

重大历史变更 ​

时间事件
2020data-vocabulary.org 被 Google sunset，不再产生任何 rich result（须迁移到 schema.org）
2023-08-09FAQPage rich result 限缩为权威政府 / 健康站
2023-09-13HowTo rich result 完全弃用，Search Console API 支持 180 天后下线
持续Search Gallery 随 Google 更新：近年新增 Practice problems / Profile page / Discussion forum，移除 HowTo / FAQ

FAQPage / HowTo 的 markup 本身不会报错，普通站写了也基本不显示富结果——属无效投入。

SEO 价值实证数据 ​

站点提升来源
Rotten TomatoesCTR +25%Google 官方案例
Food Network访问 +35%Google 官方案例
NestléCTR +82%Google 官方案例
Rakuten用户停留 1.5xGoogle 官方案例

结构化数据对 CTR / 富媒体展示的量化影响，是 Google 在官方文档与案例集中反复引用的卖点。

边界（与邻叶划分） ​

主题归属说明
结构化数据（本叶）SEO 组 sort 3Schema.org 词汇 + JSON-LD/Microdata/RDFa 三种格式 + 各类 rich result 类型 + Google Rich Results Test
技术 SEOSEO 组 sort 1抓取 / 索引 / robots.txt / sitemap / canonical 机制
页面 SEOSEO 组 sort 2title / meta description / H 标签 / 内容本身
GEOSEO 组 sort 4面向生成式 AI / LLM 的检索优化
Core Web Vitals性能优化章性能机制归性能优化，本叶只讲 SEO 影响
SSR / SSG框架章实现归框架，本叶只讲对爬虫 / 渲染的意义
Open Graph / Twitter Card页面 SEO / 社交 meta不属 schema.org rich result 范畴

版本状态 ​

  • JSON-LD：W3C JSON-LD 1.1 推荐（当前主流），Google 官方在三格式中唯一标记 Recommended
  • Microdata：W3C Note（已基本停止演进、被视作 legacy）
  • RDFa 1.1：W3C 推荐（仍维护）
  • Schema.org：由 Google / Microsoft / Yahoo / Yandex 社区持续维护演进

结论：新实现一律 JSON-LD + schema.org，遵循当前 Search Central 文档而非 schema.org 通用定义。

官方资源 ​