사용자 정의 태그 사용¶
빌드 구성 방식¶
-
build.gradle에서 여러productFlavors를 생성하여 태그를 구분합니다. -
RUM구성에 해당BuildConfig상수를 추가합니다.
런타임 파일 읽기/쓰기 방식¶
-
SharedPreferences와 같은 파일 유형 데이터를 저장하여SDK를 구성하고, 구성 위치에 태그 데이터를 가져오는 코드를 추가합니다. -
필요할 때 파일 데이터를 수정하는 메서드를 추가합니다.
-
마지막으로 앱을 다시 시작합니다. 자세한 내용은 SDK Demo를 참조하세요.
SDK 런타임 추가¶
SDK 초기화가 완료된 후 FTSdk.appendGlobalContext(globalContext), FTSdk.appendRUMGlobalContext(globalContext), FTSdk.appendLogGlobalContext(globalContext)를 사용하여 태그를 동적으로 추가할 수 있으며, 설정이 완료되면 즉시 적용됩니다. 이후 RUM 또는 Log에서 후속으로 전송되는 데이터에는 해당 태그가 자동으로 포함됩니다.
이 사용 방식은 데이터를 지연해서 가져오는 시나리오에 적합합니다. 예를 들어 태그 데이터를 로그인, API 요청 또는 로컬 비동기 초기화 이후에야 가져올 수 있는 경우입니다.
Warning
SDK 초기화 구성의 globalContext 또는 SDK 내장 필드와 동일한 key를 사용하지 마세요. 이름이 같을 경우 초기화 구성의 정적 태그가 동적으로 추가한 태그보다 우선순위가 높습니다.
사용 방법¶
/**
* 동적으로 전역 태그 설정
* @param globalContext
*/
public static void appendGlobalContext(HashMap<String,Object> globalContext)
/**
* 동적으로 RUM 전역 태그 설정
* @param globalContext
*/
public static void appendRUMGlobalContext(HashMap<String,Object> globalContext)
/**
* 동적으로 Log 전역 태그 설정
* @param globalContext
*/
public static void appendLogGlobalContext(HashMap<String,Object> globalContext)
/**
* 동적으로 전역 태그 설정
* @param globalContext
*/
fun appendGlobalContext(globalContext: HashMap<String, Any>)
/**
* 동적으로 RUM 전역 태그 설정
* @param globalContext
*/
fun appendRUMGlobalContext(globalContext: HashMap<String, Any>)
/**
* 동적으로 Log 전역 태그 설정
* @param globalContext
*/
fun appendLogGlobalContext(globalContext: HashMap<String, Any>)
//SDK 초기화 의사 코드, 네트워크에서 파라미터를 가져온 후 태그를 설정합니다
FTSdk.init()
getInfoFromNet(info){
HashMap<String, Object> globalContext = new HashMap<>();
globalContext.put("delay_key", info.value);
FTSdk.appendGlobalContext(globalContext)
}
코드 예시¶
HashMap<String, Object> globalContext = new HashMap<>();
globalContext.put("global_key", "global_value");
FTSdk.appendGlobalContext(globalContext);
HashMap<String, Object> rumGlobalContext = new HashMap<>();
rumGlobalContext.put("rum_key", "rum_value");
FTSdk.appendRUMGlobalContext(rumGlobalContext);
HashMap<String, Object> logGlobalContext = new HashMap<>();
logGlobalContext.put("log_key", "log_value");
FTSdk.appendLogGlobalContext(logGlobalContext);
val globalContext = hashMapOf<String, Any>(
"global_key" to "global_value"
)
FTSdk.appendGlobalContext(globalContext)
val rumGlobalContext = hashMapOf<String, Any>(
"rum_key" to "rum_value"
)
FTSdk.appendRUMGlobalContext(rumGlobalContext)
val logGlobalContext = hashMapOf<String, Any>(
"log_key" to "log_value"
)
FTSdk.appendLogGlobalContext(logGlobalContext)