支援的結構化資料屬性和值

在產品到達網頁上使用結構化資料標記,有助於 Google 直接從您的網站擷取產品的最新資訊和優惠活動。Merchant Center 支援的結構化資料標記都會有對應的屬性和可接受的值,詳情請參考產品資料規格。結構化資料必須和對應的值及屬性相符。
 

schema.org 目前不支援部分屬性。

屬性和 schema.org 註解

Merchant Center 會用許多方式來整理您提交的產品資料,屬性就是其中之一。每個屬性都含有關於商品項目的單一資訊,例如商品項目的 title [名稱] 或 description [說明]。只要將 schema.org 的值和相對應的產品資料規格屬性正確配對,就能減少系統在驗證動態饋給時所找到的錯誤。

您可以在產品資料規格中查到主要屬性清單。

schema.org 資源

產品資料屬性

說明
以下屬性摘錄自 schema.org Product 結構定義網頁
sku id [ID] SKU 字串
name Title [名稱] 文字
description Description [說明] 文字
image image_link [圖片連結] 有效的圖片網址
itemCondition Condition [狀況] 有效的 OfferItemCondition。最常見的 schema.org 值是「NewCondition」和「UsedCondition」。

gtin8

gtin12

gtin13

gtin14

isbn

gtin [GTIN]

只能指定左列的其中一個 schema.org 資源。

使用全球交易品項識別碼 (GTIN) 值時長度必須正確,而且要加入正確的檢查碼。

suggestedGenderpeopleAudience gender [性別] 請使用 audience 資源指定 PeopleAudience 物件,這個物件會自行指定 suggestedGender。如需有效值的定義,請參閱 gender [性別] 屬性:
  • male [男性]
  • female [女性]
  • unisex [男女通用]
mpn MPN [製造商零件編號] 文字
brand Brand [品牌] 文字
color Color [顏色] 文字

以下屬性摘錄自 schema.org Offer 結構定義網頁,必須在 Product 中用 offers 資源嵌入 (請參閱以下範例)。

price

priceCurrency 

Price [價格]

price 必須是純數字,不能有貨幣符號、千位數分隔字元或空格 (例如「1498.99」)。

priceCurrency 值必須採用 3 碼的 ISO 4217 格式 (例如「USD」、「GBP」、「EUR」),而且貨幣應該符合指定國家/地區的語言和幣別規定。

附註:您可以直接透過 offers 或 priceSpecification 提供 pricepriceCurrency 值 (請參考以下範例)。

availability Availability [供應情形]

可用的有效值屬於 ItemAvailability 類型,這些資料值和動態饋給值的對應關係如下:

資料規格 結構定義值
in_stock [有現貨]
  • InStock 
  • LimitedAvailability 
  • OnlineOnly
out_of_stock [缺貨中]
  • Discontinued
  • InStoreOnly
  • OutOfStock
  • SoldOut
preorder [預購]
  • PreOrder 
  • PreSale

 

itemCondition Condition [狀況]

可用的有效值屬於 OfferItemCondition 類型,這些資料值和動態饋給值的對應關係如下:

資料規格 結構定義值
new [新品]
  • NewCondition
refurbished [整新品]
  • RefurbishedCondition
used [二手]
  • DamagedCondition
  • UsedCondition

附註:您必須指定 price [價格]、priceCurrency [價格貨幣] 和 availability [供應情形] 才能使用商品項目自動更新功能。

單一產品 (範例)

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org/",
  "@type": "Product",
  "sku": "EXAMPLE-1337-json",
  "gtin14" : "12345678901234",
  "mpn": "925873",
  "image": "http://fake.example.com/test_executive.jpg",
  "name": "Executive test JSON-LD",
  "description": "This is just a boring example",
  "brand": {
    "@type": "Thing",
    "name": "EXAMPLE"
  },
  "color" : "Silver",
  "audience": {
    "@type": "PeopleAudience",
    "suggestedGender": "unisex"
  },
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": "119.99",
    "itemCondition": "http://schema.org/UsedCondition",
    "availability": "http://schema.org/InStock"
  }
}
</script>

微資料

<span itemscope itemtype="http://schema.org/Product">
    <meta itemprop="sku" content="EXAMPLE-1337-micro">
    <meta itemprop="gtin14" content="12345678901234">
    <meta itemprop="mpn" content="925873">
    <meta itemprop="image" content="http://fake.example.com/test_executive.jpg"/>
    <meta itemprop="name" content="Executive test Microdata">
    <meta itemprop="description" content="This is just a boring example">
    <meta itemprop="brand" content="EXAMPLE">
    <meta itemprop="color" content="Silver">
    <span itemprop="audience" itemscope itemtype="http://schema.org/PeopleAudience">
              <meta itemprop="suggestedGender" content="unisex"/>
    </span>
    <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
        <meta itemprop="priceCurrency" content="USD"/>
        <meta itemprop="price" content="119.99">
        <link itemprop="itemCondition" href="http://schema.org/UsedCondition"/>
        <link itemprop="availability" href="http://schema.org/InStock"/>
    </span>
</span>

產品子類

某些產品可能按照顏色或價格分成各種子類。如果要顯示子類,您必須加入額外的結構化資料,才能在同一個網頁上顯示多種產品。

範例

JSON-LD

<script type="application/ld+json">
  [
   {
        "@context": "http://schema.org/",
          "@type": "Product",
          "sku": "EXAMPLE-1337-json-silver",
          "gtin14" : "12345678901234",
          "mpn": "925873",
          "image": "http://fake.example.com/test_executive.jpg",
          "name": "Example Test",
          "description": "This is just a boring example",
          "brand": {
            "@type": "Thing",
            "name": "EXAMPLE"
          },
          "color" : "Silver",
          "offers": {
            "@type": "Offer",
            "priceCurrency": "USD",
            "price": "119.99",
            "itemCondition": "http://schema.org/UsedCondition",
            "availability": "http://schema.org/InStock"
          }
     },
    {
        "@context": "http://schema.org/",
          "@type": "Product",
          "sku": "EXAMPLE-1337-json-gold",
          "gtin14" : "12345678901234",
          "mpn": "925873",
          "image": "http://fake.example.com/test_executive.jpg",
          "name": "Example Test",
          "description": "This is just a boring example",
          "brand": {
            "@type": "Thing",
            "name": "EXAMPLE"
          },
          "color" : "Gold",
          "offers": {
            "@type": "Offer",
            "priceCurrency": "USD",
            "price": "3119.99",
            "itemCondition": "http://schema.org/UsedCondition",
            "availability": "http://schema.org/InStock"
          }
    }
  ]
</script>

微資料

<span itemscope itemtype="http://schema.org/Product">
    <meta itemprop="sku" content="acme-1337-micro-silver">
    <meta itemprop="gtin14" content="12345678901234">
    <meta itemprop="mpn" content="925873">
    <meta itemprop="image" content="http://fake.example.com/test_executive.jpg"/>
    <meta itemprop="name" content="Example Test">
    <meta itemprop="description" content="This is just a boring example">
    <meta itemprop="brand" content="EXAMPLE">
    <meta itemprop="color" content="Silver">

 

    <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
        <meta itemprop="priceCurrency" content="USD"/>
        <meta itemprop="price" content="119.99">
        <link itemprop="itemCondition" href="http://schema.org/UsedCondition"/>
        <link itemprop="availability" href="http://schema.org/InStock"/>
    </span>
</span>
<span itemscope itemtype="http://schema.org/Product">
    <meta itemprop="sku" content="acme-1337-micro-gold">
    <meta itemprop="gtin14" content="12345678901235">
    <meta itemprop="mpn" content="925873">
    <meta itemprop="image" content="http://fake.example.com/test_executive.jpg"/>
    <meta itemprop="name" content="Example Test">
    <meta itemprop="description" content="This is just a boring example">
    <meta itemprop="brand" content="EXAMPLE">
    <meta itemprop="color" content="Gold">

    <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
        <meta itemprop="priceCurrency" content="USD"/>
        <meta itemprop="price" content="3119.99">
        <link itemprop="itemCondition" href="http://schema.org/UsedCondition"/>
        <link itemprop="availability" href="http://schema.org/InStock"/>
    </span>
</span>

PriceSpecification

結構化資料標記讓您能以兩種方式顯示價格資訊。在上述範例中,pricepriceCurrency 都是直接顯示在 offers 層級下,但是您也可以用 priceSpecification 屬性顯示價格資訊,提供更多資料。

範例

JSON-LD

  "offers": {
    "@type": "Offer",
    "priceSpecification": {
        "@type":  "PriceSpecification",
        "priceCurrency": "USD",
        "price": "119.99"
    }

微資料

   <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
      <span itemprop="priceSpecification" itemscope   
            itemtype="http://schema.org/PriceSpecification">
        <meta itemprop="priceCurrency" content="USD"/>
        <meta itemprop="price" content="119.99">
      </span>    
    </span>

測試您的標記

您可以使用結構化資料測試工具來測試 Schema.org 的導入情形。請前往 Google Search Console 說明中心瞭解如何運用這套工具、排除任何問題,以及判讀工具執行後產生的結果。

結構化資料標記的需求

  • 結構化資料標記必須出現在網站伺服器傳回來的 HTML 中。一旦載入網頁,JavaScript 就無法產生結構化資料標記。
  • 到達網頁無法根據使用者的相關資訊而更改,例如無法根據使用者的 IP 位址或瀏覽器類型而自動調整價格。
  • 結構化資料必須和使用者看到的值相同。在產品到達網頁上提供錯誤資料,即違反網站管理員指南的規定。
這對您有幫助嗎?
我們應如何改進呢?