操作教學
用 Schema 產生器建立 JSON-LD,並在發布前驗證
你想讓網站清楚說明「我是誰、在哪裡、怎麼聯絡」,但不確定 JSON-LD 寫對了沒有。這篇帶你用 TrueLink 既有的 Schema 產生器做出一份,並用公開工具自己檢查。
操作步驟
-
開啟產生器,選擇主體類型
前往 Schema 產生器,選擇企業、門市、個人或組織。不用登入就能填表與產生 JSON-LD;未登入時填的內容會暫存在這台裝置的瀏覽器,登入後會嘗試帶回。
-
只填你能管理、願意公開的資料
填官方 HTTPS 網址、公開名稱與聯絡方式。JSON-LD 會放在公開網頁上,任何人都能讀取與複製,所以不要填密碼、API 私密金鑰、身分證明或 KYC 文件。不要寫你無法證明的獎項、資格或地址。
-
預覽 JSON-LD,再自己核對一次
右側會即時顯示 JSON-LD。使用 AI 輔助時,先確認它抽出的每個欄位;AI 建議與工具分數都不代表公司、資格或網域已被驗證。
-
登入後保存與部署
按「雲端部署節點」需要登入。它會先寫入一份公開 JS,再保存 Schema 與歷史紀錄,兩步可能各自失敗。如果第二步失敗,公開 JS 可能已經換成新內容,已經安裝貼碼的網站會直接用到它;看到錯誤時,請打開你的網站確認實際輸出,必要時再部署一次。成功後用「獲取 API 自動同步代碼」取得貼碼,安裝在自己的網站一次即可。個人帳號使用這個按鈕需要 T2 實名藍勾(公司 KYC 審核通過會升到 T2,也可以付費開通;個人實名與專家認證是否升級依系統重新計算的結果而定,請以會員中心顯示的目前等級為準);個人 T1 帳號按下去會被帶到升級頁,拿不到貼碼。注意:Google 目前讀不到這份 JS 貼碼(原因見下方「限制」),要讓 Google 讀到,請改貼工具的「數位憑證原始碼(JSON-LD)」。
-
用實際網址驗證
網站更新後,用 Google 複合式搜尋結果測試 與 Schema.org 驗證器 檢查你的網站網址,不是只貼工具畫面上的程式碼。
示範
示範資料:以下是虛構的商家,網址使用保留給範例的 example.com,不是任何真實客戶。
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"@id": "https://www.example.com/#business",
"name": "示範咖啡(虛構)",
"url": "https://www.example.com/",
"telephone": "+886-2-0000-0000",
"address": {
"@type": "PostalAddress",
"addressLocality": "台北市",
"addressCountry": "TW"
}
} 驗證時常見的兩種結果:
- 沒有錯誤:只代表該工具在這次檢查中沒找到它支援的語法問題。
- 找不到結構化資料:先確認貼碼真的在你檢查的那一頁、JS 網址有正常回應、沒有被網站的 CSP 或 robots.txt 擋住。
這個做法的限制
- 驗證通過不保證出現複合式搜尋結果、提高排名或被 AI 引用;是否顯示由搜尋引擎決定。
- JS 貼碼的檔案放在 TrueLink 網域的
/schema_apis/路徑下,而 TrueLink 的 robots.txt 目前禁止爬蟲讀取這個路徑。Google 不會執行被擋住的 JS,所以目前用 JS 貼碼,Google 讀不到你的結構化資料。要給 Google 讀,請把工具的「數位憑證原始碼(JSON-LD)」直接放進網頁。 - JSON-LD 在 JS 執行後才出現在頁面上,不執行 JavaScript 的爬蟲也讀不到 JS 貼碼產生的資料。
- 修改後重新部署,瀏覽器或外部快取仍可能暫時保留舊資料;請用實際網址重新檢查。
- 網域白名單、CORS 或貼碼存在,都不等於網域所有權或公司身分已驗證。
- 工具頁目前只有繁體中文介面。
下一步:做出你的第一份 JSON-LD
不用先註冊,打開產生器就能開始。想保存與部署時再登入;要取得網站貼碼,個人帳號需要達到 T2。
開啟 Schema 產生器來源
- TrueLink Schema 產生器:頁內「Schema 使用步驟與 API 常見問題」(部署流程、快取、公開範圍)
- Google Search Central:結構化資料簡介
- Schema.org:LocalBusiness
內容依 2026-10-10 的工具版本撰寫;工具更新後若步驟不同,以工具頁為準。發現錯誤可透過 聯絡我們 回報。