服务器端 CAPI 与事件跟踪

1. 跟踪模式概览

MousePlayer V2 引入强大的 事件路由器 ，让您控制数据如何从用户浏览器流向我们的服务器。有三种不同模式可选：

• 仅 Web（默认）： 通过 WebSocket 将全部数据直接流式传输至 MousePlayer。最适合实时查看，但容易受到强力广告拦截器影响。
• 混合模式： 兼顾两者优势。通过 WebSocket 发送轻量鼠标/滚动坐标，保持实时查看流畅；体量较大的 DOM 变更和自定义事件则批量打包，通过 HTTP POST 经由服务器端 GTM 安全路由。
• 纯 CAPI： 100% 采用 HTTP POST 批量传输。最大程度保护隐私，完全不使用 WebSocket，全部为第一方。 注意：此模式禁用实时查看。

2. Google Tag Manager 配置（推荐）

实现混合或纯 CAPI 模式最简单的方式，是使用官方 GTM 社区模板。下载下方的 .tpl 文件，并导入 GTM 工作区。

第 1 步：配置服务器端客户端与标签

在服务器端 GTM 容器中，导入 数据接入客户端 模板。设置为监听自定义路径（例如 /mp_capi）。随后导入 连接器标签，配置为在 mouseplayer_batch 事件上触发，并部署容器。

第 2 步：配置 Web GTM 标签

在 Web GTM 容器中，导入 SDK 标签。标签类型选择“配置与初始化”，输入 Channel ID，选择 混合模式，并粘贴 ssGTM 端点 URL（例如 https://metrics.yourdomain.com/mp_capi）。

3. 手动安装（不使用 GTM）

若倾向于硬编码脚本，必须在加载跟踪代码片段之前定义 window.mp_config 对象。

4. 电商漏斗跟踪

跟踪完整客户旅程。使用标准化事件名称，MousePlayer 可在项目工作区自动生成美观的电商漏斗报告。全部事件均与 CAPI 及仅 Web 模式完全兼容。

1. view_item

用户查看特定商品页时触发此事件。

2. add_to_cart

用户将商品加入购物车时触发此事件。

3. begin_checkout

用户进入结账画面时触发此事件。

4. purchase

付款成功或订单确认时触发此事件。

5. 自定义事件与潜在客户获取

不限于电商。可跟踪表单提交、新闻简报订阅，或 Web 应用特有的自定义交互。

潜在客户获取（表单提交）

用户成功提交联系表单或请求报价时触发此事件。

自定义 UI 交互

了解用户如何与计算器、弹窗或标签切换等复杂元素交互。

6. 参数限制与指南