观测云用户体验中的基础功能（自定义tag、错误、事件）

存在一些特定场景，需要通过设置不同类型的标识去定位分析一些数据，所以针对这些情况，RUM SDK 提供了一些特定的API 方便用户在自己的应用系统中，加入自己特定的逻辑：

Rum自定义用户

自定义标识用户

SDK 默认情况下，自动会给用户生成一个唯一标识ID。这个ID不带任何标识属性，只能区别出不同用户属性。为此我们提供了额外的API去给当前用户添加不同的标识属性。

属性	类型	描述
user.id	string	用户ID

以下属性是可选的，但建议至少提供其中一个。

添加用户标识

javascript 复制代码

window.DATAFLUX_RUM && window.DATAFLUX_RUM.setUser({
    id: '1234',
})

自定义添加额外的数据 TAG

初始化 RUM 后，使用addRumGlobalContext（key:string，value:any） API 向从应用程序收集的所有 RUM 事件添加额外的TAG。

添加TAG

javascript 复制代码

// Code example
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addRumGlobalContext('isvip', 'xxxx');
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addRumGlobalContext('activity', {
    hasPaid: true,
    amount: 23.42
});

替换TAG

css 复制代码

// Code example
window.DATAFLUX_RUM &&
    DATAFLUX_RUM.setRumGlobalContext({
        codeVersion: 34,
    });

自定义添加 Action

初始化 RUM 后，使用addAction（'<NAME>'，'<JSON_OBJECT>'） API,可以自定义添加采集之外的action 指标数据。

php 复制代码

// Code example
window.DATAFLUX_RUM && window.DATAFLUX_RUM.addAction('cart', {
    amount: 42,
    nb_items: 2,
    items: ['socks', 't-shirt'],
});

自定义添加 Error

初始化 RUM 后，使用addError（'<NAME>'，'<JSON_OBJECT>'） API，可以自定义添加采集之外的 error 指标数据。

添加Error

vbnet 复制代码

// Send a custom error with context
const error = new Error('Something wrong occurred.');

window.DATAFLUX_RUM && DATAFLUX_RUM.addError(error, {
    pageStatus: 'beta',
});