在產品到達網頁上使用結構化資料標記，有助於 Google 直接從您的網站擷取產品和優惠活動的最新資訊。Merchant Center 支援的結構化資料標記都會有對應的屬性和可接受的值，詳情請參考產品資料規格。結構化資料必須和對應的值及屬性相符。
本頁內容：
屬性和 schema.org 註解
Merchant Center 會透過許多方式來整理您提交的產品資料，屬性就是其中之一。每個屬性都含有關於產品的單項資訊，例如產品的名稱或說明。只要將 schema.org 的值和相對應的產品資料規格屬性正確配對，就能減少系統在驗證動態饋給時所找到的錯誤。
注意：如果採用商品自動更新功能，請務必指定 schema.org 資源 price、priceCurrency、availability 和 condition，藉此提高資訊準確度。進一步瞭解商品自動更新功能。
|
產品資料屬性
|
類型與說明 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
以下屬性摘錄自 schema.org 的 Product 類型。 |
|||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
| 網址 | |||||||||||||||||||||||||||||
|
文字 父項 SKU。如要將屬於相同產品群組的所有子類產品歸為一組，此為必要屬性。 |
|||||||||||||||||||||||||||||
|
文字 每項產品都有專屬的全球交易品項識別碼。 您只能指定其中一種 schema.org 資源。 使用全球交易品項識別碼值時，長度必須正確，並且須包含正確的檢查碼。 |
|||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
|
文字 |
|||||||||||||||||||||||||||||
|
文字 使用
|
|||||||||||||||||||||||||||||
|
及 |
數字 (以年為單位) 使用 如需有效值的定義，請參閱
|
||||||||||||||||||||||||||||
| 文字 | |||||||||||||||||||||||||||||
|
或 |
文字 使用 |
||||||||||||||||||||||||||||
|
文字 使用 有效值摘錄自
|
|||||||||||||||||||||||||||||
|
文字 使用 有效值摘錄自 WearableSizeSystemEnumeration 類型，這些資料值和動態饋給值的對應關係如下：
|
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
使用 |
|||||||||||||||||||||||||||||
|
以下 schema.org 資源摘錄自 Offer 類型，該類型必須在 |
|||||||||||||||||||||||||||||
| 產品的有效網址。 | |||||||||||||||||||||||||||||
|
或 |
price：數字。不得包含貨幣符號、千位數分隔字元或空格 (例如「1498.99」)。 priceCurrency：文字。必須採用 ISO 4217 格式並以 3 個英文字母表示 (例如 USD、GBP、EUR)，且貨幣應符合指定國家/地區的語言和貨幣規定。 注意：price 和 priceCurrency 值可直接透過 Offer 例項提供，或是透過 UnitPriceSpecification 類型的 priceSpecification 資源間接提供。 如果已指定 sale_price，請務必使用 priceSpecification 資源搭配 priceSpecification.priceType="ListPrice" 來提供 price 值。 sale_price 值可直接透過 Offer 提供，或是透過 UnitPriceSpecification 類型的 priceSpecification 資源，無須搭配 priceSpecification.priceType。 |
||||||||||||||||||||||||||||
|
有效值摘錄自
|
|||||||||||||||||||||||||||||
|
有效值摘錄自
|
|||||||||||||||||||||||||||||
| 產品的有效結帳頁面網址。 | |||||||||||||||||||||||||||||
採用 JSON-LD 的示例
單一產品
示例
下例說明基本的產品屬性。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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 指定尺寸類型和尺寸系統。這個例子指定藍色 T 恤為美國尺寸系統「XL」、適用對象為成人 (13 歲以上年齡層)，且屬於「Big&Tall」男性時裝部門。
{
"@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": "MyBrand"
},
"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] 屬性)。如果沒有提供前述資訊，到達網頁中的產品可能會與結構化產品資料不符。進一步瞭解如何設定到達網頁的結構化資料。
示例
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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": "racket-12345",
"image": "https://www.example.com/racket.jpg",
"name": "優質網球拍",
"description": "網球拍",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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 指定原價，編碼就會包含兩組 /UnitPriceSpecifications：
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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 類型，該類型必須在 Offer 中使用 shippingDetails 資源嵌入，並與產品資料規格中的 shipping 屬性相對應。你可以提供多個 shippingDetails 資源。
|
產品資料屬性
|
類型與說明 |
|---|---|
以下屬性摘錄自 schema.org 的 OfferShippingDetails 類型。 |
|
|
|
文字 ISO 3166-1 國家/地區代碼 (共 2 碼) 使用 |
|
文字 ISO 3166-2 子行政區代碼 (2 或 3 碼)，不包含國家/地區的前置縮寫。僅適用於美國、澳洲或日本。例如：「NY」、「NSW」或「03」。 使用 |
|
|
使用 |
|
|
數字 (非負數的整數) 指定訂單的最短和最長處理及運送時間，以工作天為單位。處理時間是指從下單到產品出貨給貨運公司之間的時間。運送時間則是指產品出貨給貨運公司到送達消費者手上之間的時間。 使用 |
|
示例
下例說明如何透過 schema.org 指定運送資訊。這個例子為美國加州、內華達州和亞利桑那州指定 3.49 美元的運費。處理時間為 0 至 1 個工作天不等，運送時間則為 1 至 5 個工作天不等。
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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 類型，該類型必須在 Offer 類型中使用 hasMerchantReturnPolicy 資源嵌入。
|
產品資料屬性
|
類型與說明 |
|---|---|
| 以下 schema.org 資源摘錄自 MerchantReturnPolicy 類型，該類型必須在 Product 中使用 offers 資源嵌入 (請參閱以下示例)。 | |
| applicableCountry |
以 2 個英文字母表示的 ISO 3166-1 alpha-2 國家/地區代碼 (例如「US」) 以 3 個英文字母表示的 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": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "優質飾品",
"description": "線條俐落的飾品",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"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": "basrice12345",
"image": "https://www.example.com/rice.jpg",
"name": "印度香米",
"description": "大袋裝有機印度香米，5 公斤",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "ExampleRiceBrand"
},
"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 位址或瀏覽器類型自動調整價格。
- 結構化資料必須和客戶看到的值相同。在產品到達網頁上提供不正確的資料，將違反網頁程式開發人員指南的規定。
- Google 建議您使用 JSON-LD 來處理結構化資料。