只要為網頁加入結構化資料,即可啟用 Google 搜尋結果的特殊功能,並可用複合式搜尋結果測試加以檢驗。
執行測試
測試網址
提交網頁的完整網址即可測試。重要資訊:您必須允許匿名使用者從網際網路存取程式碼,瀏覽您的所有網頁資源。如果有任何資源受到防火牆或密碼保護,則無法進行測試。如果您的網頁設有防火牆或由本機電腦代管,可透過開放通道來進行測試。
測試程式碼片段
您可以使用這項工具測試任何程式碼片段。只要在工具到達網頁中選擇 [程式碼] (而不是測試網址),再將需要測試的程式碼貼上即可。如果有需要,您也隨時可以修改程式碼,然後點選 [執行測試] 重新測試。
視需要選擇使用者代理程式
您可以選擇要使用何種使用者代理程式來測試網頁,也就是選擇用智慧型手機或電腦來測試您的網頁。請在輸入網址或程式碼的文字方塊下方,從清單中選擇使用者代理程式。
為因應有越來越多使用者透過行動裝置存取網頁,Google 推出行動版內容優先索引計畫,因此預設的使用者代理程式為智慧型手機。如果您的網站已導入行動版內容優先索引系統,除非您基於其他因素需要使用桌機使用者代理程式,否則建議您使用智慧型手機使用者代理程式進行測試。由於現在大部分使用者都是透過行動裝置瀏覽網頁,我們建議所有網站都使用行動裝置使用者代理程式。
如要確認你的網站是否已導入行動版內容優先索引系統,請前往你的資源設定頁面。
支援的結構化資料格式
複合式搜尋結果測試支援採用 JSON-LD、RDFa 和微資料格式的結構化資料
查看結果
測試工具會顯示在網頁上找到的複合式搜尋結果類型,以及結構化資料錯誤或相關建議。
如果發現錯誤或警告內容,可以展開個別項目查看詳細資料,然後按一下說明以在對應位置開啟程式碼瀏覽器。瀏覽器會使用轉譯後的原始碼。
測試結果涵蓋以下方面:
網址狀態
這項工具可以回報測試網址的下列狀態值,其中「N」值取決於找到的項目數量。
偵測到 N 個有效的項目
未偵測到任何項目
偵測到 N 個有效的項目但出現警告
偵測到 N 個有效的項目:全都出現警告
偵測到 N 個有效的項目:部分出現警告
偵測到 N 個項目:部分無效
偵測到 N 個無效的項目
無法檢索網址
偵測到含有語法錯誤的結構化資料
檢索
這個部分會說明 Google 是否能檢索該網頁。如果 Google 無法在常規檢索週期內檢索該網頁 (例如受到 robots.txt 規則或 noindex 指令禁止檢索),代表該網頁無法利用這項工具進行測試。
- 檢索成功/檢索失敗:
- 檢索代理程式:顯示用於檢索的使用者代理程式類型 (智慧型手機或電腦)
- 是否允許檢索:測試網站上的 robots.txt 規則是否禁止 Google 檢索該網頁。
- 網頁擷取:測試是否能擷取該網頁。如果檢索失敗,測試就一律無法擷取網頁。
偵測到的項目/結構化資料
顯示是否在網頁上找到任何結構化資料項目。如果測試工具無法剖析找到的結構化資料,便會在這裡指明。這裡會列出測試工具找到的所有項目 (無論是否良好、存在警告/錯誤或無法剖析),並顯示個別項目的說明和任何問題。
如果測試工具因為某些原因無法存取該網頁,就會顯示錯誤訊息說明問題。網路連線問題或網站掛掉都可能導致測試工具無法存取網頁。
如果測試工具無法載入網頁採用的特定資源,就會顯示警告訊息。資源指的是網頁所包含的外部元素,例如 JavaScript 檔案。複合式搜尋結果測試只會嘗試載入特定類型的資源,並忽略其他不影響測試的資源。
以下是一些資源載入問題的常見原因:
- 資源未在合理的時間內完成載入。在這種情況下,請嘗試再執行一次測試。如果還是發生同樣的問題,您可以考慮改由別處代管資源,或是嘗試找出主機沒有回應的原因,並設法解決。
- 資源未出現在指定網址中 (404 錯誤)。請修正資源網址。
- 未登入的使用者無法存取資源。由於測試工具是以匿名使用者身分存取網頁,因此,請確保匿名使用者可以存取該網頁的所有資源。
- Robots.txt 檔案禁止 Googlebot 存取資源。如果牽涉到的是重要資源 (如下所示),而且是屬於您自己網站上的資源,建議您解除封鎖這些資源,讓 Googlebot 能順利存取。如果是屬於其他網站上的資源,建議您與該網站的管理員聯絡,請對方解除封鎖。
解除封鎖重要資源
如果遭到封鎖的是重要資源,可能會嚴重影響 Google 對該頁面的解讀。舉例來說,如果無法存取產生網頁 DOM 的 JavaScript,就可能導致問題發生。請確保 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 結構化資料總覽可供網頁開發人員掌握這些功能。