실시간 디버깅

최근 업데이트 2026. 10. 03.

SDK 연동 중에는 IDE 콘솔에서 SDK 로그를 확인하거나 AE의 Debug 기능을 사용하여 실시간으로 디버깅할 수 있습니다.

1. SDK 로그 출력

SDK 초기화 시 enableLog를 true로 설정하여 SDK 로그 스위치를 켤 수 있습니다. 켜면 IDE 콘솔에 전송되는 데이터가 출력됩니다.

var config = {
    appId: "xxx",
    serverUrl: "xxx",
    enableLog:true
};
TDAnalytics.init(config);

2. 디버그 모드 활성화

디버그 모드를 활성화하려면 다음 두 단계를 진행해야 합니다:

1. 클라이언트에서 디버그 모드 활성화

다음은 클라이언트에서 디버그 모드를 활성화하는 예시 코드입니다:

/*
실행 모드를 Debug 모드로 설정
none: 데이터를 캐시에 저장하고 일정한 캐시 전략에 따라 전송하며, 기본값은 NORMAL 모드입니다. 운영 환경에서 사용을 권장합니다
debug: 데이터를 한 건씩 전송합니다. 문제가 발생하면 로그와 예외로 사용자에게 알립니다. 운영 환경에서는 사용을 권장하지 않습니다
debugOnly: 데이터 검증만 하고 적재하지 않습니다. 운영 환경에서는 사용을 권장하지 않습니다
 */
var config = {
  appid: "YOUR_APPID",
  server_url: "YOUR_SERVER_URL",
  debugMode: "debug"
};
TDAnalytics.init(config);

2. AE 백엔드에서 디버그 디바이스 추가

디버그 모드가 운영 환경에 배포되는 것을 막기 위해 지정된 디바이스에서만 디버그 모드를 활성화할 수 있도록 제한합니다. 클라이언트에서 디버그 모드를 활성화했고, 디바이스 ID가 AE 백엔드의 데이터 → 트래킹 관리 → 디버그 모드 페이지에 추가된 디바이스만 디버그 모드를 활성화할 수 있습니다. 추가 방법: 페이지 오른쪽 상단의 디바이스 연동을 클릭하고 디바이스 선택 드로어에서 디바이스 추가를 클릭한 후 디바이스 ID를 입력합니다.

디바이스 ID는 다음 세 가지 방법으로 확인할 수 있습니다:

• AE 플랫폼 이벤트 데이터의 #device_id 속성
• 클라이언트 로그: SDK 초기화가 완료되면 디바이스 DeviceId가 출력됩니다
• 인스턴스 인터페이스 호출: 디바이스 ID 가져오기

디버그 모드는 데이터 수집 품질과 App의 안정성에 영향을 줄 수 있으므로 연동 단계의 데이터 검증에만 사용하고 운영 환경에서는 사용하지 마십시오.