自定义标签与 BridgeContext¶

获取 MobileAgent¶

普通 uni-app 从 GC-UniPlugin 导入，uni 小程序从 GC-JSPlugin 导入：

// 普通 uni-app
import { mobileAgent } from '@/uni_modules/GC-UniPlugin';

// uni 小程序使用下方导入替代上方导入
// import { mobileAgent } from '@/uni_modules/GC-JSPlugin';

初始化时设置全局标签¶

普通 uni-app 可在 sdkConfig 或 rum.setConfig 中通过 globalContext 传入自定义标签：

mobileAgent.sdkConfig({
    datakitUrl: 'YOUR_DATAKIT_URL',
    globalContext: {
        custom_key: 'custom value'
    }
});

uni 小程序不重复初始化 SDK，由宿主 App 在 Native SDK 初始化配置中设置初始全局标签。

运行时添加自定义标签¶

mobileAgent.appendGlobalContext({
    ft_global_key: 'ft_global_value'
});

mobileAgent.appendRUMGlobalContext({
    ft_global_rum_key: 'ft_global_rum_value'
});

mobileAgent.appendLogGlobalContext({
    ft_global_log_key: 'ft_global_log_value'
});

API	说明
appendGlobalContext(object)	添加作用于 RUM 和 Log 的全局参数
appendRUMGlobalContext(object)	添加仅作用于 RUM 的全局参数
appendLogGlobalContext(object)	添加仅作用于 Log 的全局参数

添加 BridgeContext¶

mobileAgent.appendBridgeContext({
    wgt_id: 'wgt_id_1'
});

appendBridgeContext 只注入由 uni-app 或 uni 小程序 JS 侧采集的 RUM 和 Log 数据，不影响宿主 App 原生侧自行采集的数据。它适合区分宿主 App 与不同 uni 小程序的数据来源。

字段	类型	必须	说明
无	object	是	uni-app 或 uni 小程序环境参数