只要為網頁加入結構化資料,即可啟用 Google 搜尋結果的特殊功能,並可用複合式搜尋結果測試加以檢驗。
執行測試
測試網址
提交網頁的完整網址即可測試。重要資訊:你必須允許匿名使用者從網際網路存取程式碼,瀏覽你的所有網頁資源。如果有任何資源受到防火牆或密碼保護,則無法測試該資源。如果你的網頁設有防火牆或由本機電腦代管,可透過開放通道來進行測試。
測試程式碼片段
你可以使用這項工具測試任何程式碼片段。只要在工具到達網頁中選擇「程式碼」(而不是測試網址),再將需要測試的程式碼貼上即可。如果有需要,你也隨時可以修改程式碼,然後點選「執行測試」重新測試。
視需要選擇使用者代理程式
你可以選擇要使用何種使用者代理程式來測試網頁,也就是選擇用智慧型手機或電腦來測試你的網頁。請在輸入網址或程式碼的文字方塊下方,從清單中選擇使用者代理程式。
為因應有越來越多使用者透過行動裝置存取網頁,Google 推出行動版內容優先索引計畫,因此預設的使用者代理程式為智慧型手機。如果你的網站已導入行動版內容優先索引系統,除非基於其他因素需要使用桌機使用者代理程式,否則建議使用智慧型手機使用者代理程式進行測試。由於現在大部分使用者都是透過行動裝置瀏覽網頁,我們建議所有網站都使用行動裝置使用者代理程式。
如要確認你的網站是否已導入行動版內容優先索引系統,請前往你的資源設定頁面。
支援的結構化資料格式
複合式搜尋結果測試支援採用 JSON-LD、RDFa 和微資料格式的結構化資料
查看結果
測試工具會顯示在網頁上找到的複合式搜尋結果類型,以及結構化資料錯誤或相關建議。
如果發現錯誤或警告內容,可以展開個別項目查看詳細資料,然後按一下說明以在對應位置開啟程式碼瀏覽器。瀏覽器會使用轉譯後的原始碼。
測試結果涵蓋以下方面:
網址狀態
這項工具可以回報測試網址的下列狀態值,其中「N」值取決於找到的項目數量。
- 偵測到 N 個有效的項目
- 未偵測到任何項目
- 偵測到 N 個有效的項目但出現警告
- 偵測到 N 個有效的項目:全都出現警告
- 偵測到 N 個有效的項目:部分出現警告
- 偵測到 N 個項目:部分無效
- 偵測到 N 個無效的項目
- 無法檢索網址
- 偵測到含有語法錯誤的結構化資料
檢索
這個部分會說明 Google 是否能檢索該網頁。如果 Google 無法在常規檢索週期內檢索該網頁 (例如受到 robots.txt 規則或 noindex 指令禁止檢索),代表該網頁無法利用這項工具進行測試。
- 檢索成功/檢索失敗:
- 檢索代理程式:顯示用於檢索的使用者代理程式類型 (智慧型手機或電腦)
- 是否允許檢索?測試網站上的 robots.txt 規則是否禁止 Google 檢索該網頁。
- 網頁擷取:測試是否能擷取該網頁。如果檢索失敗,測試就一律無法擷取網頁。
偵測到的項目/結構化資料
顯示是否在網頁上找到任何結構化資料項目。如果測試工具無法剖析找到的結構化資料,便會在這裡指明。這裡會列出測試工具找到的所有項目 (無論是否良好、存在警告/錯誤或無法剖析),並顯示個別項目的說明和任何問題。
錯誤
如果這項工具因故無法存取網頁,系統會顯示下列其中一項錯誤:
- DNS 伺服器沒有回應:通常這是暫時性問題,會在幾分鐘內自行解決。
- DNS 錯誤:未知的主機:你的 DNS 伺服器無法解析網址。這可能是暫時性問題,會在幾分鐘內自行解決。
- DNS 錯誤:提供的是私人 IP:DNS 傳回的 IP 位於特殊/私人的排除範圍,像是 RFC 1918 私人 IP (例如 10.0.0.1)。
- 伺服器連線錯誤:伺服器無法連上、拒絕連線或連線失敗。瞭解詳情。
- 伺服器傳回無效回應:伺服器不支援所要求的通訊協定,因為回應或標頭遭到截斷,或是系統無法剖析回應 (例如回應資料壓縮方式錯誤)。瞭解詳情。
- 無效的伺服器安全資料傳輸層 (SSL) 憑證:網站的 SSL 憑證無效。除非憑證有效,否則 Google 不會測試網站上的 HTTPS 網址。
- 無法存取 robots.txt:如果 robots.txt 檔案存在,但無法連上,Google 將不會檢索該網站。你可以在檢索統計資料報表中查看 robots.txt 可用性。
- 超出主機負載:你的網站似乎已達到 Google 檢索或檢查要求的負載量上限。流量負荷 (由 Google 預估) 降低前,Google 無法執行測試。
如果測試工具無法載入網頁使用的所有「資源」,系統會顯示警告訊息。這裡的資源指的是網頁中所包含的外部元素,例如圖片、CSS 或指令碼檔案。這項測試只會嘗試載入特定類型的資源,並忽略其他不影響測試的資源。
造成載入問題的可能原因如下:
- 無法在合理的時間內載入資源。在這種情況下,請嘗試再執行一次測試。如果還是發生同樣的問題,你可以考慮改由別處代管資源,或是嘗試找出相關主機沒有回應或運作緩慢的原因,並設法解決。
- 資源未出現在指定位置 (404 錯誤)。確認並修正網頁上的資源網址。
- 未登入的使用者無法存取資源。由於測試工具是以匿名使用者身分存取網頁,因此,請確保匿名使用者可以存取該網頁的所有資源。
- Robots.txt 檔案禁止 Googlebot 存取資源。如果牽涉到的是重要資源 (詳見下文),且資源位於自家網站上,建議你解除封鎖,允許 Googlebot 存取。如果是其他網站上的資源,建議你與該網站的管理員聯絡,請對方解除封鎖。
解除封鎖重要資源
如果遭到封鎖的是重要資源,可能會嚴重影響 Google 對該頁面的解讀。舉例來說,如果有一張大型圖片遭到封鎖,儘管頁面看似適合透過行動裝置瀏覽,實際上卻可能不是如此。如果遭到封鎖的是 CSS 檔案,則可能會導致網頁套用不正確的字型樣式 (例如字體太小,不適合在行動裝置上閱讀)。這會影響 Google 檢索網頁的能力,進而可能影響你的網頁在 Google 搜尋結果中的狀態。因此你必須確保 robots.txt 檔案不會禁止 Googlebot 存取重要資源,並允許一般使用者存取重要資源。
測試結果不一致/網頁載入問題
當部分資源無法載入或發生其他網頁載入問題時,個別測試結果可能會有些微差異。這是因為每次執行測試的過程中,載入的資源組合可能有所不同。在沒有進行任何變更的情況下,如果每次執行測試的網頁轉譯結果都不同,請檢查系統是否顯示「網頁載入問題」警告。如有,請點選警告,進一步瞭解什麼原因導致網頁無法一致且正確地轉譯。
錯誤類型 | 說明 |
---|---|
JSON 文件無效 | JSON 含有頂層語法錯誤。 |
值類型不正確 | 該欄位指定了錯誤類型的值。比如,在需要指定數值或陣列的地方指定字串。如要瞭解特定欄位需要何種類型的值,請參閱結構化資料說明文件。 |
剖析錯誤:缺少「:」 | 欄位和值之間缺少「:」標記。 |
剖析錯誤:缺少「,」或「}」 | 缺少半形逗號或右大括號。 |
剖析錯誤:缺少「}」或物件成員名稱 |
缺少右大括號或物件成員名稱。 |
剖析錯誤:陣列宣告中缺少「,」或「]」 | 剖析陣列值時發生錯誤:陣列宣告中缺少半形逗號或右方括號。 |
無法剖析權杖長度 | 因為某些原因而找不到資源或值的開頭和結尾。 |
數值無效 | 在資源值必須為數值的情況下使用了其他類型的值。 |
字串中的逸出序列空白 |
字串值中包含空白的逸出序列字元,例如:
而非
|
字串中的逸出序列無效 |
字串值中使用了無效的逸出序列,例如: "description" : "Some \q unknown sequence" |
Unicode 字元遭截斷 | Unicode Surrogate 字組缺少末尾 6 個字元。 |
Unicode 字元無效 | Unicode Surrogate 字組後半部的開頭缺少 \u 憑證。 |
Unicode 逸出序列無效:必須是四位數字 | Unicode 逸出序列出現語法錯誤:必須是四位數字。 |
Unicode 逸出序列無效:必須是十六進位數字 | Unicode 逸出序列出現語法錯誤:並未按規則提供十六進位數字。 |
有不應重複的資源 | 為結構化資料物件中的專屬資源提供兩組定義,例如兩個 @context 值。 |
頂層元素無效 | JSON-LD 中的頂層項目無效。 |
參照項目不存在 | itemref 屬性指向不存在的 ID。 |
支援的複合式搜尋結果類型
這項測試工具目前支援下列複合式搜尋結果類型︰
支援的類型
儲存測試記錄
每次執行測試,Search Console 都會儲存你的程式碼和測試狀態。如要保存你的程式碼和測試記錄,請在測試完畢後為該網頁網址加上書籤,測試記錄會保留約 90 天。請注意,任何人都可以存取這些加上書籤的網頁。
分享測試結果
點選「分享」按鈕即可將測試結果瀏覽器連結與任何人分享,對方不需要任何權限就能直接查看結果。測試結果連結的效期約 90 天。
查看網頁在 Google 搜尋結果中的實際顯示情形
你可以預覽部分複合式搜尋結果類型在 Google 搜尋結果或 Google 助理中的顯示情形。如果你的網頁適用多種搜尋結果版面配置,則可使用這項工具提供的選取器查看不同的版面配置 (包括電腦版和行動版搜尋結果的版面配置)。
如要測試你的網頁搭配不同版面配置的效果,只要修改程式碼再重新執行測試,即可產生新的版面配置。此外,你也可以將瀏覽器中的網址與其他使用者分享,讓對方能夠查看顯示結果。
你可以根據工具在網頁上找到的內容,選擇要查看的搜尋結果類型並選取電腦或行動裝置版本。
Google 並不保證網頁的實際顯示情形與預覽結果完全相同,也不保證任何檢視畫面會套用至你的網頁結果;Google 會根據使用者的搜尋記錄、所在位置和許多其他變數,盡可能顯示最符合搜尋要求的結果。
其他結構化資料資源
以下是一些結構化資料和 Google 搜尋結果功能的相關資源︰
- 結構化資料庫介紹了 Google 搜尋支援的搜尋結果功能。
- Google 結構化資料總覽可供網頁開發人員掌握這些功能。