SDK 초기화¶
이 문서는 Unity SDK 초기화 및 런타임 기능 관련 내용을 다룹니다.
기본 설정¶
FTUnityBridge.Install(new SDKConfig
{
datakitUrl = "http://10.0.0.1:9529",
env = "prod",
debug = true,
});
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| datakitUrl | string | 예 | 로컬 환경 배포(Datakit) 전송 URL 주소, 예: http://10.0.0.1:9529, 포트 기본값 9529, SDK를 설치한 디바이스에서 해당 주소에 접근 가능해야 합니다. 참고: datakitUrl과 datawayUrl 중 하나만 선택 |
| datawayUrl | string | 예 | 공용 네트워크 DataWay 전송 URL 주소, [RUM] 애플리케이션에서 획득, 예: https://open.dataway.url, SDK를 설치한 디바이스에서 해당 주소에 접근 가능해야 합니다. 참고: datakitUrl과 datawayUrl 중 하나만 선택 |
| clientToken | string | 예 | 인증 토큰, datawayUrl과 함께 사용해야 함 |
| debug | boolean | 아니요 | Debug 로그 출력 허용 여부 설정, 기본값 false |
| env | string | 아니요 | 환경, 기본값 prod, 임의의 문자, 단일 단어 권장(예: test) |
| serviceName | string | 아니요 | 소속 비즈니스 또는 서비스 이름 설정, 기본값: df_rum_ios, df_rum_android |
| globalContext | object | 아니요 | 커스텀 태그 추가, 자세한 규칙은 커스텀 태그 사용 참조 |
| autoSync | boolean | 아니요 | 데이터 수집 후 서버에 자동 동기화 여부. 기본값 YES. NO인 경우 flushSyncData()를 사용하여 데이터 동기화를 직접 관리 |
| syncPageSize | number | 아니요 | 동기화 요청 항목 수 설정. 범위 [5,), 요청 항목 수가 많을수록 데이터 동기화에 더 많은 컴퓨팅 리소스가 사용됨, 기본값 10 |
| syncSleepTime | number | 아니요 | 동기화 간격 시간 설정. 범위 [0,5000], 기본값: 설정되지 않음 |
| enableDataIntegerCompatible | boolean | 아니요 | Web 데이터와 공존해야 하는 경우 활성화 권장. SDK 1.1.0 이후 버전에서 기본 활성화 |
| compressIntakeRequests | boolean | 아니요 | 업로드 동기화 데이터를 deflate 압축, 기본값 비활성화, SDK 1.1.0 이상 버전 지원 |
| enableLimitWithDbSize | boolean | 아니요 | DB를 사용한 데이터 크기 제한 활성화, 기본값 100MB, 단위: Byte. 활성화 시 logCacheLimitCount와 rumCacheLimitCount는 무시됨 |
| dbCacheLimit | number | 아니요 | DB 캐시 제한 크기. 범위 [30MB,), 기본값 100MB, 단위: byte |
| dbDiscardStrategy | string | 아니요 | 데이터베이스 데이터 폐기 규칙 설정: discard 새 데이터 폐기(기본값), discardOldest 오래된 데이터 폐기 |
| dataModifier | object | 아니요 | 단일 필드 변경. SDK 1.1.0 이상 지원, 예시는 데이터 수집 마스킹 참조 |
| lineDataModifier | object | 아니요 | 단일 데이터 변경. SDK 1.1.0 이상 지원, 예시는 데이터 수집 마스킹 참조 |
사용자 정보 바인딩 및 해제¶
사용 방법¶
/// <summary>
/// RUM 사용자 정보 바인딩
/// </summary>
/// <param name="userId">사용자 고유 ID</param>
public static async Task BindUserData(string userId)
/// <summary>
/// RUM 사용자 정보 바인딩
/// </summary>
/// <param name="userData"></param>
public static async Task BindUserData(UserData userData)
public static async Task UnBindUserdata()
| 메서드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
| userId | string | 예 | 사용자 ID |
| userName | string | 아니요 | 사용자 이름 |
| userEmail | string | 아니요 | 사용자 이메일 |
| extra | dictionary | 아니요 | KV 방식으로 할당, 추가 규칙은 애플리케이션 연결 참조 |
코드 예제¶
FTUnityBridge.BindUserData(new UserData
{
userId = "userid",
userName = "userName",
userEmail = "someone@email.com",
extra = new Dictionary<string, string>
{
{"custom_data", "custom data"}
}
});
FTUnityBridge.UnBindUserdata();
런타임 기능¶
SDK 캐시 데이터 정리¶
FTUnityBridge를 사용하여 미전송 캐시 데이터를 정리합니다.
데이터 수동 동기화¶
SDKConfig.autoSync를 true로 설정한 경우 별도의 작업이 필요하지 않으며 SDK가 자동으로 동기화합니다.
SDKConfig.autoSync를 false로 설정한 경우, 데이터 동기화 메서드를 수동으로 호출해야 합니다.
SDK 종료¶
관련 주제¶
- RUM 초기화 및 수집 기능은 RUM 설정 참조
- Log 초기화 및 로그 출력은 Log 설정 참조
- Trace 초기화 및 분산 추적은 Trace 설정 참조
- 네이티브 프로젝트와 Unity 혼합 연결 시나리오는 네이티브와 Unity 혼합 개발 참조