11. AKS 로그(PTB_LOG)로 디버깅하기

AKS가 생성하는 모든 로그는 AKSLogManager/AppsKitSDKLogManager 호출, 광고 로드/표시 이벤트, SDK 내부 동작 등 출처에 관계없이 두 곳에 동시에 기록됩니다. 하나는 카테고리별 태그가 지정된 Logcat이고, 다른 하나는 §10의 AKS Logs 화면에 표시할 로그를 모아 두는 메모리 내 로그 저장소입니다.

Logcat 필터링

Android Studio의 Logcat에서 태그(tag:PTB_LOG)로 필터링하거나 adb를 사용하세요.

adb logcat -s PTB_LOG:* PTB_LOG_ADS:* PTB_LOG_ANALYTICS:*

• PTB_LOG — 일반 SDK 로그(초기화 순서, 모드 배너, 생명주기, 오류)
• PTB_LOG_ADS — 모든 광고 형식의 로드/표시 생명주기
• PTB_LOG_ANALYTICS — Firebase/MMP로 전송되는 이벤트. §7의 모든 sendAKSEvent/AKSLogManager.log 호출도 포함됩니다.

Logcat 없이 로그 확인하기

릴리스 빌드나 테스터 기기에서 디버깅하거나, adb를 연결할 수 없는 상황에서 지원 요청을 처리하는 경우에는 대신 Test Suite의 AKS Logs 화면을 여세요(§10). 동일한 로그가 기기에 그대로 표시되며 화면 내 검색도 지원하므로, 테스터가 직접 스크롤하거나 검색하여 확인하고 스크린샷을 보내줄 수 있습니다.

버전 불일치가 의심될 때 실제로 연동된 AKS AAR 버전을 가장 빠르게 확인하는 방법은 AppsKitSDKLogManager.logAarVersion()(§7.3 참고)을 호출하는 것입니다. 이 메서드는 PTB_LOG에 버전 배너를 출력합니다.