您可以在搭載 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 執行階段,請輕觸切換鈕。
![圖表](https://developers.google.cn/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=8&hl=zh-tw)
在裝置上啟用 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。
您需要按照下列步驟,將註冊檔案強制下載到裝置上:
- 您應該會收到來自 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
現在可以開始在開發人員預覽版中呼叫隱私權保護 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
Attribution Reporting
adb shell device_config put adservices disable_measurement_enrollment_check "true"