詳閱 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 執行階段,請輕觸切換鈕。

在裝置上啟用 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
指令,無須註冊就能存取 Protected Audience API 和 Topics API。
Protected Audience
adb shell setprop debug.adservices.disable_fledge_enrollment_check true
主題
adb shell setprop debug.adservices.disable_topics_enrollment_check true
歸因報表
adb shell device_config put adservices disable_measurement_enrollment_check "true"
為您推薦
- 注意:系統會在 JavaScript 關閉時顯示連結文字
- 版本資訊
- 歸因報表:跨應用程式和網站評估
- 使用 Protected Audience API 支援自訂指定目標對象