Apps Kit SDK logoApps Kit SDK
ドキュメント · AppsKitSDK (AKS) — Android 組み込みガイド

10. 組み込みの設定ダッシュボード / テストスイート

AKS には Compose ベースの診断画面が組み込まれています。専用のデバッグビルドやマニフェストへの追加は不要で、呼び出し元の Activity 上に全画面ダイアログとして表示されます。デバッガーを接続せずに、AKS が認識している状態(リモート設定、広告の状態、同意状況)を確認できます。

開き方

Activity の参照を取得できる場所であれば、どこからでも次のコードを呼び出せます。独自の設定画面に設けた隠し項目、アプリのバージョン番号の長押し、デバッグ専用ボタンなど、任意の操作をトリガーとして実装してください(AKS はトリガーを自動で追加しません)。

kotlin
AppsKitSDK.showGodModeScreen(PlatformActivity(this))

これにより AKS Configuration Dashboard(AKS 設定ダッシュボード) が開き、次の項目を確認できます。

  • Enable Ads(広告の有効化) — 切り替えスイッチ。GDPR Status(GDPR 同意状況) — AdsManager.isUserConsentsProvided() の結果を反映した、読み取り専用の TRUE/FALSE 表示。
  • Check Configurations(設定の確認) — テストスイートを開きます(後述)。
  • Placeholder Calls(プレースホルダー別の広告呼び出し) — プレースホルダーごとの広告呼び出し状況を、整形済みの JSON ダンプで表示します。
  • Placeholder Load Stats(プレースホルダー別の読み込み統計) — プレースホルダーごとの読み込み試行回数、成功回数、失敗回数を表示します。
  • AKS Logs(AKS ログ) — Logcat で確認できるものと同じ蓄積済みのログ履歴を表示し、画面上で検索できます(§11 を参照)。

テストスイート

Check Configurations(設定の確認) をタップすると、テストスイート画面が開きます。この画面には、テストモード / 開発モードのフラグ、現在有効な設定がデフォルト(オフライン)設定か取得済みのリモート設定か、AKS SDK のバージョン、AKS が取得したリモート設定の生の JSON、インタースティシャル広告・リワード広告・アプリ起動時広告のリアルタイムの状態と最終表示日時、現在のセッション数と日数カウントが表示されます。

ダッシュボードを経由せずに、直接開くこともできます。

kotlin
AppsKitSDK.showAKSTestSuit(PlatformActivity(activity))

どちらの呼び出しにも、必要なのは PlatformActivity だけです。それ以外の情報(広告の状態、設定、セッションデータ)は、AKS が内部で読み取ります。