访客统计

在网站嵌入一行脚本,在应用控制台查看访客、来源、页面、设备与地区。不使用 Cookie、不存访客 IP,无需弹出 Cookie 同意提示。

开通条件

访客统计按应用所有者的套餐开放,站点数与月度事件数为账户内所有应用合计:

套餐	站点数	月度事件数	明细数据保留
Lite	不支持	—	—
Plus	3 个	10 万	180 天
Pro	20 个	100 万	730 天
Enterprise	不限	不限	1095 天

进入应用详情 → "访客统计",点击"添加站点",复制嵌入代码放到网站每个页面的 <head> 中 (或全站公共模板):

<script defer src="https://connect.czl.net/<脚本路径>" data-id="<站点标识>"></script>

后台展示的嵌入代码即最终地址,直接复制使用。单页应用 (React / Vue / Next.js 等) 的路由切换会自动统计,无需额外代码。

脚本地址与上报地址固定为 CZL Connect 的域名,不支持自行反向代理:反代后到达统计服务的是代理服务器 IP,所有访客的地区会被记成代理所在地。

// 记录一次事件, 属性最多 10 个, 值为字符串 / 数字 / 布尔
czl.ev('signup', { plan: 'pro' });

或给元素加 data-czl-ev 属性,点击即上报:

<button data-czl-ev="download">下载客户端</button>

事件出现在面板的"自定义事件"卡片。

页面地址带 utm_source / utm_medium / utm_campaign 时自动记录,出现在"推广活动"卡片;utm_medium=cpc 或带 gclid 等广告点击参数的访问归入"付费广告"渠道。

站点设置里可填写来源域名 (每行一个,*.example.com 匹配全部子域)。留空不限制;填写后只统计这些域名下的页面,防止别人把你的嵌入代码贴到其它网站消耗额度。

指标	口径
访客	按月匿名去重:同一浏览器在同一自然月内记为同一访客,跨月不可关联
访问次数	同一访客两次活动间隔超过 30 分钟即算新一次访问
浏览量	页面浏览次数 (含单页应用的路由切换)
跳出率	只浏览了一个页面的访问占比
平均访问时长	一次访问内首末事件的时间差的平均值
在线人数	最近 5 分钟有活动的访客

可公开的 SVG 计数徽章,贴到 README 或网页上展示访问量。站点设置中开启"公开计数徽章"后生效 (开启后任何人都能通过徽章地址看到数字),在面板点击"计数徽章"生成地址。

https://connect.czl.net/<徽章路径>/<站点标识>/<指标>.svg

查询参数:

参数	说明
`label`	左侧文字,默认按指标显示中文名;传空串只显示数字
`color`	右侧背景色,十六进制 (如 `4c1`) 或 `brightgreen` `green` `blue` `orange` `red` `grey` 等
`labelColor`	左侧背景色,规则同上
`style`	`flat` (默认) 或 `flat-square`
`path`	仅 `page` 指标:页面路径。放在网页里可省略,自动取所在页面

数字约 5 分钟刷新一次。GitHub README 中的图片经 GitHub 代理加载,拿不到所在页面,page 指标必须写明 path。站点未开启徽章、已停用或套餐不支持时,徽章显示 unavailable。

Markdown 示例:

![今日访客](https://connect.czl.net/<徽章路径>/<站点标识>/today.svg)
![本页浏览](https://connect.czl.net/<徽章路径>/<站点标识>/page.svg?path=/docs/intro&color=4c1)