常見問題
已經貼上 Schema 貼碼,檢測工具卻找不到資料?
先理解一件事:TrueLink 給你的是一段 JavaScript,不是直接寫在頁面裡的 JSON-LD。它要先成功載入並執行,結構化資料才會出現。
維護者整理的常見問題,不是會員提問;回答由 TrueNodes 維護團隊撰寫。
回答
TrueLink Schema 產生器的「獲取 API 自動同步代碼」(個人帳號需要 T2 實名藍勾)提供的是一般的 JS script src。JS 載入後,才會在頁面上加入內嵌的 application/ld+json。所以「原始碼裡找不到 JSON-LD」是正常的,要看的是執行後的頁面。
目前已知原因:貼碼的 JS 檔放在 TrueLink 網域的 /schema_apis/ 路徑下,而 TrueLink 的 robots.txt 目前禁止爬蟲讀取這個路徑。所以即使你的網站一切設定正確,Google 的複合式搜尋結果測試仍可能找不到資料。要給 Google 讀,請改用工具的「數位憑證原始碼(JSON-LD)」,直接放進網頁。
不要把貼碼改成 <script type="application/ld+json" src="…">,那種寫法不會載入內容。如果你的網站環境不適合用 JS,可以改用工具提供的原始碼輸出,直接放進網頁。
依序檢查這四個地方
檢查的是對的那一頁:用實際放了貼碼的網址去測,不是首頁或其他頁。
JS 在你的網站上有正常回應:在安裝了貼碼的頁面打開開發者工具的「網路」分頁,找到這支 JS,確認狀態是 200、內容是 JavaScript。直接在網址列打開它不準:貼碼只對 Schema 設定裡的官網網址與網域白名單回應,從別的網域載入會被拒絕(403),所以也要確認你的網域已經加進設定。
網站的 CSP 允許這個來源:如果網站設了內容安全政策,要允許貼碼實際使用的 JS 網域,否則瀏覽器會擋下它;開發者工具的主控台通常會顯示被擋的訊息。
robots.txt 沒有擋住 JS 檔:搜尋引擎不會執行被擋住的 JS,所以也看不到它產生的資料。要檢查的是 JS 所在網域的 robots.txt,不只是你網站的。
還要知道的事
- 修改並重新部署後,瀏覽器或外部快取可能暫時保留舊版本;請用實際網址重新檢查。
- 不執行 JavaScript 的爬蟲讀不到 JS 產生的資料,這是這種安裝方式的限制。
- CORS 或網域白名單設定正確,不等於網域所有權已驗證,也不保證會被收錄。
下一步:回工具頁重新取得貼碼
工具頁內也有完整的安裝與常見問題說明。
開啟 Schema 產生器來源與相關內容
- TrueLink Schema 產生器:頁內「Schema 使用步驟與 API 常見問題」
- MDN:內容安全政策(CSP)
- Google Search Central:JavaScript SEO 基本知識
內容依 2026-10-10 的網站現況撰寫;發現與現況不符,請透過 聯絡我們 回報。