citlyze docs
使用 Citlyze

安裝 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(兩種都能擷取)
WordPressWordPress 外掛(兩種都能擷取)
你在 Google Tag Manager 中管理代碼Tag Manager
任何可以加入 script 標籤的網站瀏覽器程式碼片段

瀏覽器程式碼片段

瀏覽器程式碼片段是由 Citlyze 提供的小型指令碼。只有當工作階段來自可辨識的 AI 介面時,它才會回報造訪,並以瀏覽器權杖識別你的網站。這個權杖是公開的,且 綁定網站金鑰的網域,因此放在頁面原始碼中也很安全。

  1. 在應用程式中前往設定 → 連線 → 網站追蹤 → 安裝程式碼片段,開啟 瀏覽器 / GTM 分頁。
  2. 瀏覽器權杖需要已登錄網域的網站金鑰。如果分頁上出現這項提示,請先為網站金鑰 新增網域,再點選產生瀏覽器權杖。
  3. 複製這兩行程式碼片段,貼到網站每個頁面的 <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。

轉換事件

擷取安裝上線後,你的網站只要一次呼叫就能回報轉換,但必須先允許要使用的事件名稱:

  1. 在衡量 → 來自 AI 回答的造訪中,於擷取設定 → 轉換事件下加入你要接受的 事件名稱(最多 10 個小寫名稱)。不在清單中的事件會被拒絕。
  2. 在網站上發生轉換的地方觸發事件:
window.citlyze("event", "signup");

轉換以同一工作階段計算:會歸因到引薦該名轉換訪客的 AI 來源。在擷取設定中,也請 順便新增忽略的 IP(辦公室網段、測試環境),避免內部流量進入報告。

連接 Google Analytics 4

Google 連線會用 GA4 本身的工作階段資料填入 AI 流量報告,涵蓋你的程式碼片段看不到 的訪客,而且即使還沒有任何安裝也能運作。

  1. 在衡量 → 來自 AI 回答的造訪中找到 Google Analytics 與 Search Console 卡片,點選連結 Google 帳戶。
  2. 使用能檢視該 GA4 資源的 Google 帳戶登入,並核准 Google 同意畫面上列出的唯讀 存取權。
  3. 回到應用程式後,選擇要同步的 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 卡片會 顯示已同步的工作階段數。

本頁內容