本頁面由 Cloud Translation API 翻譯而成。

設定裝置以使用 Android 版 Privacy Sandbox

詳閱 Android 版 Privacy Sandbox 說明文件時，請利用「開發人員預覽版」或「Beta 版」按鈕選取您要使用的計畫版本，因為兩者的操作說明可能不盡相同。

顯示 Privacy Sandbox 使用者控制項 UI

Android 版 Privacy Sandbox 可讓裝置使用者控管自己的裝置是否要啟用隱私維護 API (PPAPI) 和 SDK 執行階段。從開發人員預覽版 5 開始，系統預設停用使用者控制項 UI 的設定。在開發與測試方面，您可能需要啟用使用者控制項 UI。如要啟用使用者控制項 UI，請使用下列 adb 指令：

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

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

**圖 1.** 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 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。

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

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

在搭載開發人員預覽版的裝置上，使用這個指令覆寫註冊清單。

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

強制執行下載工作。

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

現在可以開始在開發人員預覽版中呼叫 Privacy Preserve API。您在步驟 4 發出的呼叫現在應該會成功。

停用註冊模式

在開發人員預覽版中，您可以透過執行以下註冊停用 adb 指令，直接存取受保護的目標對象和 Topics API。您必須完成註冊才能使用 Attribution Reporting API。

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Topics

adb shell setprop debug.adservices.disable_topics_enrollment_check true