在商品着陆页上使用结构化数据标记，可以帮助 Google 直接从您的网站检索有关商品和优惠的最新信息。Merchant Center 支持的结构化数据标记都有相应的属性和可接受的值，具体请参见商品数据规范。结构化数据必须与相应的值和属性相匹配。
本页内容：
属性和 schema.org 注释
系统采用多种方式整理您提交到 Merchant Center 的商品数据，属性就是其中之一。每个属性包含与商品有关的一项信息，例如商品的名称或说明。将 schema.org 值与相应的商品数据规范属性准确匹配，有助于降低验证 Feed 时出错的几率。
注意：如果使用自动商品更新功能，请务必指定 schema.org 属性 price、priceCurrency、availability 和 condition，以提高准确度。不妨详细了解自动商品更新功能。
|
商品数据属性
|
类型和说明 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
以下属性来自 schema.org 上的 Product 类型 |
|||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
| 网址 | |||||||||||||||||||||||||||||
|
文本 这是一个父级 SKU，在将属于同一商品组的所有多款式商品组合在一起时需要用到此属性。 |
|||||||||||||||||||||||||||||
|
文本 每个商品都有的独一无二的 GTIN 识别码。 您只能指定其中一个 schema.org 属性。 使用 GTIN 值时，请确保其长度正确且包含正确的校验位。 |
|||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
|
文本 |
|||||||||||||||||||||||||||||
|
文本 使用
|
|||||||||||||||||||||||||||||
|
以及 |
数字（岁数） 使用 有效值是
|
||||||||||||||||||||||||||||
| 文本 | |||||||||||||||||||||||||||||
|
或者 |
文本 使用 |
||||||||||||||||||||||||||||
|
文本 使用 有效值来自
|
|||||||||||||||||||||||||||||
|
文本 使用 有效值来自 WearableSizeSystemEnumeration 类型，它们对应的 Feed 值如下：
|
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
以下 schema.org 属性来自 Offer 类型，必须使用 |
|||||||||||||||||||||||||||||
| 指向商品的有效网址。 | |||||||||||||||||||||||||||||
|
或者： |
price：数字。提交时不能带货币符号、千位分隔符或空格（正确示例：“1498.99”）。 priceCurrency：文本。提交时使用三个英文字母组成的 ISO 4217 格式（例如 USD、GBP、EUR），而且货币应符合目标国家/地区的语言和货币要求。 注意：price 和 priceCurrency 可以直接在 Offer 实例下提供，也可以通过 UnitPriceSpecification 类型的 priceSpecification 属性间接提供。 如果指定了 sale_price，则必须使用 priceSpecification.priceType="ListPrice" 的 priceSpecification 属性提供 price。 sale_price 可以直接在 Offer 下指定，也可以通过不带 priceSpecification.priceType、类型为 UnitPriceSpecification 的 priceSpecification 属性指定。 |
||||||||||||||||||||||||||||
|
有效值来自
|
|||||||||||||||||||||||||||||
|
有效值来自
|
|||||||||||||||||||||||||||||
| 指向商品的有效结账网址。 | |||||||||||||||||||||||||||||
使用 JSON-LD 的示例
单件商品
示例
以下示例展示了基本的商品数据，其中包含最低数量的必需属性。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
}
以下示例展示了如何使用 schema.org 指定尺码类型和尺码体系。该示例在男式时装的“高大”分组中为一件成人（13 周岁以上的年龄段）蓝色 T 恤指定了美国尺码体系中的“XL”。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "12345",
"image": "https://www.example.com/tshirt.jpg",
"name": "经典 T 恤",
"description": "经典剪裁的全棉 T 恤",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"material": "全棉",
"color": "蓝色",
"size": {
"@type": "SizeSpecification",
"name": "XL",
"sizeSystem": "https://schema.org/WearableSizeSystemUS",
"sizeGroup": [
"https://schema.org/WearableSizeGroupBig",
"https://schema.org/WearableSizeGroupTall"
]
},
"audience": {
"@type": "PeopleAudience",
"suggestedGender": "male",
"suggestedMinAge": 13
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/tshirt",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 24.99,
"priceCurrency": "USD"
}
}
一个着陆页上有多个不相关的商品
如果您的页面包含多个不相关的商品，并且每个商品都有各自的结构化数据注释，则每个注释都必须包含能够标识其对应商品的信息。
例如，建议在每个注释中提供 SKU（ID [id] 属性）或 GTIN（[gtin] 属性）。如果您未提供此信息，您着陆页上的商品可能与您的结构化商品数据不匹配。详细了解如何在着陆页上设置结构化数据。
示例
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://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": "网球拍",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/racket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 59.99,
"priceCurrency": "USD"
}
}
]促销价
以下示例展示了包含促销价的基本商品数据。为了指明促销价，您还需要指定由 /priceType 属性指定的原始定价。
示例
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 10.00,
"priceCurrency": "USD",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
}
}
如果 /UnitPriceSpecification 也用于原价，那么代码只需包含两个 /UnitPriceSpecification：
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": [
{
"@type": "UnitPriceSpecification",
"price": 10.00,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
]
}
}
运费
要为商品指定运费（推荐），请使用 Schema.org OfferShippingDetails 类型，该类型必须使用 shippingDetails 属性嵌套在 Offer 中，对应商品数据规范中的 shipping 属性。您可以提供多个 shippingDetails 属性。
|
商品数据属性
|
类型和说明 |
|---|---|
以下属性来自 schema.org OfferShippingDetails 类型。 |
|
|
|
文本 2 位数的 ISO 3166-1 国家/地区代码 使用 |
|
文本 2 位或 3 位的 ISO 3166-2 子类代码（不含国家/地区前缀）。仅适用于美国、澳大利亚或日本。例如：“NY”“NSW”或“03”。 使用 |
|
|
使用 |
|
|
数字（非负整数） 指定完成订单处理和运送所需的最小和最大工作日数。订单处理时间指定了从下单到发货给运输公司之间的时间。运送时间指定了从发货给运输公司到商品送达客户手中之间的时间。 使用 |
|
示例
以下示例展示了如何使用 schema.org 指定运费信息。该示例指明寄往美国加利福尼亚州、内华达州和亚利桑那州的运费为 3.49 美元。订单处理时间为 0 到 1 个工作日，而运送时间为 1 到 5 个工作日。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US",
"addressRegion": [ "CA", "NV", "AZ" ]
},
"shippingRate": {
"@type": "MonetaryAmount",
"value": 3.49,
"currency": "USD"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
}
}
退货
要为商品指定退货期限和退货费用，请使用 Schema.org MerchantReturnPolicy 类型，该类型必须使用 hasMerchantReturnPolicy 属性嵌套在 Offer 类型中。
|
商品数据属性
|
类型和说明 |
|---|---|
| 以下 schema.org 属性来自 MerchantReturnPolicy，必须使用 offers 属性嵌套在商品中（参见下面的示例）。 | |
| applicableCountry |
双字母 ISO 3166-1 alpha-2 国家/地区代码（例如“US”） 三字母 ISO 3166-1 alpha-3 国家/地区代码（例如“USA”） 特定商家退货政策的适用国家/地区。该国家/地区可以不同于商品发货国家/地区。您最多可以指定 50 个国家/地区。 |
|
有效值来自 MerchantReturnEnumeration 类型： 如果指定为 MerchantReturnFiniteReturnWindow 或 MerchantReturnUnlimitedWindow，建议使用 returnMethod 和 returnShippingFeesAmount。此外，如果指定为 MerchantReturnFiniteReturnWindow，则 merchantReturnDays 为必需。 |
|
| merchantReturnDays |
允许的商品退货期限（从送达日期开始计算）。 |
| returnMethod |
有效值来自 ReturnMethodEnumeration 类型：
|
| returnFees | 有效值为来自 ReturnFeesEnumeration 类型的 FreeReturn。 |
| returnShippingFeesAmount |
商品退货的运费相关信息。 |
示例
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "饰品-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "优质饰品",
"description": "线条简洁的饰品",
"brand": {
"@type": "Brand",
"name": "我的品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": 2.99,
"currency": "USD"
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 60,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn"
}
}
}
能效
Schema.org 支持使用 EnergyConsumptionDetails 类型标记商品的能效，您可以为使用 EnergyConsumptionDetails 属性的商品指定能效。
|
商品数据属性
|
类型和说明 |
|---|---|
以下 schema.org 属性来自 EnergyConsumptionDetails 类型。 |
|
|
有效值来自 schema.org |
|
在用来指定 energy_efficiency_class 属性的 EnergyConsumptionDetails 实例下添加，并使用同一映射表来选择值。如果您未提供这项数据，且指定了 energy_efficiency_class，则系统会认定值为 EUEnergyEfficiencyCategoryG。 |
|
在用来指定 energy_efficiency_class 属性的 EnergyConsumptionDetails 实例下添加，并使用同一映射表来选择值。如果您未提供这项数据，且指定了 energy_efficiency_class，则系统会认定值为 EUEnergyEfficiencyCategoryA3Plus。 |
|
energyEfficiencyScale、energyEfficiencyScaleMin 和 energyEfficiencyScaleMax 的值来自 schema.org EUEnergyEfficiencyEnumeration 枚举类型，并对应商品数据规范中 3 种能效属性的值，如下所示。
示例
以下示例展示了如何使用 schema.org 指定能效信息。此示例中，我们为一件热水器指定了欧盟能效等级“C”（等级标准为“A+”到“F”）。
{ "@context": "https://schema.org/", "@type": "Product", "sku": "1234-5678", "image": "https://www.example.com/waterheater.jpg", "name": "热水器", "description": "大容量热水器", "gtin": "12345678901231", "mpn": "WH1234", "brand": { "@type": "Brand", "name": "ExampleWaterHeaterBrand" },
"hasEnergyConsumptionDetails": {
"hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
"energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
}, "offers": { "@type": "Offer", "url": "https://www.example.com/hotwaterheater", "itemCondition": "https://schema.org/NewCondition", "availability": "https://schema.org/InStock", "price": 1799.00, "priceCurrency": "EUR" }}单价
Schema.org 支持使用 Offer 的 priceSpecification 属性提供 UnitPriceSpecification 类型，然后使用其下的 referenceQuantity 属性指定商品单价。在指定单价时，还要使用 priceSpecification 属性指定商品的价格和货币（而不是直接使用 Offer 的 price 和 priceCurrency 属性）。
|
商品数据属性
|
类型和说明 |
|---|---|
以下 schema.org 属性来自 UnitPriceSpecification 类型。 |
|
|
在用于指定商品价格的 使用 |
|
|
在用于指定价格计量单位的 使用 |
|
示例
以下示例说明一袋 5 千克的米价格为 3.99 欧元，并以每千克价格为首选标准价格。也就是说，商品可能会以每千克 0.80 欧元的单价展示给消费者。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "印度香米12345",
"image": "https://www.example.com/rice.jpg",
"name": "印度香米",
"description": "大袋有机印度香米，5 千克装",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "示例大米品牌"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/basrice1kg",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 3.99,
"priceCurrency": "EUR",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 5,
"unitCode": "KGM",
"valueReference": {
"value": 1,
"unitCode": "KGM"
}
}
}
}
}
测试标记
您可以使用富媒体搜索结果工具测试您的 schema.org 实现代码（通过查看“商家信息”结构化数据报告）。请访问 Google Search Console 帮助中心，详细了解如何使用该工具、如何排查各种问题以及如何解读该工具中的结果。您还可以详细了解商品结构化数据。
结构化数据标记的要求
- 结构化数据标记必须包含在从网络服务器返回的 HTML 中。页面加载后，将无法使用 JavaScript 生成结构化数据标记。
- 着陆页不能根据不同的客户信息发生变化（例如，根据客户的 IP 地址或浏览器类型调整价格）。
- 结构化数据必须与客户所看到的值一致。在商品着陆页上提供不正确的数据属于违反 Web 开发者指南的行为。
- Google 建议您为结构化数据使用 JSON-LD。