這份報告會列出你網站中因含有嚴重語法錯誤而無法剖析的結構化資料。如果有剖析錯誤,就會導致系統無法判斷預定的結構化資料類型 (工作、活動等)。
報告使用方式
這份報告列出的都是結構化資料錯誤,沒有警告或無效項目。
系統會根據受影響的網頁數量等因素來判定錯誤的嚴重程度,自動依序列出錯誤項目。
會影響到多個網頁的錯誤多半是由基本的範本錯誤造成。
- 按一下錯誤資料列,即可查看受影響的網頁、錯誤詳細資料和偵錯工具連結。下表列有各類型錯誤的完整說明。
- 使用複合式搜尋結果測試,修正及測試結構化資料的語法。如果無法順利查找錯誤,請嘗試從空物件開始測試,然後逐一加回問題程式碼片段中的內容,直到找出錯誤。請參閱結構化資料說明文件,進一步瞭解特定類型的資料,從而修正特定結果的錯誤。
- 修正問題後,請按一下錯誤詳細資料頁面中的「驗證修正後的項目」。
請注意,在你修正剖析錯誤後,報告中可能會列出新的警告或錯誤,這是因為系統已能剖析一些原來無法剖析的項目。
錯誤類型
這份報告涵蓋下列幾種錯誤類型。
錯誤類型 | 說明 |
---|---|
JSON 文件無效 | JSON 含有頂層語法錯誤。 |
值類型不正確 | 該欄位指定了錯誤類型的值。比如,在需要指定數值或陣列的地方指定字串。如要瞭解特定欄位需要何種類型的值,請參閱結構化資料說明文件。 |
剖析錯誤:缺少「:」 | 欄位和值之間缺少「:」標記。 |
剖析錯誤:缺少「,」或「}」 | 缺少半形逗號或右大括號。 |
剖析錯誤:缺少「}」或物件成員名稱 |
缺少右大括號或物件成員名稱。 |
剖析錯誤:陣列宣告中缺少「,」或「]」 | 剖析陣列值時發生錯誤:陣列宣告中缺少半形逗號或右方括號。 |
無法剖析權杖長度 | 因為某些原因而找不到資源或值的開頭和結尾。 |
數值無效 | 在資源值必須為數值的情況下使用了其他類型的值。 |
字串中的逸出序列空白 |
字串值中包含空白的逸出序列字元,例如:
而非
|
字串中的逸出序列無效 |
字串值中使用了無效的逸出序列,例如: "description" : "Some \q unknown sequence" |
Unicode 字元遭截斷 | Unicode Surrogate 字組缺少末尾 6 個字元。 |
Unicode 字元無效 | Unicode Surrogate 字組後半部的開頭缺少 \u 憑證。 |
Unicode 逸出序列無效:必須是四位數字 | Unicode 逸出序列出現語法錯誤:必須是四位數字。 |
Unicode 逸出序列無效:必須是十六進位數字 | Unicode 逸出序列出現語法錯誤:並未按規則提供十六進位數字。 |
有不應重複的資源 | 為結構化資料物件中的專屬資源提供兩組定義,例如兩個 @context 值。 |
頂層元素無效 | JSON-LD 中的頂層項目無效。 |
參照項目不存在 | itemref 屬性指向不存在的 ID。 |
問題詳細資料頁面
只要選取複合式搜尋結果摘要頁面中的問題列,即可查看該問題的詳細資料頁面。個別問題的影響範圍可能遍及好幾個網頁,也可能只有某個網頁上的複數項目受到影響。
問題詳細資料頁面包含下列資訊:
- 狀態
- 這個問題的驗證狀態。
- 首次偵測到的日期
- 系統首次在你的網站上偵測到這個問題的日期。如果這個類型的所有問題都已解決,但在最後一個個案修正之後的 90 天內又出現了相同問題的新個案,則這裡顯示的會是原本的首次偵測日期,而非系統偵測到新個案的日期。
- 示例
- 受這個問題影響的複合式搜尋結果清單。這份清單可能因故而無法列出你的網站上與這個問題相關的所有例項,例如:有的例項是在系統上次檢索你的網站後才出現的,或是問題總共影響超過 1,000 個項目。
- 上次檢索時間
- 上次系統檢索到網頁含有這個問題的時間。
為什麼要驗證
告訴 Google 你已修正特定問題狀態或類別中的所有問題,將帶來下列好處:
- 無論是 Google 確認所有網址都已修正,或是發現仍有未修正的例項,系統都會傳送電子郵件通知你。
- 你可以追蹤 Google 確認修正情況的進度、查看已排入佇列等待檢查的所有網頁的記錄,以及每個網址的修正狀態。
有時網站上的特定問題並不需要修正及驗證,例如 robots.txt 封鎖的網址可能是刻意設定的。請根據你的判斷,決定是否要解決特定問題。
你也可以在不驗證的情況下修正問題;無論你是否明確要求進行修正驗證,Google 每次檢索含有已知問題的網頁時,都會更新例項數量。
開始驗證
如要告訴 Search Console 你已修正某個問題,請按照下列步驟操作:
- 修正網站上的所有問題例項。如果遺漏了某個問題,只要 Google 發現該問題還有一個例項未修正,驗證作業就會停止。
- 開啟你所修正問題的詳細資料頁面。在報表的問題清單中按一下該問題。
- ⚠️ 如果你在報表中篩選出特定 Sitemap,驗證對象只限於提出驗證要求時 Sitemap 中的項目。請留意這是不是你想要的效果。
- 按一下「驗證修正後的項目」。除非驗證已成功或已失敗,否則請勿再次點選「驗證修正後的項目」。進一步瞭解 Google 如何檢查修正結果。
- 你可以監控驗證進度。驗證作業通常會在兩週內完成,但有時可能需要更久,請耐心等候。驗證完成後,無論成功或失敗,系統都會發送通知。
- 如果驗證失敗,你可以按一下問題詳細資料頁面中的「查看詳細資料」,查看導致驗證失敗的網址。請修正這個頁面、確認所有網址的修正內容處於「待處理」狀態,然後重新開始驗證。
在什麼情況下,特定網址或項目的問題會視為「已修正」?
滿足下列「其中一項」條件時,我們就會將特定網址或項目的問題標示為已修正:
- 網址經過檢索後,在網頁上已找不到該問題。如果是 AMP 代碼錯誤,這可能表示你修正了相關代碼,或是相關代碼已移除 (如果是非必要的代碼)。在驗證程序期間,系統會加上「通過」標籤。
- 如果 Google 因故無法存取特定網頁 (網頁遭到移除、標示了 noindex 或需要驗證等),則會將該網址的問題視為已修正。在驗證程序期間,這種情況會分類至「其他」驗證狀態。
問題生命週期
問題的「生命週期」會從我們在你網站上首次偵測到該問題的例項時起算,直到你網站上最後一個例項標示為已修正後的 90 天為止。如果該問題在這 90 天內沒有再次出現,就會從問題表格中移除。
問題的「首次偵測日期」是指在問題的生命週期中,我們第一次偵測到該問題當天的日期,這個日期不會變更。因此:
- 如果問題的所有例項均已修正,但 15 天後出現新例項,我們會將問題狀態標示為未解決,首次偵測到的日期則維持不變。
- 如果同一個問題在最後一個例項修正 91 天之後出現,由於先前的問題已結案,因此會記錄為新問題,首次偵測到的日期則是新偵測到的日期。
針對特定問題點選「驗證修正後的項目」後,驗證程序大致如以下所述。這項程序可能要花上好幾天或更久,系統會透過電子郵件通知驗證進度。
- 點選「驗證修正後的項目」後,Search Console 會立即檢查一些網頁。
- 如果仍有網頁包含目前的例項,驗證程序就會結束,驗證狀態將維持不變。
- 如果取樣網頁不含目前的錯誤,系統會繼續進行驗證,程序狀態為「已開始」。如果在驗證過程中找到其他不相關的問題,系統會將這些問題計入其他問題類型,並繼續進行驗證。
- Search Console 會檢驗受到這個問題影響的已知網址清單。我們只會逐一重新檢索含已知問題例項的網址,而不會重新檢索整個網站。Search Console 會在驗證記錄中記載所有檢查過的網址,你可以透過問題詳細資料頁面查看。
- 網址經過檢查後:
- 如果找不到問題,例項驗證狀態將變更為「通過」。如果這是開始進行驗證後所檢查的第一個例項,問題驗證狀態將變更為「沒有問題」。
- 如果網址已無法存取,例項驗證狀態將變更為「其他」(非錯誤狀態)。
- 如果例項仍存在,問題狀態將變更為「失敗」並結束驗證。如果這是由一般檢索程序找到的新網頁,系統會將其視為這個現有問題的其他例項。
- 如果檢查過佇列中的網址後,發現這個問題已經修正,問題狀態就會變更為「通過」。不過,即使所有的例項都已經修正,問題嚴重性標籤也不會變更 (「錯誤」或「警告」),只有受影響的項目數量會改變 (0)。
即使未點選「開始驗證」,Google 仍可偵測到問題例項已修正。如果 Google 在執行一般檢索作業期間偵測到問題的所有例項均已修正,則會將報表中的問題數量變更為「0」。
⚠️ 建議你在驗證程序結束後再提出另一項驗證要求,即使你在目前的程序期間修正了一些問題亦然。
如果驗證失敗後要重新驗證,請按照下列步驟操作:
- 前往驗證失敗的驗證記錄:開啟驗證失敗的問題詳細資料頁面,然後按一下「查看詳細資料」。
- 按一下「要求重新驗證」。
- 系統就會重新驗證所有標示為「待處理」或「失敗」的網址,以及自上次嘗試驗證後,一般檢索作業發現的同一問題的新例項。標示為「通過」或「其他」的網址不會重新檢查。
- 驗證作業通常會在兩週內完成,但有時可能需要更久,請耐心等候。
查看驗證進度
如何查看目前驗證要求的處理進度 (如果驗證作業尚未進行,則查看最後一個要求的記錄):
- 開啟該問題的問題詳細資料頁面。按一下主要報表頁面上的問題列,即可開啟問題詳細資料頁面。
- 驗證要求狀態會同時顯示在問題詳細資料頁面,以及「詳細資料」表格的「驗證」列中。
- 按一下「查看詳細資料」,開啟該要求的驗證詳細資料頁面。
- 表格中會顯示要求中各網址的例項狀態。
- 例項狀態適用於你正在檢視的特定問題。頁面上可以有一個問題標示為「通過」,而同一頁面的其他問題則標示為「失敗」、「待處理」或「其他」。
- 在 AMP 報表和網頁索引報表中,驗證記錄頁面中的項目會按照網址分組。
- 在複合式搜尋結果報表中,系統則會同時以網址和結構化資料項目 (由項目的 Name 值判定) 為依據,將項目分組。
特定問題的驗證作業可能伴隨的驗證狀態如下:
- 未開始:這個問題有一或多個例項從未納入這個問題的驗證要求中。
後續步驟:- 點閱問題,瞭解相關錯誤的詳情。檢查個別網頁,確認實際網頁所含的錯誤示例。
- 按一下詳細資料頁面上的「瞭解詳情」,即可查看問題的詳細資料。
- 點選表格中的示例網址列,進一步瞭解該特定錯誤。
- 修正網頁後,按一下「驗證修正後的項目」即可開始驗證。驗證作業通常會在兩週內完成,但有時可能需要更久,請耐心等候。
- 已開始:你已要求驗證,而我們目前還沒找到其他問題例項。
後續步驟:Google 會繼續進行驗證,必要時會透過通知給予進一步指示。 - 沒有問題:已開始進行驗證,且目前檢查過的所有問題例項均已修正。
後續步驟:你無須採取行動,但 Google 會繼續進行驗證,並透過通知給予進一步指示。 - 通過:問題的所有已知例項均已不存在 (或是受影響的網址已無法存取)。你必須點選「驗證修正後的項目」,網址才有可能變成這個狀態。如果例項是在你未要求驗證的情況下消失,狀態會變更為「不適用」。
後續步驟:無須採取其他行動。 - 不適用:雖然你未要求驗證,但 Google 發現所有網址均已修正該問題。
後續步驟:無須採取其他行動。 - 失敗:我們在你點選「驗證」後發現仍有特定比例的網頁包含此問題。
後續步驟:修正問題並重新開始驗證。
你提出驗證要求後,系統會為特定問題的每個例項指派下列其中一種驗證狀態:
- 待處理:已排入驗證佇列。Google 上次檢索時這個問題例項仍存在。
- 通過:(部分報表「沒有」這項狀態) 經 Google 檢查後問題例項已不存在。你必須明確對此問題例項點選過「驗證」,該例項才可能變更為這個狀態。
- 失敗:經 Google 檢查後問題例項仍存在。你必須明確對此問題例項點選過「驗證」,該例項才可能變更為這個狀態。
- 其他:(部分報表「沒有」這項狀態) Google 無法存取代管該例項的網址;如果是結構化資料,則表示在網頁上找不到該項目。這種情況等同於「通過」。
請注意,同一個網址上不同問題的狀態可能不同;舉例來說,如果單一網頁同時含有 X 問題和 Y 問題,X 問題的驗證狀態可能是「通過」,而位於同一個網頁上的 Y 問題則可能處於「待處理」狀態。
已知問題
以下是 Search Console 中的已知問題,你不必向我們回報,但如果你發現了其他問題,或對任何功能有意見,歡迎透過導覽列中內建的「意見回饋」機制告訴我們。
- 有些問題的名稱太長,不易理解。
- 如果您網站的問題數量眾多 (不論是否為現有個案),報告只會依重要性列出前 200 個問題。