安裝 AI 爬蟲追蹤

本頁逐步說明每一條安裝路徑。關於爬蟲追蹤測量什麼、驗證如何運作，見 AI 爬蟲。

選擇與你的網站執行環境相符的指南：

開始之前：產生網站金鑰

無論使用哪個平台，每種安裝方式都需要一個網站金鑰：

1. 在應用中前往 AI 爬蟲 → 安裝追蹤。
2. 點擊產生網站金鑰。為金鑰取一個名字，最好同時填寫它將回報的網域； 該網域還能加強該網站的簽章爬蟲驗證。
3. 從確認對話框中複製兩個值：金鑰 ID 與簽章密鑰（以 ctk_ 開頭）。簽章密鑰只顯示一次；如果遺失，請在該金鑰上使用輪換 產生替代密鑰。

請務必保管好簽章密鑰：任何拿到它的人都可以為你的網站提交偽造的流量 回報。不要把它提交到公開的程式碼儲存庫，也不要貼到用戶端程式碼中。

Cloudflare Worker

適用於 DNS 託管在 Cloudflare 且網站已開啟代理（橘色雲開關）的情況。這是 最完整的方案：它在邊緣看到每一個請求，回報真實的 HTTP 狀態碼，而且無論 Cloudflare 背後執行的是什麼都能運作。

1. 在 AI 爬蟲 → 安裝追蹤中開啟 Cloudflare 頁籤並複製程式碼片段。
2. 把片段中的 SITE_KEY_ID 與 ctk_SITE_KEY_SECRET 替換為你的金鑰 ID 與簽章密鑰。
3. 在 Cloudflare 控制台中，前往 Workers & Pages → Create → Create Worker。取一個名字（例如 ai-crawler-tracker），點擊 Deploy 建立空的 Worker。
4. 點擊 Edit code，把自動產生的範例替換為你的片段，再次點擊 Deploy。
5. 把 Worker 連接到你的網站：開啟該 Worker 的 Settings → Domains & Routes → Add → Route，選擇你的區域（zone），加入路由 example.com/*。如果網站同時透過 www.example.com 提供服務，再為 www.example.com/* 加入一條路由。
6. 完成：網站程式碼無需任何改動。Worker 會把每個請求原樣透傳到你的 來源站，並在背景回報相符的造訪。

有兩點需要檢查：

• 路由必須涵蓋所有路徑（/*），否則爬蟲對未涵蓋頁面的造訪將不可見。
• 如果這些路由上已經執行了一個 Worker，Cloudflare 每條路由只會執行一個 Worker；請把片段的邏輯合併進現有 Worker，而不是再加一個。

Vercel / Next.js 中介軟體

適用於部署在 Vercel 上的 Next.js 應用。同一個檔案也適用於自架的 Next.js。

1. 在 AI 爬蟲 → 安裝追蹤中開啟 Vercel / 反向代理 頁籤並複製 程式碼片段。
2. 在你的 Next.js 儲存庫中，在專案根目錄（如果應用位於 src/，則在 src/ 中）建立 middleware.ts 並貼上片段。
3. 把 SITE_KEY_ID 與 ctk_SITE_KEY_SECRET 替換為你的金鑰 ID 與簽章 密鑰。
4. 如果你已經有 middleware.ts，不要再新增第二個檔案；Next.js 只會 執行一個。把片段的輔助程式碼區塊複製進現有檔案，在你的中介軟體函式 開頭呼叫其回報邏輯，並確保 matcher 設定仍涵蓋所有路徑。
5. 提交並部署。

說明：

• 中介軟體在回應產生之前執行，因此事件的 HTTP 狀態會回報為 unknown。 這是預期行為；錯誤洞察需要 Cloudflare 或自建伺服器安裝方式。
• 在 Vercel 上，訪客 IP 取自平台設定的請求標頭，可以信任。如果你把 Next.js 自架在自己的代理之後，請確保片段讀取的轉發 IP 標頭是由 你的代理設定的，而不是從用戶端透傳的。

WordPress 外掛

適用於任何可以安裝外掛的 WordPress 網站。

1. 在 AI 爬蟲 → 安裝追蹤中開啟 WordPress 頁籤，點擊 下載外掛（Download plugin）。
2. 在 WordPress 後台前往 外掛 → 安裝外掛 → 上傳外掛，選擇下載的 zip，點擊立即安裝，再點擊啟用。
3. 前往 設定 → AI Crawler Tracker，填寫全部三個欄位：
   • Tracker base URL：https://app.citlyze.com
   • Key ID：你的金鑰 ID
   • Signing secret：你的 ctk_... 簽章密鑰 在填寫追蹤器基礎 URL 之前，外掛不會回報任何資料。
4. 點擊發送測試事件（Send test event）。你應該會看到「已連線」的 確認；這證明你的憑證與連線能力端到端有效。

注意：全頁快取與 CDN 可能根本不執行 WordPress 就直接回應請求，這會少計 爬蟲造訪。如果你的網站在 Cloudflare 後面大量使用快取，請優先選擇 Cloudflare Worker 安裝方式。

自建伺服器 / Node

適用於自己架設的自行開發網站：AWS、Google Cloud、Azure、VPS 或容器。 該片段是面向 Node 20 及更新版本的 Express 風格中介軟體（也可在 Bun 與 Deno 上執行）。

1. 在 AI 爬蟲 → 安裝追蹤中開啟自建伺服器 / Node 頁籤並複製 程式碼片段。
2. 把它儲存為 aeo-tracker.mjs，放在伺服器進入點旁邊。
3. 把 SITE_KEY_ID 與 ctk_SITE_KEY_SECRET 替換為你的金鑰 ID 與簽章 密鑰。如果團隊偏好環境變數，在檔案頂部把它們讀入這兩個常數即可； 只要確保簽章密鑰不進入版本控制。
4. 在你的路由之前註冊中介軟體：

   import { aeoCrawlerTracker } from "./aeo-tracker.mjs";
   app.use(aeoCrawlerTracker());

5. 如果伺服器位於負載平衡器或反向代理（nginx、ALB）之後，請設定 Express 信任它（例如 app.set("trust proxy", 1)），這樣中介軟體回報 的才是真實的用戶端 IP，而不是代理的 IP。爬蟲身分驗證檢查的正是這個 IP。
6. 部署。中介軟體在每次回應完成後才回報，因此不增加任何延遲，並且包含 真實的 HTTP 狀態碼。

不用 Express？回傳的處理函式接受一般的 (req, res, next) 參數，可適配 Fastify、Koa 或 Node 的 http 伺服器。完全使用其他語言（Python、Go、 PHP、Ruby 等）時，請實作 簽章信標協定； 每個相符請求只需一次帶簽章的 HTTPS POST。

Webflow

Webflow 自身的託管無法執行伺服器端程式碼，而瀏覽器端指令碼看不到 AI 訓練爬蟲，因此追蹤要安裝在 Webflow 前面的代理層：

1. Webflow 在 Enterprise 方案上支援自行管理的反向代理；請與你的 Webflow 聯絡人協商開通，並把網域路由到你的代理（Cloudflare、 CloudFront、Fastly 或你自己的 nginx）。
2. 在該代理層安裝追蹤器：
   • 代理在 Cloudflare 上 → 依照 Cloudflare Worker 指南操作。
   • 你自己的 Node 代理 → 依照 自建伺服器 / Node 指南操作。
   • 其他情況 → 在你的代理中實作 簽章信標協定。
3. 依照下文所述進行驗證。

Webflow Cloud 應用程式不是全站追蹤的途徑：它們只服務掛載路徑下的請求， 永遠看不到爬蟲對一般頁面的造訪。

Shopify

標準 Shopify 店面無法執行此追蹤器：Shopify 不允許商家在店面請求上執行 伺服器端程式碼，也不支援在商店前架設代理（例如 Cloudflare）。瀏覽器端 指令碼不是替代方案：AI 訓練爬蟲從不執行 JavaScript，而且瀏覽器指令碼 會暴露你的簽章密鑰。

你可以做的：

• 以 Hydrogen 建構、託管在 Oxygen 上（或任何自架環境）的 Headless 店面執行伺服器端程式碼；把 自建伺服器 / Node 片段的邏輯接入店面的伺服器 請求處理器。
• 對於標準商店，Citlyze 的其他測量（提示詞追蹤、引用、GEO 稽核）不受 商店託管位置影響，照常運作。

驗證安裝

• 在 AI 爬蟲 → 安裝追蹤中，網站金鑰表格有一欄最後事件。當你的 安裝送達第一份被接受的回報後它就會更新；爬蟲造訪與來自 AI 回答的 引薦點擊都算。
• WordPress 使用者可以透過發送測試事件（Send test event）立即確認 送達（測試事件驗證憑證與連線能力，但不會更新最後事件）。
• 給它一點時間：低流量網站的第一次真實爬蟲造訪可能需要幾小時到幾天。 事件到達後，AI 爬蟲 → 分析就會填入資料。
• 如果幾天後仍然沒有任何資料，請重新檢查安裝中的金鑰 ID 與簽章密鑰是否 對應一個有效（未撤銷）的金鑰，以及你的路由或中介軟體是否涵蓋所有 路徑。