Privacy Sandbox for Android 使用入门

Privacy Sandbox on Android Beta 版计划提供稳定的 API。我们是 计划在 2023 年推出多个 Beta 版。您可以使用 Beta 版计划版本在 Android 13 及更高版本的移动设备上（适用于所有 API）和 Android 12 及更高版本的移动设备上（适用于 Attribution Reporting API [ARA]）构建和测试用于有限生产环境测试的解决方案。我们将开始支持一小部分设备，并会逐步支持更多设备。 要参与此计划，组织可以申请对有限数量的设备的访问权限。 并注册所有使用 Privacy Sandbox API 的应用。

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

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

Android SDK 扩展

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

开始使用

首先，请执行以下步骤：

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

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

第 2 步：设置开发环境

在 Android Studio 中设置 Privacy Sandbox on Android SDK。

第 3 步：配置 AdServices 权限

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

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

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

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

配置设置以启用（或停用）隐私设置 要在设备上运行的 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 进行测试和开发时，请查看版本 备注，并使用问题跟踪器报告问题和提供反馈。

使开发环境保持最新状态

我们强烈建议您让自己的开发环境 最新版本。这样可确保您能使用 并确保您的环境与 依赖项要想及时了解新曲上线的通知，请按以下步骤操作： 订阅电子邮件更新。