生命周期（服务器端）

1. 为什么在浏览器桥接之外还有它

MousePlayer 已有生命周期桥接，会写入您自己页面中运行的 SDK，包括 Klaviyo、Braze、Customer.io 及另外六个平台。此桥接改从我们的服务器执行同一任务，因为两个最大平台根本没有可用的浏览器路径：

• ActiveCampaign 完全没有用于事件的浏览器 API。 其 vgo() 可设置账户和电子邮箱地址并启动跟踪，但不能发送事件。事件必须通过带独立事件密钥的 Event Tracking API 发送，仅限服务器端。
• Mailchimp 有浏览器 API，但词汇范围封闭。 其网站跟踪像素接受 PAGE_VIEWED、 PRODUCT_VIEWED、 PURCHASED 以及少量其他预定义名称。没有自定义事件的位置，将我们的数据硬塞进 PAGE_VIEWED ，会在您自己的数据模型里制造虚假信息。

2. 需要什么

三个字段，具体填写哪些取决于平台。

第三个字段是显示时使用的事件名称。请保持简短： 最多 32 个字符。这是 API 的限制，不是我们的限制；我们会在保存时缩短，而非发送时才缩短，否则表单显示的内容会与实际收到的不同。

3. 何时触发，何时不触发

会话被识别的那一刻：网站调用 MousePlayer.setUserId()、分析桥接读回 distinct ID，或服务器调用 identify 端点时。在此之前，我们不知道录制属于谁。

仅限电子邮箱地址

四个平台都通过电子邮箱地址定位联系人。如果客户 ID 是合同编号，就不发送任何内容；将注定失败的任务排入队列，只会让日志充满噪声。

每个事件都携带 ID

因此，即使任务重试，同一会话也不会被重复计数。

4. 对端收到什么

一个事件，以名为 mouseplayer_session_url的属性携带回放链接。打开后即可进入该确切会话的录制。

此后由平台自身逻辑决定：将事件用作自动化触发器、细分条件，或只是让团队从联系人资料打开录制。

密钥始终保留在我们的服务器内

它以 AES-256-GCM 加密存储，保存后不再显示，也刻意不放入承载任务的内部队列；工作进程会自行从数据库获取。

HTTP 200 不等于已投递

ActiveCampaign 拒绝事件时，会返回状态 200 和 {"success":0} 。我们读取响应正文，而非只看状态，因此拒绝会在投递日志中显示为失败，而非悄然显示为成功。