支持的结构化数据属性和值

在商品着陆页上使用结构化数据标记,可以帮助 Google 直接从您的网站检索有关商品和优惠的最新信息。Merchant Center 支持的结构化数据标记都有相应的属性和可接受的值,具体请参见商品数据规范。结构化数据必须与相应的值和属性相匹配。

schema.org 目前只支持部分属性。

属性和 schema.org 注释

系统采用多种方式整理您提交到 Merchant Center 的商品数据,属性就是其中之一。每个属性包含与商品有关的一项信息,例如商品的名称或说明。将 schema.org 值与相应的商品数据规范属性准确匹配,有助于降低验证 Feed 时出错的几率。

注意:如果使用自动商品更新,请务必指定 schema.org 资源 pricepriceCurrencyavailability,以提高准确度。详细了解自动商品更新功能

商品数据属性 Schema.org 资源 类型和说明
以下属性来自 schema.org Product 类型
商品名 [title] name 文本
说明 [description] description 文本
图片链接 [image_link] image 有效的图片网址
商品组 ID [item_group_id] inProductGroupWithID

文本

父级 SKU,必须使用,才能将属于同一商品组的所有多款式商品组合在一起。

GTIN [gtin] gtin8gtin12gtin13gtin14isbn

文本

每个商品都有的独一无二的 GTIN 识别码。

您只能指定其中一个 schema.org 资源。

使用 GTIN 值时,请确保长度正确且包含正确的验证码。

材质 [material] material 文本
图案 [pattern] pattern 文本
MPN [mpn] mpn 文本
品牌 [brand] brand 文本
适用性别 [gender] audience.suggestedGender

文本

使用 audience 资源指定一个 PeopleAudience 对象,该对象本身会指定 suggestedGender。有效值是指由 gender 属性定义的值:

male

female

unisex

年龄段 [age_group] audience.suggestedMinAgeaudience.suggestedMaxAge

数字(岁数)

使用 audience 资源指定一个 PeopleAudience 对象,该对象本身会指定 suggestedMinAgesuggestedMaxAge

有效值是指由 age_group 属性定义的值:

数据规范 Schema.org 值
  suggestedMinAge
newborn 0
infant 0.25
toddler 1.0
kids 5.0
adult 13
数据规范 Schema.org 值
  suggestedMaxAge
newborn 0.25
infant 1.0
toddler 5.0
kids 13.0
adult 未指定
颜色 [color] color 文本
尺寸 [size] size 文本

尺码类型 [size_type]

size.sizeGroup

文本

有效值来自 WearableSizeGroupEnumeration 类型,最多可以指定两个值。它们对应的 Feed 值如下:

数据规范 Schema.org 值
big

WearableSizeGroupBig

maternity

WearableSizeGroupMaternity

petite

WearableSizeGroupPetite

plus

WearableSizeGroupPlus

regular

WearableSizeGroupRegular

tall

WearableSizeGroupTall

尺码体系 [size_system]

size.sizeSystem

文本

有效值来自 WearableSizeGroupEnumeration 类型,它们对应的 Feed 值如下:

数据规范 Schema.org 值
AU

WearableSizeSystemAU

BR

WearableSizeSystemBR

CN

WearableSizeSystemCN

DE

WearableSizeSystemDE

EU

WearableSizeSystemEurope

FR

WearableSizeSystemFR

IT

WearableSizeSystemIT

JP

WearableSizeSystemJP

MEX

WearableSizeSystemMX

UK

WearableSizeSystemUK

US

WearableSizeSystemUS

以下 schema.org 资源来自 Offer_type 类型,必须使用 offers 资源嵌套在商品中(参见下面的示例)。
链接 [link] url 指向商品的有效网址。
价格 [price]

price

priceCurrency

或:

priceSpecification.price

priceSpecification.priceCurrency

price:数字。提交时不能有货币符号、千位分隔符或空格(正确示例:“1498.99”)。

priceCurrency:文本。提交时使用三个英文字母组成的 ISO 4217 格式(例如 USDGBPEUR),而且货币应符合目标国家/地区的语言和货币要求。

注意pricepriceCurrency 可以直接在 Offer 实例下提供,也可以通过 priceSpecification 类型的 priceSpecification 资源间接提供

库存状况 [availability] availability

有效值来自 ItemAvailability 类型,它们对应的 Feed 值如下:

数据规范 Schema.org 值
in_stock

InStock

LimitedAvailability

OnlineOnly

out_of_stock

Discontinued

InStoreOnly

OutOfStock

SoldOut

preorder

PreOrder

PreSale

使用情况 [condition] itemCondition

有效值来自 OfferItemCondition 类型,它们对应的 Feed 值如下:

数据规范 Schema.org 值
new

NewCondition

refurbished

RefurbishedCondition

used

DamagedCondition

UsedCondition

使用 JSON-LD 的示例

一件商品

{
"@context": "https://schema.org/",
  "@type": "Product",
  "sku": "球拍-12345",
  "image": "https://www.example.com/trinket.jpg",
  "name": "优质球拍",
  "description": "线条简洁的球拍",
  "gtin14": "12345678901234",
  "brand": {
    "@type": "Thing",
    "name": "我的品牌"
  },
  "offers": {
    "@type": "Offer",
    "url": "http://www.example.com/trinket_offer",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": "39.99",
    "priceCurrency": "USD"

  }
}

使用“inProductGroupWithID”分组的多款式商品

某些商品可能包含多种款式/规格,例如颜色或价格。要显示款式/规格,您需要添加额外的结构化数据,以在一个页面上显示多件商品。此示例中的单件商品有不同的颜色和尺寸。其中一种颜色只有一个尺寸。另一种颜色有两个尺寸。inProductGroupWithID 资源用于指明所有 3 个多款式商品属于同一商品组。

示例

[
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "44E01-M11000",
    "gtin14": "98766051104218",
    "inProductGroupWithID": "44E01",
    "image": "https://www.example.com/coat_small_green.jpg",
    "name": "小号绿色外套",
    "description": "小号羊毛冬款绿色外套",
    "brand": {
      "@type": "Brand",
      "name": "优质品牌"
    },
    "audience": {
      "@type": "PeopleAudience",
      "suggestedGender": "unisex",
      "suggestedMinAge": 13
    },
    "color": "绿色",
    "size": "小号",

    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/coat?s=s&c=g",
      "priceCurrency": "USD",
      "price": 39.99,
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock"
    }
  },
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "44E01-K11000",
    "gtin14": "98766051104201",
    "inProductGroupWithID": "44E01",
    "image": "https://www.example.com/coat_small_darkblue.jpg",
    "name": "小号深蓝色外套",
    "description": "小号深蓝色冬款外套",
    "brand": {
      "@type": "Brand",
      "name": "优质品牌"
    },
    "audience": {
      "@type": "PeopleAudience",
      "suggestedGender": "unisex",
      "suggestedMinAge": 13
    },
    "color": "浅蓝色",
    "size": "小号",

    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/coat?s=s&c=lb",
      "priceCurrency": "USD",
      "price": 39.99,
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock"
    }
  },
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "44E01-X1100000",
    "gtin14": "98766051104391",
    "inProductGroupWithID": "44E01",
    "image": "https://www.example.com/coat_large_darkblue.jpg",
    "name": "大号深蓝色外套",
    "description": "大号深蓝色冬款外套",
    "brand": {
      "@type": "Brand",
      "name": "优质品牌"
    },
    "audience": {
      "@type": "PeopleAudience",
      "suggestedGender": "unisex",
      "suggestedMinAge": 13
    },
    "color": "浅蓝色",
    "size": "大号",

    "offers": {
      "@type": "Offer",
      "url": "https://www.example.com/coat?s=l&c=lb",
      "priceCurrency": "USD",
      "price": 49.99,
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock"
    }
  }
]

一个着陆页上有多个不相关的商品

如果您的页面包含多个不相关的商品,并且每个商品都有各自的结构化数据注释,则每个注释都必须包含能够标识其对应商品的信息。

例如,建议在每个注释中提供 SKU(ID [id] 属性)或 GTIN [gtin] 属性。如果您未提供此信息,您着陆页上的商品可能与您的结构化商品数据不匹配。详细了解如何在着陆页上设置结构化数据

示例

[
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "球拍-12345",
    "image": "https://www.example.com/trinket.jpg",
    "name": "优质球拍",
    "description": "线条简洁的球拍",
    "gtin14": "12345678901234",
    "brand": {
      "@type": "Brand",
      "name": "我的品牌"
    },
    "offers": {
      "@type": "Offer",
      "url": "http://www.example.com/trinket_offer",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": "39.99",
      "priceCurrency": "USD"
    }
  },
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "球拍-12345",
    "image": "https://www.example.com/racket.jpg",
    "name": "优质球拍",
    "description": "网球球拍",
    "gtin14": "12345678901235",
    "brand": {
      "@type": "Brand",
      "name": "我的品牌"
    },
    "offers": {
      "@type": "Offer",
      "url": "http://www.example.com/racket_offer",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": "59.99",
      "priceCurrency": "USD"
    }
  }
]

能效

Schema.org 支持使用 EnergyConsumptionDetails 类型标记商品的能效,您可以为使用 EnergyConsumptionDetails 资源的商品指定能效。

商品数据属性 Schema.org 资源 类型和说明
以下属性来自 schema.org EnergyConsumptionDetails 类型。
能效等级 [energy_efficiency_class] energyEfficiencyScale

有效值来自 schema.org EUEnergyEfficiencyEnumeration 类型。详情参见此表下方的值映射表。

最低能效等级 [min_energy_efficiency_class] energyEfficiencyScaleMin 在用来指定 energy_efficiency_class 属性的 EnergyConsumptionDetails 实例下添加,并使用同一映射表来选择值。如果指定了 max_energy_efficiency_class,则必须提供此属性。
最高能效等级 [max_energy_efficiency_class] energyEfficiencyScaleMax 在用来指定 energy_efficiency_class 属性的 EnergyConsumptionDetails 实例下添加,并使用同一映射表来选择值。如果指定了 min_energy_efficiency_class,则必须提供此属性。

energyEfficiencyScaleenergyEfficiencyScaleMinenergyEfficiencyScaleMax 的值来自 schema.org EUEnergyEfficiencyEnumeration 枚举类型,并映射到商品数据规范中 3 种能效属性的值,如下所示。

示例

以下示例展示了如何使用 schema.org 指定能效信息。此示例中,我们为一件热水器指定了欧盟能效等级“C”(等级标准为“A+”到“G”)。

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "1234-5678",
  "image": "https://www.example.com/waterheater.jpg",
  "name": "热水器",
  "description": "大容量热水器",
  "gtin14": "12345678901231",
  "mpn": "WH1234",
  "brand": {
    "@type": "Brand",
    "name": "ExampleWaterHeaterBrand"
  },
  "offers": {
    "@type": "Offer",
    "url": "http://www.example.com/hotwaterheater",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 1799.00,
    "priceCurrency": "EUR",
    "hasEnergyConsumptionDetails": {
      "energyEffiencyScale": "https://schema.org/EUEnergyEfficiencyCategoryC",
      "energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
      "energyEffiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryF"
    }
  }
}

示例

以下示例展示了如何使用 schema.org 指定尺码类型和尺码体系。该示例中,我们为一件 T 恤指定了采用美国尺码体系的尺码“XL”,以及尺码组“big”和“tall”。

{
    "@context": "https://schema.org/",
    "@type": "Product",
    "sku": "12345",
    "image": "https://www.example.com/tshirt.jpg",
    "name": "经典 T 恤",
    "description": "经典剪裁的全棉 T 恤",
    "gtin14": "12345678901234",
    "brand": {
      "@type": "Brand",
      "name": "我的品牌"
    },
    "size": {
      "@type": "SizeSpecification",
      "name": "XL",
      "sizeSystem": "US",
      "sizeGroup": [ "big", "tall" ]
    },
    "offers": {
      "@type": "Offer",
      "url": "http://www.example.com/tshirt",
      "itemCondition": "https://schema.org/NewCondition",
      "availability": "https://schema.org/InStock",
      "price": "24.99",
      "priceCurrency": "USD"
    }
  }

测试标记

使用富媒体搜索结果工具测试您的 schema.org 实现代码。访问 Google Search Console 帮助中心,详细了解如何使用该工具、如何调试各种问题以及如何解读该工具中的结果。

结构化数据标记的要求

  • 结构化数据标记必须包含在从网络服务器返回的 HTML 中。页面加载后,将无法使用 JavaScript 生成结构化数据标记。
  • 着陆页不能根据不同的客户信息发生变化(例如,根据客户的 IP 地址或浏览器类型调整价格)。
  • 结构化数据必须与客户所看到的值一致。在商品着陆页上提供不正确的数据属于违反 Web 开发者指南的行为。
  • Google 建议您为结构化数据使用 JSON-LD。
该内容对您有帮助吗?
您有什么改进建议?

需要更多帮助?

登录可获取更多支持选项,以便快速解决您的问题

搜索
清除搜索查询
关闭搜索框
Google 应用
主菜单
搜索支持中心
true
71525
false
false