Protected Audience は、android.adservices.customaudience パッケージの一部として、カスタム オーディエンスへの参加と脱退を行うための一連の API を提供します。デバッグ用に、カスタム オーディエンスの一覧と表示に使用できる CLI コマンドがあります。このガイドでは、広告テクノロジー デベロッパーが、参加したカスタム オーディエンスの状態を検査するために必要な手順について概説します。
セットアップ
セキュリティとプライバシー上の理由から、カスタム オーディエンスはデフォルトでは表示されず、デバッグ目的でのみ直接検査できます。次の要件に該当する場合にのみ、これらのコマンドを使用して表示されます。
- システム全体の開発者向けオプションが有効になっています
android:debuggable="true"
が、(joinCustomAudience
またはfetchAndJoinCustomAudience
を使用して)CustomAudience
を結合したアプリの AndroidManifest.xml ファイルで宣言されている- アプリによる広告の提案に対する同意をオンに切り替える
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
を指定し、オーディエンスを管理する広告ネットワークの ID として buyer
を指定して、次のコマンドを実行します。
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
出力は、配列 custom_audiences
を含む JSON オブジェクトです。この配列内の要素の構造は、次に説明するカスタム オーディエンスの表示コマンドの出力と一致します。
特定のカスタム オーディエンスを表示する
特定のカスタム オーディエンスを表示するには、オーディエンスを作成したパッケージとして owner
、オーディエンスを管理する広告ネットワークの ID として 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.