配置设备以使用 Privacy Sandbox on Android

在阅读 Privacy Sandbox on Android 文档时，请使用开发者预览版或 Beta 版按钮选择您所使用的程序版本，因为不同版本的说明可能会有所不同。

显示 Privacy Sandbox 用户控制界面

Privacy Sandbox on Android 允许设备用户控制是否在其设备上启用可保护隐私的 API (PPAPI) 和 SDK 运行时。从开发者预览版 5 开始，用于显示用户控制界面的设置默认处于停用状态。出于开发和测试目的，您可能需要启用用户控制界面。如需启用用户控制界面，请使用以下 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 用户控制界面。

在设备上启用 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"