콘텐츠로 이동

사용자 정의 태그 및 BridgeContext¶

MobileAgent 가져오기¶

일반 uni-app은 GC-UniPlugin에서 가져오고, uni 미니프로그램은 GC-JSPlugin에서 가져옵니다:

// 일반 uni-app
import { mobileAgent } from '@/uni_modules/GC-UniPlugin';

// uni 미니프로그램은 아래 import로 위 import를 대체합니다
// 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 미니프로그램 환경 파라미터