安裝 AI 流量追蹤
透過瀏覽器程式碼片段、Tag Manager、WordPress 或 Cloudflare 擷取 AI 引薦造訪,並連結 GA4 與 Search Console。
本頁說明為 AI 流量提供資料的所有方式:各種擷取 安裝,以及選用的 Google 連線。如果你已經在伺服器端安裝了 爬蟲追蹤,該安裝也會回報 AI 引薦 造訪,你可以直接跳到轉換事件或 連接 Google Analytics 4。
追蹤哪些造訪
兩種不同的訪客需要兩種不同的擷取方式:
| 訪客 | 是否執行 JavaScript | 擷取方式 |
|---|---|---|
| AI 爬蟲(GPTBot、ClaudeBot 等) | 否 | 僅限伺服器端安裝 |
| 由 AI 回答引薦的真人訪客 | 是 | 伺服器端安裝或瀏覽器程式碼片段 |
伺服器端安裝(Cloudflare、WordPress、自建伺服器)兩種都能擷取。瀏覽器程式碼片段與 Tag Manager 只擷取真人引薦造訪,所以在你無法執行伺服器端程式碼時,它們是正確的 選擇;在其他情況下,它們只是補充,不能取代伺服器端安裝。
選擇安裝方式
| 你的情況 | 使用 |
|---|---|
| 已在執行伺服器端安裝 | 不需要再新增;造訪已經在回報 |
| 網站位於 Cloudflare 後方 | Cloudflare Worker(兩種都能擷取) |
| WordPress | WordPress 外掛(兩種都能擷取) |
| 你在 Google Tag Manager 中管理代碼 | Tag Manager |
| 任何可以加入 script 標籤的網站 | 瀏覽器程式碼片段 |
瀏覽器程式碼片段
瀏覽器程式碼片段是由 Citlyze 提供的小型指令碼。只有當工作階段來自可辨識的 AI 介面時,它才會回報造訪,並以瀏覽器權杖識別你的網站。這個權杖是公開的,且 綁定網站金鑰的網域,因此放在頁面原始碼中也很安全。
- 在應用程式中前往設定 → 連線 → 網站追蹤 → 安裝程式碼片段,開啟 瀏覽器 / GTM 分頁。
- 瀏覽器權杖需要已登錄網域的網站金鑰。如果分頁上出現這項提示,請先為網站金鑰 新增網域,再點選產生瀏覽器權杖。
- 複製這兩行程式碼片段,貼到網站每個頁面的
<head>中(或</body>之前):
<script>window.citlyze=window.citlyze||function(){(window.citlyze.q=window.citlyze.q||[]).push(arguments)};</script>
<script async src="https://app.citlyze.com/collect.js" data-token="cbt_YOUR_BROWSER_TOKEN"></script>第一行是 stub,會把指令碼載入前的呼叫先排入佇列,因此轉換呼叫絕不會擲回錯誤。
Google Tag Manager
如果你的網站代碼都在 Tag Manager 中管理,請使用這個方式。有兩種做法:
- 自訂 HTML 代碼:建立新的自訂 HTML 代碼,貼上瀏覽器 / GTM 分頁中同樣的 兩行程式碼片段,將觸發條件設為 All Pages,然後發布容器。
- 社群範本:Citlyze 提供可匯入的 Tag Manager 範本。在 Tag Manager 中前往 Templates → New → Import,載入 Citlyze 範本,用它建立代碼,並輸入你的 瀏覽器權杖。
兩種做法的效果相同;範本只是讓你在限制原始 HTML 權限的容器中,不必使用原始 HTML。
轉換事件
擷取安裝上線後,你的網站只要一次呼叫就能回報轉換,但必須先允許要使用的事件名稱:
- 在衡量 → 來自 AI 回答的造訪中,於擷取設定 → 轉換事件下加入你要接受的 事件名稱(最多 10 個小寫名稱)。不在清單中的事件會被拒絕。
- 在網站上發生轉換的地方觸發事件:
window.citlyze("event", "signup");轉換以同一工作階段計算:會歸因到引薦該名轉換訪客的 AI 來源。在擷取設定中,也請 順便新增忽略的 IP(辦公室網段、測試環境),避免內部流量進入報告。
連接 Google Analytics 4
Google 連線會用 GA4 本身的工作階段資料填入 AI 流量報告,涵蓋你的程式碼片段看不到 的訪客,而且即使還沒有任何安裝也能運作。
- 在衡量 → 來自 AI 回答的造訪中找到 Google Analytics 與 Search Console 卡片,點選連結 Google 帳戶。
- 使用能檢視該 GA4 資源的 Google 帳戶登入,並核准 Google 同意畫面上列出的唯讀 存取權。
- 回到應用程式後,選擇要同步的 GA4 資源並儲存。
此連線為唯讀:Citlyze 會讀取所選資源的每日彙總報表資料(來自 AI 助理來源的工作 階段、使用者與轉換,依到達網頁與日期細分),不會寫入任何內容到你的 Google 帳戶。 資料每天同步。
若要匯入你在 Google Analytics 中設定的重要事件,請開啟設定 → 連線 → 管理連線,勾選要匯入的重要事件並儲存。此外,Citlyze 也會讀取各管道的工作階段 (含互動、重要事件與收益),以及 AI 引薦造訪的國家/地區與裝置。
連接 Search Console
同一個 Google 連線也能同步一個 Search Console 網站:連結後在卡片中選擇網站即可。 Search Console 同步會帶入依網頁與日期細分的每日點擊、曝光與平均排名、全站總計, 以及你的熱門搜尋查詢,讓你在引薦資料旁邊有一份傳統 Google 搜尋的基準資料。 Google 的 AI Overviews 與 AI Mode 的曝光資料只會出現在 Search Console 自己的 「生成式 AI」報告中;Google 沒有為這些資料提供 API,所以任何工具都無法匯入。
中斷連結與撤銷存取權
- 在應用程式中,卡片上的中斷連結按鈕會移除儲存的連線,以及該服務已同步的 Google 資料。
- 你也可以隨時在 Google 帳戶的安全性設定中撤銷 Citlyze 的存取權,之後就無法再取得任何 Google 資料。
- 切換到其他資源或網站時,會取代先前同步的資料。
隱私權說明
- Google 存取權僅限於同意畫面上核准的唯讀報表範圍,沒有寫入權限。
- 瀏覽器權杖本來就設計為公開;資料接收端會比對回報頁面的網域與網站金鑰登錄的 網域。
- 引薦事件只記錄到達路徑、來源網址,以及大致的裝置與國家資訊,不記錄訪客身分。
- 引薦歷史資料依你的方案保留(30、90 或 400 天);請參閱 方案與限額。
驗證
網站追蹤頁面的網站金鑰表格中有最後事件欄位,你的安裝送出第一份被接受的 回報後就會更新;AI 引薦點擊也算在內。真實的工作階段進來後,AI 引薦造訪就會出現在 AI 流量頁面上;流量較低的網站可能需要一兩天。第一次每日同步完成後,Google 卡片會 顯示已同步的工作階段數。