실시간 디버깅

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

주의

SDK 디버그 모드는 연동 디버깅에만 사용하며, 운영 환경에서는 절대 사용하지 마십시오.

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

1. SDK 로그 출력

local tdAnalytics = require "ThinkingDataSdk"
-- enable log
TDAnalytics.enableLog(true)

2. 디버그 모드 활성화

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

1. DebugConsumer 사용

다음은 DebugConsumer를 사용하는 예시 코드입니다.

-- DebugConsumer: 데이터를 한 건씩 전송합니다. 문제가 발생하면 로그와 예외로 유저에게 알립니다. 운영 환경에서는 사용하지 않는 것을 권장합니다
local tdAnalytics = require "ThinkingDataSdk"
local consumer = tdAnalytics.TDDebugConsumer("SERVER_URL", "APP_ID", false, "DeviceId")
local sdk = tdAnalytics(consumer)
--게스트 ID 설정 "ABCDEFG123456789"
local distinctId = "ABCDEFG123456789"
--계정 ID 설정 "AE_10001"
local accountId = "AE_10001"
--이벤트 속성 설정
local properties = {}
--유저의 IP 주소를 설정합니다. AE 시스템은 IP 주소를 기반으로 유저의 지리적 위치 정보를 분석하며, 설정하지 않으면 기본적으로 전송하지 않습니다
properties["#ip"] = "192.168.1.1"
properties["#device_id"] = "te_device_id"
--이벤트를 전송합니다. 유저의 게스트 ID와 계정 ID를 포함하며, 계정 ID와 게스트 ID의 순서에 주의하십시오. 두 값이 모두 비어 있으면 안 됩니다
sdk:track(accountId, distinctId, "payment", properties)

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

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

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