Protected Audience は、android.adservices.customaudience パッケージの一部として、カスタム オーディエンスへの参加とそこからの脱退を行うための一連の API を提供します。デバッグ目的で、カスタム オーディエンスのリスト表示と表示に使用できる CLI コマンドがあります。このガイドでは、広告テクノロジー デベロッパーが参加したカスタム オーディエンスの状態を検査する手順の概要を説明します。
セットアップ
セキュリティとプライバシー上の理由から、カスタム オーディエンスはデフォルトでは表示されず、デバッグ目的でのみ直接検査できます。次の要件が満たされている場合にのみ、これらのコマンドを使用して表示できます。
- システム全体のデベロッパー向けオプションが有効になっている
android:debuggable="true"は、CustomAudienceが参加したアプリの AndroidManifest.xml ファイルで宣言されています（joinCustomAudienceまたはfetchAndJoinCustomAudienceを使用）。- アプリによる広告の提案に関する同意がオンになっている
adservices シェルコマンドを有効にする
- デバイスを再起動して
adservicesプロセスを終了します。 adservicesが実行されていないことを確認します。次のコマンドでは、空の出力が想定されます。
adb shell ps -A | grep adservices
次に、adservices シェル コマンドを有効にするため、次のコマンドを実行します。
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
カスタム オーディエンスを一覧表示する
特定のカスタム オーディエンスを表示するには、次のコマンドを実行します。このコマンドでは、オーディエンスを作成したパッケージとして owner を、オーディエンスを管理する広告ネットワークの識別子として buyer を指定します。
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
出力は、配列 custom_audiences を含む JSON オブジェクトになります。この配列内の要素の構造は、次に説明するビュー カスタム オーディエンス コマンドの出力と一致します。
特定のカスタム オーディエンスを表示する
特定のカスタム オーディエンスを表示するには、次のコマンドを実行します。このコマンドでは、owner はオーディエンスを作成したパッケージ、buyer はオーディエンスを管理する広告ネットワークの識別子、name はオーディエンスの名前として指定します。
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
特定のカスタム オーディエンスを更新する
特定のカスタム オーディエンスのトリガーの毎日の更新を手動で表示するには、次のコマンドを実行します。このコマンドでは、owner はオーディエンスを作成したパッケージ、buyer はオーディエンスを管理する広告ネットワークの識別子、name はオーディエンスの名前として指定します。
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.