Privacy Sandbox for Android 使用入门

Privacy Sandbox on Android Beta 版计划提供稳定的 API。我们计划在 2023 年发布多个 Beta 版。您可以使用 Beta 版计划版本为在 Android 13 移动设备上进行有限生产测试构建和测试解决方案。我们将开始支持一小部分设备,并逐步支持更多设备。若要加入该计划,组织可以申请访问有限数量的设备,还可以注册任何使用 Privacy Sandbox API 的应用。

对于 SDK 运行时,我们有一个封闭式 Beta 版测试,让开发者能够测试面向选定应用的支持运行时的 SDK 分发。

如需使用 Beta 版,开发者必须使用 API 级别 33 SDK 扩展更新来编译其解决方案。

Android SDK 扩展

Beta 版中的稳定 API 使用新的 Android SDK 扩展版本方法提供。此版本方法使我们能够在主要版本之间发布稳定的 Android 功能。它提供了一种新的版本控制机制,可让您使用 Google Play 系统更新在多个 API 级别上为应用提供新的 API。Privacy Sandbox on Android SDK 扩展称为广告服务扩展详细了解 Android SDK 扩展

开始使用

首先,请执行以下步骤:

第 1 步:报名和注册 Beta 版计划

  • 注册:完成注册流程即可使用与广告相关的 API。
  • 注册:您必须register才能参与 Beta 版计划。 通过注册,您可以:
    • 使您自己的设备用于内部测试。
    • 在 Google Play 商店中指定有限数量的已发布应用,这些应用能够直接集成可保护隐私的 API 或集成使用这些 API 的 SDK 解决方案。
    • 使用 Google Play 商店测试支持运行时的 SDK 分发。如果您只需要在设备上测试 SDK 运行时,则不需要执行此步骤。

第 2 步:设置开发环境

在 Android Studio 中设置 Privacy Sandbox on Android SDK

第 3 步:配置 AdServices 权限

针对目标 API 管理的资源声明 API 专属权限并配置 SDK 访问权限

第 4 步:设置设备或模拟器映像

如需执行端到端测试,您需要与受支持的 Android 13 设备交互,或使用相应 SDK 扩展的模拟器映像

第 5 步:配置设备以使用 Privacy Sandbox on Android

配置设置以启用(或停用)Privacy Sandbox on Android,以便在设备上运行。

排查已知问题

为了避免 Android 12 及更低版本设备上的 PP API 集成出现已知问题,与适用于 Android 12 及更低版本设备的广告服务 API 集成时,开发者应执行以下操作:

  1. 验证客户端应用的清单文件是否包含 <uses-library> extservices 标记。相关标记如下所示:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. 如果您使用的是 androidx.privacysandbox.ads Jetpack 库,请确保您使用的是 1.1.0-beta05 或更高版本。

有哪些可用的开发者资源?

Privacy Sandbox on Android Beta 版计划包含以下工具和资源。

SDK 和模拟器系统映像

使用 Android Studio,您可以通过 SDK 管理器下载最新的广告服务扩展和模拟器系统映像。详细了解如何设置开发环境和设置 API 访问权限。

API 参考文档

我们提供完整的 API 参考文档

支持与反馈

在使用 Privacy Sandbox on Android 进行测试和开发时,请查看版本说明,并使用问题跟踪器报告问题并提供反馈。

使开发环境保持最新状态

我们强烈建议您将开发环境保持为最新版本。这可确保您获得最新的功能和安全补丁,并确保您的环境与最新版本的依赖项兼容。如需接收新版本的通知,请订阅电子邮件更新