添加自定义 Action¶

addAction(name, context?) 用于主动记录无法通过页面点击表达的业务操作，例如支付成功、搜索提交或功能开关变更。

自动点击采集与 Action 命名请参考跟踪用户操作。

参数¶

参数	类型	必填	说明
`name`	String	是	稳定的业务操作名称，例如 `checkout_completed`
`context`	Object	否	本次操作的业务字段，例如金额、渠道或结果

Action 名称应保持稳定。订单号、用户 ID 等动态值应放入 context，不要拼接到 name 中。

NPM 示例¶

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

datafluxRum.addAction("checkout_completed", {
  order_value: 42,
  payment_method: "card"
})

CDN 示例¶

同步加载异步加载

window.DATAFLUX_RUM &&
  window.DATAFLUX_RUM.addAction("checkout_completed", {
    order_value: 42,
    payment_method: "card"
  })

window.DATAFLUX_RUM.onReady(function () {
  window.DATAFLUX_RUM.addAction("checkout_completed", {
    order_value: 42,
    payment_method: "card"
  })
})

验证¶

触发业务操作后，在对应 Web 应用的 Action 查看器中搜索 checkout_completed，并确认 Action 名称和自定义字段已写入事件。