網站連結搜尋框 (`WebSite`) 結構化資料

「網站連結搜尋框」可讓使用者在搜尋結果網頁上立即搜尋您的網站或應用程式，快速找出需要的內容。搜尋框會提供即時建議和其他功能。

當您的網站顯示在搜尋結果中時，Google 搜尋就可能會自動顯示以您的網站為搜尋範圍的搜尋框，完全不需要您另外採取任何行動。此搜尋框採用 Google 搜尋技術，不過您也可以新增 WebSite 結構化資料以明確提供資訊，讓 Google 進一步瞭解您的網站。

如果 Google 搜尋已經為您的網站顯示網站連結搜尋框，您就可以透過新增 WebSite 結構化資料，控管網站連結搜尋框的某些部分。

如何導入網站連結搜尋框

如果想讓您的網站符合在 Google 搜尋結果中顯示搜尋框的條件，請按照下列步驟進行：

在您的網站或 Android 應用程式上安裝有效的搜尋引擎。
網站連結搜尋查詢會將使用者導向網站或應用程式的搜尋結果頁面，因此您必須具備運作中的搜尋引擎才能啟動此功能。
- 網站：在網站上設定搜尋引擎。此功能會使用結構化資料中指定的語法，將使用者的查詢轉送至您的目標。您的搜尋引擎必須支援 UTF-8 編碼查詢。
- 應用程式：請參閱 Android 開發人員網站上的搜尋總覽，瞭解如何為應用程式實作搜尋引擎。您的 Android 應用程式必須支援來自搜尋結果的 ACTION_VIEW 意圖，並在標記的 potentialAction.target 屬性中指定對應的資料 URI。
在網站的首頁實作 WebSite 結構化資料元素。應用程式必須具備相關聯網站才能啟用此功能，即使網站只有一個網頁也可以。下面列出幾項額外的規範：
- 這個標記只能在首頁新增，不能在其他頁面新增。
- 如果您已經實作 WebSite 結構化資料來提供網站名稱功能，請務必在同一個節點中建立網站名稱屬性的巢狀結構。也就是說，如果可以，請避免在首頁上建立額外的 WebSite 結構化資料區塊。
- 一定要為網站指定 SearchAction，如果也支援應用程式搜尋，可以再指定另一個，但後者屬於選用性質。即便應用程式是您比較偏好的搜尋目標，也還是必須為網站指定 SearchAction；因為這樣一來，如果使用者不是從 Android 手機進行搜尋，或是並未安裝您的 Android 應用程式，這項做法能確保搜尋結果仍然會導向您的網站。
- 根據您使用的格式，瞭解要在網頁中的什麼位置插入結構化資料。
如果您是使用 CMS，請使用已整合到 CMS 的外掛程式，這會是比較簡單的做法。
如果您是使用 JavaScript，請瞭解如何使用 JavaScript 產生結構化資料。
遵循指南的規定。
使用複合式搜尋結果測試驗證程式碼。
驗證您的搜尋引擎實作程序，做法是從結構化資料複製 WebSite.potentialAction.target 網址，並使用測試查詢取代 {search_term_string}，然後在網路瀏覽器中前往該網址。舉例來說，如果您的網站為 example.com，而您想要測試的查詢為「kittens」(小貓)，則可前往 https://www.example.com/search/?q=kittens。
注意：在本文件中，我們都使用 q 做為 {search_term_string} 的網址參數鍵，但這個網址參數鍵其實可以是網址查詢元件中受 RFC 3986 語法允許的任何字串。如果您想使用 cheesey_query={search_term_string}，也沒關係。
在首頁的所有變化版本上使用 rel="canonical" link 元素，藉此為網域首頁設定偏好的標準網址。這種做法有助於 Google 搜尋選擇正確的標記網址。您的伺服器必須支援 UTF-8 字元編碼。
如果是應用程式，請啟用適當的意圖篩選器來支援您在標記的應用程式目標中指定的網址。如要進一步瞭解如何為 Google 搜尋網址建立意圖篩選器，請參閱適用於 Android 的 Firebase 應用程式索引。
部署幾個包含結構化資料的網頁，並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁，且網頁並未遭到 robots.txt 檔案或 noindex 標記封鎖，也未設有登入規定。如果網頁看起來沒問題，您可以要求 Google 重新檢索您的網址。
注意：請等待一段時間，讓系統重新檢索和重新建立索引。在您發布網頁後，Google 可能需要幾天時間才會找到並檢索您的網頁。
為了讓 Google 掌握日後的異動內容，建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。

範例

以下是「Pinterest」的 Google 搜尋結果範例，這個範例能夠傳回 Pinterest 網站的網站連結搜尋框：

下列提供幾個標記範例，示範如何使用網站自訂搜尋引擎實作網站連結搜尋框：

JSON-LD

以下是採用 JSON-LD 格式的範例：

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

微資料

以下是採用微資料格式的範例：

<div itemscope itemtype="https://schema.org/WebSite">
  <meta itemprop="url" content="https://www.example.com/"/>
  <form itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction">
    <meta itemprop="target" content="https://query.example.com/search?q={search_term_string}"/>
    <input itemprop="query-input" type="text" name="search_term_string" required/>
    <input type="submit"/>
  </form>
</div>

以下是採用 JSON-LD 格式的網站和應用程式範例：

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": [{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      },{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

指南規範

您必須遵守下列規範，才能以複合式搜尋結果的形式顯示您的網站。

即使網站並未包含此處說明的結構化資料，Google 搜尋仍可自行在網站的搜尋結果中加入網站連結搜尋框。不過，您可以在首頁新增下列 meta 標記，避免這個現象發生：

<meta name="google" content="nositelinkssearchbox">

結構化資料類型定義

如要讓您的內容符合網站連結搜尋框的顯示資格，請加入必要屬性。

經過修改的 `WebSite` 類型

Google 搜尋會同時針對網站和應用程式搜尋框使用修改後的 WebSite 結構化資料類型。雖然 Google 搜尋的標準與 schema.org 略有不同，您仍可前往該網站查看 WebSite 的完整定義。Google 支援的屬性如下：

必要屬性

potentialAction

一或兩個 SearchAction 物件的陣列

此物件會說明傳送查詢的目的地 URI，以及所傳送要求的語法。您必須實作可接收要求的網頁或意圖處理常式，並且對提交的字串執行適當的搜尋。如果使用者並非位於 Android 應用程式 (或是在 Android 應用程式，但並未指定 Android 意圖目標)，搜尋框就會將查詢的網站版本傳送至指定的位置；如果使用者位於 Android 裝置且已指定 Android 意圖 URI，則搜尋框會傳送該意圖。

您必須建立網站 SearchAction 以啟用桌面搜尋案例。如果同時支援應用程式搜尋，您便可另外為應用程式指定 SearchAction 物件。每個 SearchAction 都必須含有下列巢狀屬性：

potentialAction.@type
potentialAction.target
potentialAction.query-input

網站範例

下列範例會將 GET 要求傳送至 https://query.example.com/search?q=user%20search%20string。

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "https://query.example.com/search?q={search_term_string}"
  },
  "query-input": "required name=search_term_string"
}]

應用程式範例

下列範例會將 Android 意圖傳送至 android-app://com.example/https/query.example.com/search/?q=user_search_string。

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}"
  },
  "query-input": "required name=search_term_string"
}]

potentialAction.query-input

Text

使用 required name = search-term 文字字串，或是您在 target 中使用的任何預留位置。請確認這兩個預留位置值相符，例如 target 和 query-input 屬性中的預留位置值都使用 search-term 字串：

"potentialAction": [{
  "@type": "SearchAction",
  "target": {
    "@type": "EntryPoint",
    "urlTemplate": "https://query.example.com/search?q={search-term}"
  },
  "query-input": "required name=search-term"
}]

query-input 是加註的屬性。詳情請參閱 Potential Actions 頁面。

potentialAction.target

EntryPoint

含有 urlTemplate 屬性的 EntryPoint 物件。

urlTemplate 必須為下列格式的字串：search_handler_uri{search_term_string}

例如：

https://query.example.com/search?q={search_term_string}

`search_handler_uri`	如果是網站，即為接收和處理搜尋查詢的處理常式網址；如果是應用程式，即為處理查詢的搜尋引擎意圖處理常式 URI。
`search_term_string`	這是預留位置字串，只要使用者在搜尋框中點選「搜尋」按鈕，本身發出的搜尋查詢就會取代這個字串。請確認在此使用的預留位置字串符合 `query-input` 屬性的 `name` 元素值。

Google 也支援此屬性的簡短格式，您可以直接在 potentialAction.target 中提供 Text，而 Google 會將其展開為 urlTemplate。例如：

"potentialAction": [{
  "@type": "SearchAction",
  "target": "android-app://com.example/https/query.example.com/search/?q={search_term_string}",
  "query-input": "required name=search_term_string"
}]

不過這並非標準格式，Google 主要是基於微資料的便利性而支援該格式。為獲得最佳結果，請加入完整的 EntryPoint 物件。

url

URL

把提供外界搜尋的網站網址設定為您網站的標準首頁。例如：https://www.example.org

透過 Search Console 監控複合式搜尋結果

Search Console 這項工具能協助您監控網頁在 Google 搜尋中的成效。 Google 會主動將您的網頁納入搜尋結果，您無需為此申請使用 Search Console，但是您可以藉由這項服務瞭解並改善 Google 檢索您網站的方式。建議在下列情況查看 Search Console：

首次部署結構化資料後
發布新範本或更新程式碼後
定期分析流量

首次部署結構化資料後

在 Google 為網頁建立索引後，請透過相關的複合式搜尋結果狀態報告查看是否存在任何問題。理想情況下，有效項目會增加，但無效項目不會變多。如果您在結構化資料中發現問題，請依下列步驟操作：

修正無效項目。
檢查線上網址，查看問題是否仍繼續發生。
透過狀態報告要求驗證。

發布新範本或更新程式碼後

當您對網站進行大幅變更時，請留意結構化資料中無效項目是否增加。

如果無效項目增加，代表您推出的新範本可能無法正常運作，或者您的網站採用新方式與現有範本互動，但效果不佳。
如果有效項目減少，但錯誤並未隨之增加，代表您的網頁可能已不再內嵌結構化資料。請使用網址檢查工具找出問題的成因。

定期分析流量

透過成效報表分析您的 Google 搜尋流量。這些資料會顯示您的網頁在 Google 搜尋中呈現為複合式搜尋結果的頻率、使用者點擊的頻率，以及您的搜尋結果平均排名。您也可以使用 Search Console API 自動提取這些結果。

疑難排解

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

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