콘텐츠로 이동

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. 활성화 시 logCacheLimitCountrumCacheLimitCount는 무시됨
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를 사용하여 미전송 캐시 데이터를 정리합니다.

FTUnityBridge.clearAllData();

데이터 수동 동기화

SDKConfig.autoSynctrue로 설정한 경우 별도의 작업이 필요하지 않으며 SDK가 자동으로 동기화합니다.
SDKConfig.autoSyncfalse로 설정한 경우, 데이터 동기화 메서드를 수동으로 호출해야 합니다.

FTUnityBridge.flushSyncData();

SDK 종료

FTUnityBridge.DeInit();

관련 주제

문서 평가

이 페이지가 도움이 되었나요?