網站連結搜尋框 (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 應用程式，這項做法能確保搜尋結果仍然會導向您的網站。 - 根據您使用的格式，瞭解要在網頁中的什麼位置插入結構化資料。
- 遵循指南的規定。
- 使用複合式搜尋結果測試驗證程式碼。
- 驗證您的搜尋引擎實作程序，做法是從結構化資料複製
WebSite.potentialAction.target網址，並使用測試查詢取代{search_term_string}，然後在網路瀏覽器中前往該網址。 舉例來說，如果您的網站為 example.com，而您想要測試的查詢為「kittens」(小貓)，則可前往https://www.example.com/search/?q=kittens。 - 在首頁的所有變化版本上使用
rel="canonical"link 元素，藉此為網域首頁設定偏好的標準網址。這種做法有助於 Google 搜尋選擇正確的標記網址。您的伺服器必須支援 UTF-8 字元編碼。 - 如果是應用程式，請啟用適當的意圖篩選器來支援您在標記的應用程式目標中指定的網址。如要進一步瞭解如何為 Google 搜尋網址建立意圖篩選器，請參閱適用於 Android 的 Firebase 應用程式索引。
- 部署幾個包含結構化資料的網頁，並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁，且網頁並未遭到 robots.txt 檔案或
noindex標記封鎖，也未設有登入規定。如果網頁看起來沒問題，您可以要求 Google 重新檢索您的網址。 - 為了讓 Google 掌握日後的異動內容，建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。
範例
以下是「Pinterest」的 Google 搜尋結果範例，這個範例能夠傳回 Pinterest 網站的網站連結搜尋框：
下列提供幾個標記範例，示範如何使用網站自訂搜尋引擎實作網站連結搜尋框：
以下是採用 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，則搜尋框會傳送該意圖。 您必須建立網站
網站範例 下列範例會將 GET 要求傳送至
"potentialAction": [{
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://query.example.com/search?q={search_term_string}"
}
"query-input": "required name=search_term_string"
}]
應用程式範例 下列範例會將 Android 意圖傳送至
"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
|
使用
"potentialAction": [{
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://query.example.com/search?q={search-term}"
}
"query-input": "required name=search-term"
}]
|
||||
potentialAction.target
|
含有
例如： https://query.example.com/search?q={search_term_string}
|
||||
url
|
把提供外界搜尋的網站網址設定為您網站的標準首頁。例如： |
||||
透過 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 搜尋中心論壇發文提問。