11. Depuração com logs do AKS (PTB_LOG)

Cada linha de log gerada pelo AKS — a partir de chamadas a AKSLogManager/AppsKitSDKLogManager, eventos de carregamento/exibição de anúncios e atividades internas do SDK — é enviada simultaneamente para dois destinos: o Logcat, com tags por categoria, e o acumulador de logs em memória que alimenta a tela AKS Logs descrita na §10.

Filtrando o Logcat

Filtre por tag no Logcat do Android Studio (tag:PTB_LOG) ou via adb:

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

• PTB_LOG — logs gerais do SDK (sequência de inicialização, mensagens de identificação do modo, ciclo de vida, erros)
• PTB_LOG_ADS — ciclo de vida do carregamento/exibição de anúncios de todos os formatos
• PTB_LOG_ANALYTICS — eventos enviados ao Firebase/MMPs, incluindo cada chamada a sendAKSEvent/AKSLogManager.log descrita na §7

Lendo logs sem o Logcat

Se você estiver depurando uma build de release, o dispositivo de um testador ou um chamado de suporte em que conectar via adb não seja uma opção, abra a tela AKS Logs da suíte de testes (§10) — ela exibe exatamente as mesmas linhas de log no próprio dispositivo, com busca na tela, para que o testador possa navegar pelos logs, pesquisar diretamente ou enviar uma captura de tela para você.

AppsKitSDKLogManager.logAarVersion() (veja a §7.3) é a maneira mais rápida de confirmar qual versão do AAR do AKS está de fato integrada quando você suspeita de uma divergência de versões — o método exibe a mensagem de identificação da versão em PTB_LOG.