自定义数据与事件¶
Browser RUM SDK 会自动采集 View、Resource、Error 和用户操作。只有在需要关联登录用户、增加业务维度或主动记录业务事件时,才需要调用本节的公共 API。
选择 API¶
| 目标 | API | 说明 |
|---|---|---|
| 关联登录用户 | setUser()、clearUser() |
自定义用户标识 |
| 为后续所有 RUM 事件添加业务维度 | setGlobalContextProperty()、setGlobalContext() |
全局上下文 |
| 主动记录业务操作 | addAction() |
添加自定义 Action |
| 上报已捕获或业务识别的异常 | addError() |
上报自定义 Error |
使用原则¶
- 先完成 Web 应用接入,确认基础 View 数据已经上报。
- 用户 ID、Context key 和 Action name 应使用稳定值,避免订单号等高基数数据进入名称字段。
- 不要上报密码、Token、完整身份证号等敏感信息。
- CDN 异步加载时,通过
DATAFLUX_RUM.onReady()调用 API,避免 SDK 尚未加载完成。