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

开始使用

首先，请执行以下步骤：

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

  • 注册：完成注册流程即可 使用与广告相关的 API。
  • 报名：您必须进行报名才能参与 Beta 版计划。 通过注册，您可以： <ph type="x-smartling-placeholder">
      </ph>
    • 使您自己的设备用于内部测试。
    • 在 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 进行测试和开发时，请查看版本 备注，并使用问题跟踪器报告问题和提供反馈。

使开发环境保持最新状态

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