安装 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 流量追踪

本页内容