機構 (Organization) 結構化資料

Google 搜尋結果中的商家知識面板

你可以使用機構結構化資料讓 Google 瞭解貴機構的管理詳細資料,例如標誌、地址、聯絡資訊和商家 ID。這麼一來,Google 就能在知識面板和其他視覺元素 (例如歸因) 中使用這個標記,幫助使用者在 Google 搜尋中找到貴機構的詳細資料。

如何新增結構化資料

結構化資料是一種標準化格式,能夠提供網頁相關資訊並分類網頁內容。如果您是第一次使用結構化資料,請參閱這篇文章,進一步瞭解結構化資料的運作方式。

以下簡要說明如何建立、測試及發布結構化資料。

  1. 盡可能加入網頁適用的建議屬性。提醒您,並沒有所謂的必要屬性,因此請改為加入適用於內容的屬性。根據您使用的格式,瞭解要在網頁中的什麼位置插入結構化資料
  2. 遵循指南規範
  3. 使用複合式搜尋結果測試驗證程式碼,並修正所有重大錯誤。此外,我們也建議您修正工具中可能標記的任何非重大問題,因為這有助於改善結構化資料的品質 (但並非符合複合式搜尋結果的顯示條件)。
  4. 部署幾個包含結構化資料的網頁,並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁,且網頁並未遭到 robots.txt 檔案或 noindex 標記封鎖,也未設有登入規定。如果網頁看起來沒問題,您可以要求 Google 重新檢索您的網址
  5. 為了讓 Google 掌握日後的異動內容,建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。

範例

Organization

以下是採用 JSON-LD 程式碼的機構資訊範例。


<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "Organization",
      "image": "https://www.example.com/example_image.jpg",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example1234", "https://example.org/example1234"],
      "logo": "https://www.example.com/images/logo.png",
      "name": "Example Corporation",
      "description": "The example corporation is well-known for producing high-quality widgets",
      "email": "contact@example.com",
      "telephone": "+47-99-999-9999",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "Rue Improbable 99",
        "addressLocality": "Paris",
        "addressCountry": "FR",
        "addressRegion": "Ile-de-France",
        "postalCode": "75001"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228"
    }
    </script>
  </head>
  <body>
  </body>
</html>

包含退貨政策的 OnlineStore (子類型範例:Organization)

以下是以 JSON-LD 程式碼呈現的網路商店資訊範例。

<html>
  <head>
    <title>About Us</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "OnlineStore",
      "name": "Example Online Store",
      "url": "https://www.example.com",
      "sameAs": ["https://example.net/profile/example12", "https://example.org/@example34"],
      "logo": "https://www.example.com/assets/images/logo.png",
      "contactPoint": {
        "contactType": "Customer Service",
        "email": "support@example.com",
        "telephone": "+47-99-999-9900"
      },
      "vatID": "FR12345678901",
      "iso6523Code": "0199:724500PMK2A2M1SQQ228",
      "hasMerchantReturnPolicy": {
        "@type": "MerchantReturnPolicy",
        "applicableCountry": ["FR", "CH"],
        "returnPolicyCountry": "FR",
        "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
        "merchantReturnDays": 60,
        "returnMethod": "https://schema.org/ReturnByMail",
        "returnFees": "https://schema.org/FreeReturn",
        "refundType": "https://schema.org/FullRefund"
      }
      ... // Other Organization-level properties
    }
    </script>
  </head>
  <body>
  </body>
</html>

指南規範

你必須按照下列規範啟用結構化資料,才能讓網站顯示在 Google 搜尋結果中。

技術指南

建議將這項資訊放在首頁或有關貴機構簡介的單一頁面,例如「關於我們」頁面。你不需要在網站的每個網頁中都加入這項資訊。

我們建議依照貴機構的性質,使用最具體的 schema.org Organization 子類型。舉例來說,如果你經營的是電子商務網站,建議使用 OnlineStore 子類型,而非 OnlineBusiness。如果你的網站與當地商家(例如餐廳或實體商店) 相關,建議以最具體的 LocalBusiness 子類型提供管理詳細資料;除了本指南中建議的欄位外,也請遵守當地商家的必要和建議欄位規定。

結構化資料類型定義

Google 可識別 Organization 的下列屬性。為了讓 Google 更清楚瞭解你的網頁,請盡可能加入網頁適用的建議屬性。提醒你,並沒有所謂必要屬性,因此請改為加入適用於貴機構的屬性。

建議屬性
address

PostalAddress

貴機構的實際地址或郵寄地址 (如適用)。請納入所有適用於您所在國家/地區的資源。提供的屬性越多,使用者從搜尋結果獲得的資訊就越豐富。如果你在多個城市、州/省或國家/地區都有門市,可以提供多個地址。 例如:

"address": [{
  "@type": "PostalAddress",
  "streetAddress": "999 W Example St Suite 99 Unit 9",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
},{
  "streetAddress": "999 Rue due exemple",
  "addressLocality": "Paris",
  "postalCode": "75001",
  "addressCountry": "FR"
}]
address.addressCountry

Text

郵寄地址的國家/地區 (使用兩個英文字母組成的 ISO 3166-1 alpha-2 國家/地區代碼)。

address.addressLocality

Text

郵寄地址中的城市。

address.addressRegion

Text

郵寄地址所在區域 (如適用),例如州/省。

address.postalCode

Text

地址的郵遞區號。

address.streetAddress

Text

貴機構郵寄地址的完整街道地址。

alternateName

Text

貴機構使用的另一個常見名稱 (如有)。

contactPoint

ContactPoint

使用者與貴公司聯絡的最佳管道 (如有)。請按照 Google 建議的最佳做法,加入可讓使用者取得支援的所有方式。例如:

"contactPoint": {
  "@type": "ContactPoint",
  "telephone": "+9-999-999-9999",
  "email": "contact@example.com"
}
contactPoint.email

Text

商家的聯絡電子郵件地址 (如有)。 如果您使用的是 LocalBusiness 類型,請先在 LocalBusiness 層級指定主要電子郵件地址,再使用 contactPoint 指定多種連線至貴機構的方式。

contactPoint.telephone

Text

商家的聯絡電話號碼 (如有)。 請務必在電話號碼中加入國家/地區代碼和區碼。 如果您使用 LocalBusiness 類型,請先在 LocalBusiness 層級指定主要電話號碼,再使用 contactPoint 指定多種聯絡貴機構的方式。

description

Text

貴機構的詳細介紹 (如有)。

duns

Text

用於識別 Organization 的鄧白氏環球編碼 (如有)。建議改用 iso6523Code 欄位加上前置字串 0060:

email

Text

商家的聯絡電子郵件地址 (如有)。

foundingDate

Date

Organization 的創立日期,採用 ISO 8601 日期格式 (如有)。

globalLocationNumber

Text

用於識別 Organization 位置的 GS1 全球位置編號 (如有)。

hasMerchantReturnPolicy

MerchantReturnPolicy

Organization 使用的退貨政策 (如適用)。如果您新增這項資源,請務必一併為 MerchantReturnPolicy 加入 必要欄位和建議欄位

iso6523Code

Text

貴機構的 ISO 6523 ID (如有)。 ISO 6523 ID 的前半部分是 ICD (國際代碼標示元),用於定義採用何種識別配置。後半部分則是實際 ID。建議使用冒號字元 (U+003A) 分隔 ICD 和 ID。常見的 ICD 值包括:

  • 0060:鄧白氏資料通用編碼系統 (DUNS)
  • 0088:GS1 全球位置編號 (GLN)
  • 0199:法人 ID (LEI)
legalName

Text

Organization 的註冊法定名稱 (如有),與 name 屬性不同。

leiCode

Text

Organization 依據 ISO 17442 定義的 ID (如有)。 建議你改用 iso6523Code 欄位加上前置字串 0199:

logo

URLImageObject

可代表貴機構的標誌 (如有)。新增這項屬性,有助於 Google 進一步瞭解您要在搜尋結果和知識面板等區塊顯示哪些標誌。

圖片使用規範:

  • 圖片大小不得小於 112 x 112 px。
  • 圖片網址必須可供檢索和建立索引。
  • 圖片檔案必須使用 Google 圖片支援的格式
  • 請確認圖片顯示在純白背景上的外觀符合您的需求 (舉例來說,如果標誌幾乎全是白色或灰色,顯示在白色背景上的樣子可能會不符您的需求)。

如果您使用 ImageObject 類型,請確定該類型具備有效的 contentUrl 屬性或 url 屬性 (遵循與 URL 類型相同的規範)。

naics

Text

Organization 適用的北美產業分類系統 (NAICS) 代碼 (如有)。

name

Text

貴機構的名稱。請使用與網站名稱相同的 namealternateName

numberOfEmployees

QuantitativeValue

Organization 的員工人數 (如有)。

以下是員工人數為具體數字的例子:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "value": 2056
}

以下是員工人數為特定範圍的例子:

"numberOfEmployees": {
  "@type": "QuantitativeValue",
  "minValue": 100,
  "maxValue": 999
}
sameAs

URL

其他網站的網頁網址,提供貴機構的額外資訊 (如有)。例如貴機構在社群媒體或評論網站上的資料頁面網址。您可以提供多個 sameAs 網址。

taxID

Text

Organization 相關聯的稅號 (如有)。請確認 taxID 與你在 address 欄位中提供的國家/地區相符。

telephone

Text

商家電話號碼,是供消費者使用的主要聯絡方式 (如有)。 請務必在電話號碼中加入國家/地區代碼和區碼。

url

URL

貴機構網站的網址 (如有)。這有助於 Google 準確識別貴機構。

vatID

Text

Organization 相關聯的加值稅 (VAT) 代碼 (如有)。這對使用者而言是重要的信任信號,舉例來說,使用者可藉此在公開的加值稅註冊資料庫中查詢你的商家。

MerchantReturnPolicy

使用下列屬性說明整個 Organization 的一般退貨政策 (如適用)。 如果您針對個別產品設有特定政策,請使用商家資訊標記

必要屬性 (請選擇最符合您用途的選項)
選項 A
applicableCountry

Text

退貨政策適用的國家/地區代碼,格式為兩個字母的 ISO 3166-1 alpha-2 國家/地區代碼。您最多可以指定 50 個國家/地區。

returnPolicyCategory

MerchantReturnEnumeration

退貨政策的類型。請使用下列其中一個值:

  • https://schema.org/MerchantReturnFiniteReturnWindow:產品退貨有天數限制。
  • https://schema.org/MerchantReturnNotPermitted:不允許退貨。
  • https://schema.org/MerchantReturnUnlimitedWindow:產品退貨無期限。

如果您使用 MerchantReturnFiniteReturnWindow,則必須提供 merchantReturnDays 屬性。

returnPolicyCountry

Text

退貨時必須送達的國家/地區。這個國家/地區可以與產品原先運送的國家/地區不同。ISO 3166-1 alpha-2 格式的國家/地區代碼。您最多可以指定 50 個國家/地區。

選項 B
建議屬性
customerRemorseReturnFees

ReturnFeesEnumeration

如果產品因消費者反悔而退回,特定類型的退貨費用類型。如要查看可能的值,請參閱 returnFees

customerRemorseReturnLabelSource

ReturnLabelSourceEnumeration

消費者取得產品退貨單的方法。如要查看可能的值,請參閱 returnLabelSource

customerRemorseReturnShippingFeesAmount

MonetaryAmount

消費者反悔而退回產品的運費。只有在消費者退回產品須支付非零的運費時,才需要使用這個屬性。如需詳細資訊,請參閱 returnShippingFeesAmount

itemCondition

OfferItemCondition

產品可退貨的可接受條件。您可以提供多個接受條件。請使用下列值:

  • https://schema.org/DamagedCondition:接受損壞的商品。
  • https://schema.org/NewCondition:接受新品。
  • https://schema.org/RefurbishedCondition:接受整新品。
  • https://schema.org/UsedCondition:接受二手商品。
itemDefectReturnFees

ReturnFeesEnumeration

針對瑕疵品的特定退貨費用類型。如要查看可能的值,請參閱 returnFees

itemDefectReturnLabelSource

ReturnLabelSourceEnumeration

消費者可以取得產品退貨單的方法。如要查看可能的值,請參閱 returnLabelSource

itemDefectReturnShippingFeesAmount

MonetaryAmount

因產品瑕疵而退回產品的運費。只有在消費者退回產品須支付非零的運費時,才需要使用這個屬性。如需詳細資訊,請參閱 returnShippingFeesAmount

merchantReturnDays

IntegerDateDateTime

產品退貨期限的天數 (從送達日期起算)。只有在將 returnPolicyCategory 設為 MerchantReturnFiniteReturnWindow 時,才需要這個屬性。

refundType

RefundType

消費者退回產品時可用的退款類型。

  • https://schema.org/ExchangeRefund:可兌換相同產品。
  • https://schema.org/FullRefund:可退還商品全額款項。
  • https://schema.org/StoreCreditRefund:商品可以獲得 Google 商店消費金退款。
returnFees

ReturnFeesEnumeration

退貨費用的預設類型。請使用下列其中一個支援的值:

  • https://schema.org/FreeReturn:消費者不必支付任何費用即可退回產品。如果使用這項屬性,請勿加入 returnShippingFeesAmount 屬性。
  • https://schema.org/ReturnFeesCustomerResponsibility:消費者必須自行處理並支付退貨費用。如果使用這項屬性,請勿加入 returnShippingFeesAmount 屬性。
  • https://schema.org/ReturnShippingFees:商家必須支付運費,讓消費者退回產品。請使用 returnShippingFeesAmount 屬性指定運費 (非零值)。
returnLabelSource

ReturnLabelSourceEnumeration

消費者可以取得退貨單的方法。請使用下列其中一個值:

  • https://schema.org/ReturnLabelCustomerResponsibility:消費者必須負責建立退貨單。
  • https://schema.org/ReturnLabelDownloadAndPrint:退貨單必須由消費者下載並列印。
  • https://schema.org/ReturnLabelInBox:產品出貨時就已附上退貨單。
returnMethod

ReturnMethodEnumeration

提供的退貨方式類型。建議只在 returnPolicyCategoryMerchantReturnNotPermitted 不同時才使用此屬性。請使用下列一或多個值:

  • https://schema.org/ReturnAtKiosk:商品可在資訊站退貨。
  • https://schema.org/ReturnByMail:商品可以透過郵寄方式退貨。
  • https://schema.org/ReturnInStore:商品可在商店中退貨。
returnPolicySeasonalOverride

MerchantReturnPolicySeasonalOverride

透過季節性替代政策,針對特殊活動 (例如節日) 指定退貨政策。例如,平常的退貨政策類別設為 MerchantReturnPolicyUnlimitedWindow,但在黑色星期五特賣期間,退貨期限應有限制:

"returnPolicySeasonalOverride": {
"@type": "MerchantReturnPolicySeasonalOverride",
"startDate": "2024-11-29",
"endDate": "2024-12-06",
"merchantReturnDays": "10"
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
}
returnPolicySeasonalOverride.endDate

DateDateTime

季節性替代政策的結束日期。

returnPolicySeasonalOverride.merchantReturnDays

IntegerDateDateTime

產品退貨期限的天數 (從送達日期起算)。只有在將 returnPolicyCategory 設為 MerchantReturnFiniteReturnWindow 時,才需要這個屬性。

returnPolicySeasonalOverride.returnPolicyCategory

MerchantReturnEnumeration

退貨政策的類型。請使用下列其中一個值:

  • https://schema.org/MerchantReturnFiniteReturnWindow:產品退貨有天數限制。
  • https://schema.org/MerchantReturnNotPermitted:不允許退貨。
  • https://schema.org/MerchantReturnUnlimitedWindow:產品退貨無期限。

如果您使用 MerchantReturnFiniteReturnWindow,則必須提供 merchantReturnDays 屬性。

returnPolicySeasonalOverride.startDate

DateDateTime

季節性替代政策的開始日期。

returnShippingFeesAmount

MonetaryAmount

退回產品的運費。消費者須向商家支付非零的運費,以便退回產品時,才必須提供這項屬性。在這種情況下,returnFees 必須設為 https://schema.org/ReturnShippingFeesreturnFees 必須設為 https://schema.org/FreeReturn。 如果消費者需要處理並支付退貨運費,就必須將 returnFees 設為 https://schema.org/ReturnFeesCustomerResponsibility

設定 Google 退貨設定的替代方式

零售商退貨政策可能有些複雜,而且可能會經常變動。如果您在指定退貨資料時遇到問題,或是無法順利透過標記更新退貨詳細資料,而您擁有 Google Merchant Center 帳戶,建議您在 Google Merchant Center 說明中設定退貨政策

疑難排解

如果無法順利導入結構化資料,或是偵錯時遇到困難,請參考下列資源。

  • 如果您使用內容管理系統 (CMS) 或者有他人代您處理網站事務,請向對方尋求協助。請務必將所有與問題相關的 Search Console 訊息都轉寄給對方,這些訊息會針對問題提供詳細說明。
  • Google 不保證採用結構化資料的功能一定會顯示在搜尋結果中。如要瞭解為何 Google 無法將您的內容顯示為複合式搜尋結果,請參閱結構化資料通用指南裡的常見原因清單。
  • 結構化資料可能含有錯誤。請查看結構化資料錯誤清單
  • 如果您的網頁遭到結構化資料專人介入處理處置,系統會忽略網頁上的結構化資料,但該網頁仍然會出現在 Google 搜尋結果中。請使用專人介入處理報告來修正結構化資料問題
  • 再次查看指南規範,確認您的內容是否符合規定。問題可能是因為垃圾內容或不當使用的標記所引起。不過,因為問題可能與語法無關,所以複合式搜尋結果測試無法找出問題所在。
  • 疑難排解:未出現複合式搜尋結果/複合式搜尋結果總數減少
  • 請等待一段時間,讓系統執行重新檢索和重新建立索引作業。在發布網頁後,Google 可能需要幾天時間才會找到網頁並進行檢索。如有關於檢索和索引建立作業的一般問題,請參閱 Google 搜尋檢索和索引常見問題
  • 前往 Google 搜尋中心論壇發文提問。