本页目录
- 必填
- 页面浏览
- 自动记录的交互
- 隐私与环境
- 其他功能开关
- 改了属性多久生效
统计脚本的行为全部由标签上的属性控制，不需要写初始化代码。属性都写在同一个标签上，例如：
<script defer src="https://static.pathclue.com/client.js"
data-site="你的站点标识"
data-exclude="/admin/*,/preview"
data-forms="true"></script>
属性值都是字符串，开关类写 "true" 或 "false"。
必填
| 属性 | 说明 |
|---|
data-site | 站点标识，在控制台「SDK 代码」页复制。可以公开 |
页面浏览
| 属性 | 默认 | 说明 |
|---|
data-hash | 关 | 保留地址里 # 之后的部分，并在 hash 变化时记一次浏览。用于 /#/pricing 这种 hash 路由 |
data-exclude | 空 | 不记录浏览的路径，逗号分隔。带 * 按通配，否则要求完全相等，如 /admin/*,/preview。只匹配路径，不看查询串 |
data-auto-track | 开 | 设为 "false" 后关闭全部自动采集，只记你手动调用的。一般不需要 |
关于 data-auto-track="false"：它会同时关掉停留时长、外链和下载点击、页面性能和 404 记录，而且这些没法手动补回来。只是想排除几个页面的话，用 data-exclude。
自动记录的交互
| 属性 | 默认 | 说明 |
|---|
data-outbound | 开 | 点击指向其他网站的链接。设 "false" 关闭 |
data-downloads | 开 | 点击以常见文档、压缩包、安装包扩展名结尾的链接 |
data-forms | 关 | 设 "true" 后记录表单提交。只记表单的 id、name 和 action，不记任何填写内容 |
data-404 | 关 | 只加在 404 错误页模板的脚本上，用来统计死链 |
data-vitals | 开 | 页面加载性能（最大内容绘制、交互延迟、布局偏移等），访客离开首屏时汇总上报一次 |
data-errors | 关 | 设 "true" 后额外加载错误监控脚本，记录页面上的 JavaScript 报错 |
隐私与环境
| 属性 | 默认 | 说明 |
|---|
data-respect-dnt | 尊重 | 浏览器开了「请勿跟踪」或「全局隐私控制」时脚本不运行。不建议改 |
data-allow-local | 关 | 允许在 localhost 等本地地址上发送，只用于本地调试 |
data-api | 自动 | 自定义采集地址。不写时按脚本所在域名自动推导，一般不用设置 |
其他功能开关
| 属性 | 默认 | 说明 |
|---|
data-autocapture | 跟随项目 | 写 "false" 可以让某个页面不做全埋点。只能关，不能开：项目没开全埋点时写 "true" 也不会采 |
data-attribution | 不加载 | 写上这个属性（值可为空）才加载来源读取扩展，用于把访客的落地来源带进注册表单 |
data-chat | 跟随项目 | 写 "false" 强制不显示在线客服组件，不影响统计 |
改了属性多久生效
属性是浏览器读的，所以改完要等网站重新发布、访客重新加载页面才生效。如果有 CDN 或缓存插件，记得清缓存。项目设置里的规则（排除、会话、站内搜索参数）则是采集端读的，保存后立即生效。