安装追踪代码详解(含 SPA / 采集模式 / 排除自己)
快速入门 更新时间: 2026-09-14 浏览: 3
追踪脚本是 Monit 采集数据的入口,本文详细说明脚本参数、采集模式与各框架接入方式。
脚本完整示例与参数
<script src="https://monit.example.com/assets/pixel/monit.js"
data-website-id="像素密钥"
data-mode="advanced"
data-replay="1"
data-manual
async></script>
| 属性 | 必填 | 说明 |
|---|---|---|
| src | 是 | 指向你的 Monit 实例的 /assets/pixel/monit.js(同源部署,无跨域问题) |
| data-website-id | 是 | 网站像素密钥,可在「网站管理 → 安装代码」中复制 |
| data-mode | 否 | advanced(完整模式,默认):页面停留、滚动、外链点击、回放等完整行为;lightweight(轻量模式):仅页面浏览,开销最小 |
| data-replay | 否 | 1 开启会话回放采集(自动加载 rrweb,无需站点另行引入);轻量模式不支持 |
| data-manual | 否 | 禁止自动启动,改由代码在合适时机调用 window.MonitPixel.init()(如 Cookie 同意后) |
SPA 应用接入
完整模式下脚本会自动监听 history.pushState / replaceState / popstate / hashchange,路由切换自动记录页面浏览,无需手动埋点:
<!-- React / Vue / Next.js 等直接引入即可 -->
<script src="https://monit.example.com/assets/pixel/monit.js" data-website-id="像素密钥" data-mode="advanced" data-replay="1" async></script>
Cookie 同意后才开始统计
<script src="https://monit.example.com/assets/pixel/monit.js" data-website-id="像素密钥" data-mode="advanced" data-manual async></script>
<script>
document.getElementById('consent-btn').addEventListener('click', function () {
window.MonitPixel.init();
});
</script>
排除自己的访问
- 方案 A:使用浏览器的广告拦截扩展屏蔽
monit.js,或用无痕窗口访问。 - 方案 B:管理员在系统设置中配置 IP 排除,把办公网出口 IP 排除出统计。
常见安装问题
脚本报 404
确认
src 域名与 Monit 部署域名一致,且 Web 服务器未拦截 /assets/pixel/monit.js。只有浏览量,没有行为数据
多半使用了
lightweight 轻量模式,改为 advanced 完整模式即可。代码放在 body 末尾可以吗
可以,但推荐放
<head> 并保持 async,避免快速跳转丢失页面浏览。