安装 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 平台时,它才会上报访问。它用浏览器令牌标识你的网站;令牌是公开的,并与站点密钥的域名绑定,因此可以放心地写在页面源码中。
- 在应用中前往 设置 → 连接 → 网站跟踪 → 安装代码片段,打开浏览器 / 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,用模板就不需要这项权限。
转化事件
采集代码上线后,你的网站只需一次调用就能上报转化,但要先把事件名称加入允许列表:
- 在衡量 → 来自 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 卡片会显示已同步的会话数。