Android 版プライバシー サンドボックスのドキュメントをご覧になる際は、[デベロッパー プレビュー] または [ベータ版] ボタンで対象のプログラム バージョンを選択してください(手順が異なる場合があります)。
Android 版プライバシー サンドボックスを動作させるデバイスに対して有効または無効にできる設定は複数あります。
プライバシー サンドボックスのユーザー コントロール UI を表示する
Android 版プライバシー サンドボックスでは、デバイスでプライバシー保護 API(PPAPI)と SDK ランタイムを有効にするかどうかをデバイス ユーザーが管理できます。デベロッパー プレビュー 5 時点で、ユーザー コントロール UI を表示する設定はデフォルトで無効になっています。開発とテストのために、ユーザー コントロール UI を有効にすることをおすすめします。ユーザー コントロール UI を有効にするには、次の adb
コマンドを使用します。
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity
デフォルトでは、デバイスのユーザー コントロールは無効に設定されています。プライバシー サンドボックスの API と SDK ランタイムを有効にするには、デバイスで切り替えボタンをタップします。

デバイスのプライバシー サンドボックスを有効にする
前のセクションでは、ユーザーがデバイスでプライバシー サンドボックスを動作させるかどうかを指定できるようにしましたが、このセクションでは、デベロッパーが adb
コマンドを使用してデバイスで API を有効にする方法について説明します。
デバイスの PPAPI を有効にする
PPAPI を有効にする
adb shell device_config put adservices ppapi_app_allow_list \"*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"*\"
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true
PPAPI を無効にする
開発とテストのために、次のコマンドを実行して、デバイスの PPAPI アクセスを有効または無効にできます。
有効にするには、false
に設定します。
adb shell device_config put adservices global_kill_switch false
無効にするには、true
に設定します。
adb shell device_config put adservices global_kill_switch true
デバイスの SDK ランタイムを有効にする
adb shell device_config put adservices disable_sdk_sandbox false
登録後の手順
登録が完了したら、デバイスでプライバシー サンドボックスの API を使用できるようにするために、追加の手順が必要になります。
次の手順に沿って、登録ファイルをデバイスに強制的にダウンロードする必要があります。
- プライバシー サンドボックスのサポートから、登録アカウント ID と、登録ファイルを指す URL を記載したメールが届きます。
デベロッパー プレビュー リリースを動作させるデバイスで、次のコマンドを使用して登録リストをオーバーライドします。
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(省略可、ただし推奨)オーバーライドによって、前のステップで設定したパスが返されることを確認します。
adb shell device_config get adservices mdd_measurement_manifest_file_url
いずれかのプライバシー保護 API から API 呼び出しをトリガーします(たとえば、Attribution Reporting API から
registerSource()
、Topics API からgetTopics()
、FLEDGE API からjoinCustomAudience()
など)。この呼び出しは失敗するはずです。ダウンロード ジョブを強制的に実行します。
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
これで、デベロッパー プレビューでプライバシー保護 API を呼び出せるようになり、ステップ 4 で行った呼び出しが成功するようになりました。
登録を無効にする
デベロッパー プレビュー リリースでは、次の adb
コマンドを実行して登録を無効にすることで、登録なしで FLEDGE API と Topics API にアクセスできます。Attribution Reporting API には登録が必要です。
FLEDGE
adb shell setprop debug.adservices.disable_fledge_enrollment_check true
トピック
adb shell setprop debug.adservices.disable_topics_enrollment_check true