配置设备以使用 Privacy Sandbox on Android

您可为运行 Privacy Sandbox on Android 的设备启用或停用诸多设置。

显示 Privacy Sandbox 用户控制界面

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

对于 Beta 版和正式版 build：

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 运行时，请点按设备上的切换开关。

用于在设备上切换 Privacy Sandbox API Beta 版的 Android 页面。
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"