自定义用户标识¶

SDK 会为匿名用户生成标识。用户登录后，可调用 setUser() 写入稳定的业务用户信息，便于跨 Session 查询同一用户的 View、Action、Resource 和 Error。

建议至少提供 id。不要使用会频繁变化的昵称或邮箱代替稳定用户 ID。

NPM 示例¶

import { datafluxRum } from "@cloudcare/browser-rum"

datafluxRum.setUser({
  id: "user-1234",
  name: "John Doe",
  email: "john@example.com",
  membership_level: "gold"
})

CDN 示例¶

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })

window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.setUser({
    id: "user-1234",
    name: "John Doe",
    email: "john@example.com"
  })
})

退出登录或切换用户¶

退出登录时调用 clearUser()，避免后续事件继续关联到原用户：

datafluxRum.clearUser()

从 SDK 3.3.6 开始，登录、退出或切换账号后，可以先更新用户信息，再调用 startSession() 立即创建新的 Session 边界：

datafluxRum.setUser({ id: "user-5678" })
datafluxRum.startSession()

CDN 接入使用 window.DATAFLUX_RUM.clearUser() 和 window.DATAFLUX_RUM.startSession()。

注意事项¶

1. 不要写入密码、访问 Token、身份证号等敏感信息。
2. 用户信息只影响设置之后产生的事件，不会修改已经上报的数据。
3. 用户切换后应同步更新用户信息和 Session，避免两个账号的数据落入同一 Session。

验证¶

设置用户后触发一次页面操作，在 View 或 Action 查看器中确认事件已包含 user.id。退出登录并调用 clearUser() 后，新产生的事件不应继续关联原用户。