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 标签的网站浏览器代码片段

浏览器代码片段

浏览器代码片段是由应用提供的一小段脚本。只有当会话来自可识别的 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 中管理,就用它来安装。有两种做法:

  • Custom HTML 标签:新建一个 Custom HTML 标签,粘贴浏览器 / GTM 标签页中同样的两行代码片段,把触发条件设为 All Pages,然后发布容器。
  • 社区模板:Citlyze 提供可导入的 Tag Manager 模板。在 Tag Manager 中前往 Templates → New → Import,载入 Citlyze 模板,用它创建一个标签,并填入你的浏览器令牌。

两种做法效果相同;如果容器限制使用原始 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 卡片会显示已同步的会话数。

本页内容