빠른 시작¶

이 문서는 Unity RUM SDK의 가장 짧은 통합 경로를 제공하며, 최소한의 단계로 검증 가능한 데이터 업로드를 완료할 수 있도록 도와줍니다.

사전 준비¶

시작하기 전에 다음 준비를 완료하세요.

실제 사용자 모니터링(RUM) 에서 Unity Android 및 Unity iOS 앱을 각각 생성하고 해당 App ID를 획득합니다.
업로드 주소와 인증 방식을 확인합니다.
로컬 환경 배포: datakitUrl 준비
공용 네트워크 DataWay: datawayUrl 및 clientToken 준비
프로젝트에 ft-sdk-unity.unitypackage가 임포트되었는지 확인합니다.
프로젝트에 "com.unity.nuget.newtonsoft-json"이 설치되었는지 확인합니다.

통합 단계¶

FTSDK.prefab을 첫 번째 씬으로 드래그합니다.
앱 시작 시 FTUnityBridge.Install(...)을 호출합니다.
RUMConfig를 초기화하고 Android 및 iOS용 App ID를 전달합니다.
필요에 따라 LogConfig 및 TraceConfig를 초기화합니다.
앱을 실행하고 페이지 열기, 로그 출력 또는 네트워크 요청을 트리거합니다.
Unity 콘솔과 Guance 플랫폼에서 데이터가 성공적으로 업로드되었는지 확인합니다.

최소 초기화 예제¶

FTUnityBridge.Install(new SDKConfig
{
    // 로컬 환경 배포의 경우 datakitUrl 사용
    datakitUrl = "http://10.0.0.1:9529",
    // 공용 네트워크 DataWay의 경우 datawayUrl + clientToken 사용
    // datawayUrl = "https://open.dataway.url",
    // clientToken = "client-token",
    env = "prod",
    debug = true,
});

FTUnityBridge.InitRUMConfig(new RUMConfig
{
    androidAppId = "androidAppId",
    iOSAppId = "iOSAppId",
    sampleRate = 1.0f,
});

datakitUrl과 datawayUrl 중 하나만 선택하면 됩니다. 공용 네트워크 DataWay를 사용하는 경우 clientToken도 함께 전달하세요.

선택 사항: Log 및 Trace 초기화¶

FTUnityBridge.InitLogConfig(new LogConfig
{
    enableCustomLog = true,
    enableLinkRumData = true,
    sampleRate = 1.0f,
});

FTUnityBridge.InitTraceConfig(new TraceConfig
{
    enableNativeAutoTrace = true,
    enableLinkRumData = true,
    sampleRate = 1.0f,
});

선택 사항: Unity 예외 리스너 추가¶

Unity 예외를 RUM Error로 변환하려면 Application.logMessageReceived를 리스닝할 수 있습니다.

void OnEnable()
{
    Application.logMessageReceived += LogCallBack;
}

void OnDisable()
{
    Application.logMessageReceived -= LogCallBack;
}

void LogCallBack(string condition, string stackTrace, LogType type)
{
    if (type == LogType.Exception)
    {
        FTUnityBridge.AddError(stackTrace, condition);
    }
}

통합 성공 여부 확인¶

debug = true를 유지한 상태로 앱을 실행합니다.
페이지를 열거나 네트워크 요청을 한 번 실행합니다.
Unity 콘솔에서 SDK 초기화 및 데이터 동기화 관련 로그가 나타나는지 확인합니다.
Guance 콘솔로 돌아가 해당 앱에 RUM 데이터가 표시되는지 확인합니다.

추가 문제 해결이 필요한 경우 문제 해결을 참조하세요.

다음 단계¶

전체 설치 및 초기화 설명은 앱 통합을 계속 읽어보세요.
모든 초기화 매개변수 설명은 SDK 초기화를 읽어보세요.
RUM, Log, Trace의 상세 설정은 RUM 설정, Log 설정, Trace 설정을 읽어보세요.
프로젝트가 네이티브와 Unity 하이브리드 개발인 경우 네이티브와 Unity 하이브리드 개발을 읽어보세요.
View, Action, Resource, Error, LongTask를 수동으로 수집해야 하는 경우 데이터 수집 사용자 정의 규칙을 읽어보세요.