콘텐츠로 이동

수동 연동

ft-plugin을 사용하지 않고 SDK 연동하기

Guance는 Android Gradle Plugin Transformation을 통한 코드 주입으로 데이터를 자동 수집합니다. 그러나 일부 호환성 문제로 ft-plugin 또는 ft-plugin-legacy를 사용할 수 없는 경우가 있습니다. 영향 범위는 다음과 같습니다.

  • RUM의 Action, Resource
  • android.util.Log
  • Java 및 Kotlin println 콘솔 로그 자동 수집
  • 심볼 파일 자동 업로드

현재 이러한 경우에는 수동 연동 방식을 사용할 수 있습니다.

Application 시작 이벤트

소스 코드 예시는 DemoForManualSet.kt를 참조하세요.

// Application
@Override
public void onCreate() {
    super.onCreate();
    // SDK 초기화 전에 호출해야 함
    FTAutoTrack.startApp(null);
    // SDK 설정 구성
    setSDK(this);
}
// Application
override fun onCreate() {
    super.onCreate()
    // SDK 초기화 전에 호출해야 함
    FTAutoTrack.startApp(null)
    // SDK 설정 구성
    setSDK(this)
}

사용자 작업 수동 추가

버튼 등의 이벤트는 트리거 지점에서 직접 추가해야 합니다. 여기서는 Button onClick 이벤트를 예로 듭니다. 소스 코드 예시는 ManualActivity.kt를 참조하세요:

view.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        FTRUMGlobalManager.get().startAction("[action button]", "click");
    }
});
view.setOnClickListener {
    FTRUMGlobalManager.get().startAction("[action button]", "click")
}

OkHttp Resource / Trace 수동 연동

OkHttp는 addInterceptor, eventListener 방식으로 Resource와 Trace를 연동할 수 있습니다. 예시는 다음과 같습니다. 소스 코드 예시는 ManualActivity.kt를 참조하세요:

OkHttpClient.Builder builder = new OkHttpClient.Builder()
    .addInterceptor(new FTTraceInterceptor())
    .addInterceptor(new FTResourceInterceptor())
    .eventListenerFactory(new FTResourceEventListener.FTFactory());
//.eventListenerFactory(new FTResourceEventListener.FTFactory(true));
OkHttpClient client = builder.build();
val builder = OkHttpClient.Builder()
    .addInterceptor(FTTraceInterceptor())
    .addInterceptor(FTResourceInterceptor())
    .eventListenerFactory(FTResourceEventListener.FTFactory())
    //.eventListenerFactory(new FTResourceEventListener.FTFactory(true))
val client = builder.build()

다른 네트워크 프레임워크는 FTRUMGlobalManager.startResource, stopResource, addResource 및 FTTraceManager.getTraceHeader를 직접 구현해야 합니다. 구체적인 구현 방법은 소스 코드 예시 ManualActivity.kt를 참조하세요.

OkHttp Visitor ID 수동 연동

ft-sdk >= 1.7.6-alpha04인 경우 먼저 방문자 식별자 Visitor ID에 따라 초기화를 완료한 다음, FTVisitorIdInterceptor.install(builder)를 통해 비즈니스 OkHttpClient에 인터셉터를 설치합니다. Visitor ID Header만 주입할 때는 Resource 또는 Trace 인터셉터를 설치할 필요가 없습니다:

OkHttpClient.Builder builder = new OkHttpClient.Builder();
FTVisitorIdInterceptor.install(builder);
OkHttpClient client = builder.build();
val builder = OkHttpClient.Builder()
FTVisitorIdInterceptor.install(builder)
val client = builder.build()

Resource / Trace도 함께 수집해야 한다면, 이전 섹션 예시에서 다른 인터셉터를 추가한 후 builder.build() 전에 install(builder)를 호출하면 됩니다. 이 메서드는 Visitor ID 적용 인터셉터를 FTResourceInterceptor 앞에 배치하고, 리디렉션 보호 인터셉터를 현재 네트워크 인터셉터 목록 끝에 추가합니다. 다른 인터셉터 구성을 완료한 후 호출하세요.

install(builder)를 사용하세요. addInterceptor(new FTVisitorIdInterceptor())만으로 연동하지 마세요. 그렇게 하면 리디렉션 보호가 누락됩니다. 동일한 Builder에서 install을 여러 번 호출해도 Visitor ID 인터셉터가 중복 설치되지 않으며, Resource 또는 Trace 수집이 자동으로 활성화되지도 않습니다.

OkHttp WebSocket Resource 수동 연동

ft-sdk >= 1.7.5인 경우, WebSocket 자동 계측을 지원하는 ft-plugin을 사용하지 않는다면 FTWebSocket을 통해 OkHttp WebSocket 핸드셰이크 Resource를 명시적으로 수집할 수 있습니다. 먼저 FTRUMConfig.setEnableTraceUserResource(true)를 활성화해야 합니다. 기존 Resource URL 필터링 및 RUM 샘플링 규칙은 계속 적용됩니다. 수집 범위는 핸드셰이크 성공, 서버 측 거부 또는 실패뿐이며, 연결 유지 시간은 집계하지 않고 메시지 내용도 수집하지 않습니다.

호출 지점이 적다면 FTWebSocket.newWebSocket()을 직접 사용할 수 있습니다:

WebSocket socket = FTWebSocket.newWebSocket(okHttpClient, request, listener);
val socket = FTWebSocket.newWebSocket(okHttpClient, request, listener)

프로젝트에서 의존성 주입으로 WebSocket factory를 통일되게 제공한다면, 한 번 래핑한 후 WebSocket.Factory로 주입할 수 있습니다:

WebSocket.Factory factory = FTWebSocket.wrap(okHttpClient);
WebSocket socket = factory.newWebSocket(request, listener);
val factory: WebSocket.Factory = FTWebSocket.wrap(okHttpClient)
val socket = factory.newWebSocket(request, listener)

wrap()은 여러 번 호출할 수 있습니다. ft-plugin >= 1.3.8이 동시에 활성화된 경우에도 동일한 요청의 핸드셰이크 Resource는 한 번만 수집됩니다. 서드파티 라이브러리가 내부에서 OkHttpClient를 보유하고 있고 newWebSocket() 호출 지점을 열어두지 않으며 WebSocket.Factory 전달도 허용하지 않는 경우에는 여전히 ft-plugin 자동 계측을 사용해야 합니다.

WebView 수동 구성

FTAutoTrack.setUpWebView(webview);
//loadUrl 로드 작업 전에 구성
FTAutoTrack.setUpWebView(webview)
//loadUrl 로드 작업 전에 구성

문서 평가

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