設定使用 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 執行階段，請輕觸切換鈕。

可在裝置上切換 Privacy Sandbox API Beta 版的 Android 頁面。
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"