
結構化資料怎麼實作與測試?
應該由系統自動產生
這是實作結構化資料最重要的原則。
手動在每一篇文章裡貼上標記程式碼,會有三個問題:
- 容易與實際內容不一致——文章標題改了,標記裡的舊標題忘了改
- 編輯器可能過濾掉部分標籤——存檔後標記消失或損壞
- 無法統一維護——規範調整時要逐篇修改
正確做法是由網站系統依既有的欄位自動組出標記。 標題、發布時間、作者、圖片這些資料後台本來就有,讓程式讀取並輸出到頁面的 head 區域即可。
後台若要保留手動覆寫
可以提供一個獨立的欄位,供特殊情況使用。但不要讓編輯在內容編輯器裡貼標記——內容與標記應該分開存放。
這也是為什麼建議後台要有獨立的標記欄位,見後台管理系統是什麼。
實作時的三個原則
一、標記必須與頁面內容一致
這是最重要的規範。標記中的價格、標題、日期,必須與訪客實際看到的相同。
不一致的情況,輕則標記被忽略,重則失去顯示特殊呈現的資格。
二、必填欄位要完整
每一種類型都有必填與建議填寫的欄位。缺少必填欄位,該筆標記通常會被視為無效。
建議欄位雖然不強制,但填得越完整,被正確理解的機會越高。
三、一頁一個主要類型
一個頁面可以有多種標記(例如同時有組織資訊與麵包屑),但主要的內容類型應該只有一個。把一頁同時標記成商品、文章又是活動,會造成混淆。
測試工具
實作完成後必須測試。目前常用的有兩類:
| 工具 | 用途 |
|---|---|
| 複合式搜尋結果測試 | 檢查是否符合搜尋引擎的特殊呈現資格 |
| 結構化資料驗證工具 | 檢查標記語法是否正確、欄位是否完整 |
兩者用途不同:前者告訴你「能不能顯示特殊呈現」,後者告訴你「語法有沒有寫對」。建議兩個都跑一次。
工具會變動
搜尋引擎的官方工具經過數次調整——早期的結構化資料測試工具後來移交社群維護,官方改推複合式搜尋結果測試。
使用前建議先確認目前官方推薦的是哪一個,網路上找到的舊教學可能指向已停用的工具。
測試的兩種方式
- 貼上網址——測試已上線的頁面,最接近實際狀況
- 貼上程式碼——測試尚未上線的內容,或排除其他因素干擾
測試工具通常會顯示偵測到的項目、各欄位的內容,以及錯誤與警告。
錯誤與警告的差別
- 錯誤——必填欄位缺漏或格式不對,該筆標記無效,必須修正
- 警告——建議欄位缺漏,仍可運作,但補上會更好
Search Console 的報表
測試工具檢查單一頁面,Search Console 則提供整站的狀況:
- 各類型標記的有效數量
- 有錯誤或警告的頁面清單
- 歷史趨勢——數量突然下降通常代表出了問題
建議每季查看一次。 特別是網站改版或系統更新後,標記可能因為版型調整而失效。
實作的順序建議
- 先做組織資訊與麵包屑——成本低、通用性高,全站適用
- 再做主要內容類型——依網站性質選商品、文章或在地商家
- 測試少數頁面確認正確
- 套用到全站
- 在 Search Console 觀察一段時間
不必一次做完所有類型。做對兩三種,勝過做了七八種但都有錯誤。
改版後務必重新確認
結構化資料是隨版型輸出的,網站改版、更換模板、或系統升級後,標記可能
- 被新版型移除
- 欄位對應錯誤
- 指向的網址變成舊網址
把「結構化資料測試」列入改版驗收的檢查項目,見網站驗收怎麼做。
結構化資料的類型、必填欄位、規範與測試工具會不定期調整,複合式搜尋結果的顯示與否也由搜尋引擎自行決定。本文說明的是原則與作法,實際規格請以搜尋引擎官方文件之現行版本為準。