設定使用 Android 版 Privacy Sandbox 的裝置

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


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

顯示 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.activities.AdServicesSettingsMainActivity

根據預設,系統會停用裝置上的使用者控制項。如要啟用裝置上的 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 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

Attribution Reporting

adb shell device_config put adservices disable_measurement_enrollment_check "true"