Android 版プライバシー サンドボックスを使用するようにデバイスを構成する

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 ランタイムを有効にするには、デバイスで切り替えボタンをタップします。

図
図 1. Android デバイスのプライバシー サンドボックスのユーザー コントロール UI。

デバイスのプライバシー サンドボックスを有効にする

前のセクションでは、ユーザーがデバイスでプライバシー サンドボックスを動作させるかどうかを指定できるようにしましたが、このセクションでは、デベロッパーが 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 を使用できるようにするために、追加の手順が必要になります。

次の手順に沿って、登録ファイルをデバイスに強制的にダウンロードする必要があります。

  1. プライバシー サンドボックスのサポートから、登録アカウント ID と、登録ファイルを指す URL を記載したメールが届きます。
  2. デベロッパー プレビュー リリースを動作させるデバイスで、次のコマンドを使用して登録リストをオーバーライドします。

    adb shell device_config put adservices mdd_measurement_manifest_file_url
    "<insert URL provided>"
    
  3. (省略可、ただし推奨)オーバーライドによって、前のステップで設定したパスが返されることを確認します。

    adb shell device_config get adservices mdd_measurement_manifest_file_url
    
  4. いずれかのプライバシー保護 API から API 呼び出しをトリガーします(たとえば、Attribution Reporting API から registerSource()、Topics API から getTopics()、FLEDGE API から joinCustomAudience() など)。この呼び出しは失敗するはずです。

  5. ダウンロード ジョブを強制的に実行します。

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
    
  6. これで、デベロッパー プレビューでプライバシー保護 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