사용자 정의 태그 및 BridgeContext¶

초기화 시 전역 태그 설정¶

globalContext를 사용하여 sdkConfig 또는 rum.setConfig에서 환경, 버전, 채널 또는 비즈니스 시나리오를 구분하는 사용자 정의 태그를 전달할 수 있습니다.

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 환경 매개변수