設定使用 Android 版 Privacy Sandbox 的裝置

您可以為裝置啟用或停用多項設定 在 Android 上搭載 Privacy Sandbox

顯示 Privacy Sandbox 使用者控制項 UI

Android 版 Privacy Sandbox 可讓裝置使用者控管自己的裝置是否要啟用隱私權保護 API (PPAPI) 和 SDK 執行階段。自開發人員預覽版 5 起，系統會預設停用顯示使用者控制項 UI 的設定。為進行開發和測試，您可能會想要啟用使用者控制項 UI。如要啟用使用者控制項 UI，請使用 以下 adb 指令：

針對 Beta 版和正式版：

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

開發人員預覽版：

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity

根據預設，系統會停用裝置上的使用者控制項。如要啟用裝置上的 Privacy Sandbox API 和 SDK 執行階段，請輕觸切換鈕。

圖表
Android 裝置的 Privacy Sandbox 使用者控制項 UI。

在裝置上啟用 Privacy Sandbox

上一節的說明可讓裝置使用者選擇是否讓 Privacy Sandbox 在裝置上執行，本節則說明開發人員如何使用 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 msmt_api_app_allow_list \"\*\" // for attribution
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

註冊後的步驟

完成註冊程序後，您需要再完成幾個步驟，讓裝置準備使用 Privacy Sandbox API。

您需要按照下列步驟，將註冊檔案強制下載到裝置上：

  1. 您應該會收到來自 Privacy Sandbox 支援團隊的電子郵件，信中會附上您的註冊帳戶 ID 和指向註冊檔案的網址。

  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()，或是 Protected Audience API 的 joinCustomAudience())。這個呼叫預計會失敗。

  5. 強制執行下載工作。

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

  6. 現在可以開始在開發人員預覽版中呼叫隱私權保護 API。您在步驟 4 發出的呼叫現在應該會成功。

停用註冊功能

在開發人員預覽版中，您可以執行下列停用註冊功能的 adb 指令，無須註冊就能存取 Protected Audience API 和 Topics API。

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Topics

adb shell setprop debug.adservices.disable_topics_enrollment_check true

歸因報表

adb shell device_config put adservices disable_measurement_enrollment_check "true"