安裝 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 標籤的網站	瀏覽器程式碼片段

瀏覽器程式碼片段

瀏覽器程式碼片段是由應用提供的小型指令碼。只有當工作階段來自可辨識的 AI 介面時才回報造訪，並以瀏覽器權杖識別你的網站；權杖是公開的，且繫結至網站金鑰的網域，因此放在頁面原始碼中是安全的。

在應用中前往 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 中管理時使用它。兩種做法：

Custom HTML 標籤：建立新的 Custom HTML 標籤，貼上 瀏覽器 / GTM 頁籤中同樣的兩行程式碼片段，把觸發條件設為 All Pages，然後發佈容器。
社群範本：Citlyze 提供可匯入的 Tag Manager 範本。在 Tag Manager 中前往 Templates → New → Import，載入 Citlyze 範本，用它建立標籤並填入你的瀏覽器權杖。

兩者效果相同；範本只是避免在限制原始 HTML 權限的容器中使用原始 HTML。

轉換事件

擷取安裝上線後，你的網站可以用一次呼叫回報轉換，前提是先允許事件名稱：

在 AI 爬蟲 → AI 流量中，於擷取設定 → 轉換事件下加入你要接受的事件名稱（最多 10 個小寫名稱）。不在清單上的事件會被拒絕。
在網站上發生轉換的地方觸發事件：

window.citlyze("event", "signup");

轉換以同工作階段計算：歸因於引薦該完成轉換訪客的 AI 來源。在擷取設定時，也順便加入忽略的 IP（辦公室網段、測試環境），讓內部流量不進入報告。

連接 Google Analytics 4

Google 連接用 GA4 自身的工作階段資料填充 AI 流量報告，涵蓋你的程式碼片段看不到的訪客，而且在任何安裝就位之前就能運作。

在 AI 爬蟲 → AI 流量中找到 Google Analytics 與 Search Console 卡片，點擊連接 Google 帳號。
使用能檢視該 GA4 資源的 Google 帳號登入，並核准 Google 同意畫面上顯示的唯讀存取權。
回到應用中，選擇要同步的 GA4 資源並儲存。

此連接為唯讀：Citlyze 讀取所選資源的每日彙總報告資料（AI 助理來源的工作階段、使用者與轉換，按著陸頁與日期），不會向你的 Google 帳號寫入任何內容。資料每天同步。

連接 Search Console

同一個 Google 連接也可以同步一個 Search Console 網站：連接後在卡片中選擇網站。Search Console 同步帶入按頁面與日期的每日點擊與曝光，涵蓋你的頁面在 Google 搜尋 AI 功能中的表現，與引薦資料互相補充。

中斷連結與撤銷

在應用中，卡片的中斷連結按鈕會移除儲存的連接，以及該供應商已同步的 Google 資料。
你也可以隨時在 Google 帳號的安全性設定中撤銷 Citlyze 的存取權，之後將無法再取得任何 Google 資料。
切換到其他資源或網站會取代先前同步的資料。

隱私說明

Google 存取權僅限同意畫面上核准的唯讀報告範圍；沒有寫入權限。
瀏覽器權杖依設計是公開的；接收端會把回報頁面的網域與網站金鑰註冊的網域比對。
引薦事件記錄著陸路徑、referrer，以及粗略的裝置與國家/地區脈絡，不記錄訪客身分。
引薦歷史依你的方案保留（30、90 或 400 天）；見方案與限額。

驗證

安裝追蹤上的網站金鑰表格有一欄最後事件，會在你的安裝送達第一份被接受的回報後更新；AI 引薦點擊也算。真實工作階段到達後，AI 引薦造訪就會出現在 AI 流量頁面；低流量網站可能需要一兩天。第一次每日同步完成後，Google 卡片會顯示已同步的工作階段數。

安裝 AI 流量追蹤

本頁內容