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

AKSLogManager/AppsKitSDKLogManager 호출, 광고 로드/표시 이벤트, SDK 내부 동작 등에서 AKS가 생성하는 모든 로그는 두 곳에 동시에 기록됩니다. 하나는 카테고리별 태그가 지정된 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). Logcat과 완전히 동일한 로그가 기기에 표시되고 화면 내 검색도 지원하므로, 테스터가 직접 스크롤하거나 검색하고 스크린샷을 찍어 개발자에게 전달할 수 있습니다.

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