自定义标签与 BridgeContext¶

初始化时设置全局标签¶

可在 sdkConfig 或 rum.setConfig 中通过 globalContext 传入自定义标签，用于区分环境、版本、渠道或业务场景。

var ftModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");

ftModule.sdkConfig({
    datakitUrl: 'your datakitUrl',
    globalContext: {
        custom_key: 'custom value'
    }
});

运行时添加自定义标签¶

var ftModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");

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

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

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

API - appendGlobalContext¶

添加自定义全局参数，作用于 RUM 和 Log 数据。

字段	类型	必须	说明
无	object	是	自定义全局参数

API - appendRUMGlobalContext¶

添加自定义 RUM 全局参数，仅作用于 RUM 数据。

字段	类型	必须	说明
无	object	是	自定义全局 RUM 参数

API - appendLogGlobalContext¶

添加自定义 Log 全局参数，仅作用于 Log 数据。

字段	类型	必须	说明
无	object	是	自定义全局 Log 参数

添加 BridgeContext¶

SDK 0.2.4 以上支持

var ftModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");

ftModule.appendBridgeContext({
    ft_bridge_context: 'ft_bridge_context_value'
});

API - appendBridgeContext¶

仅注入 UniApp 侧采集的 RUM 和 Log 数据，Native 端采集的数据不会注入该上下文。

用途：区分数据来源或标记特定业务场景，例如区分宿主 App 与 uni 小程序数据。

字段	类型	必须	说明
无	object	是	UniApp 环境参数