选择开发者计划

Privacy Sandbox on Android 提供了两项计划,旨在帮助广告技术平台和应用开发者设计、测试以及为用户将来推出的正式版做好准备。

  • 开发者预览版计划 - 使用开发者预览版计划对建议的 API 进行初始测试,评估如何将其与您的解决方案集成,并提供反馈。我们将逐步在此计划中引入新的 API 和功能,并将稳定版 API 升级到 Beta 版计划。

  • Beta 版计划 - 您可以使用 Beta 版计划将您的解决方案与稳定版 Privacy Sandbox API 集成,以在有限数量的 Android 13 设备上进行正式版测试,我们也将逐步增加支持的设备数量。您可以通过 Extension SDK 访问 Beta 版中的 API,这是一种在主要 Android 版本之外提供功能的新机制。

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

开发者预览版计划

Privacy Sandbox on Android 开发者预览版计划继续提供一种途径,让您能够对建议的 API 进行初始测试、提供反馈,并评估如何在您的解决方案中采用这些 API。新的公共 API 和行为将首先出现在开发者预览版计划中。您将有权访问开发者预览版 SDK、工具和文档。这些 API 稳定后,它们便会升级到 Beta 版计划中发布的最终 API。

开始使用

首先,请执行以下步骤:

第 1 步:为贵组织报名 Privacy Sandbox

您需要完成报名流程,才能使用与广告相关的 API。

第 2 步:设置开发环境

您需要在 Android Studio 中设置 Privacy Sandbox on Android SDK。

第 3 步:配置 AdServices 权限

您需要声明 API 专属权限,并配置对目标 API 管理的资源的 SDK 访问权限。

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

如需执行端到端测试,您需要与受支持的 Android 13 设备交互。您可以下载并配置开发者预览版 Pixel 设备映像,也可以使用模拟器映像。

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

您需要配置多项设置,以在设备上启用(或停用)Privacy Sandbox on Android。

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

Privacy Sandbox on Android 开发者预览版计划包含以下工具和资源。

SDK

使用 Android Studio,您可以通过 SDK 管理器下载 Privacy Sandbox on Android 开发者预览版(基于 Android 13)。如需了解详情,请参阅有关设置开发环境和访问可保护隐私的 API 的指南。

系统映像

开发者预览版包含一些可用于开发和测试的系统映像选项:

请访问“下载”页面,获取用于设备端开发和测试的映像。

预览版 API

Privacy Sandbox on Android 开发者预览版最初提供的系统和 Android 库仅用于开发用途,不具备标准的 API 级别。在此期间,如果您想以该新平台为目标平台并使用新的 Privacy Sandbox on Android API 进行构建,则必须以 Privacy Sandbox on Android 的开发者预览版为目标平台。为此,请更新应用的 build 配置。

Privacy Sandbox on Android 开发者预览版 SDK 基于 Android 13 构建。如果您的应用以 Privacy Sandbox 测试为目标,还应考虑 Android 13 Beta 版中引入的更改

Privacy Sandbox on Android 开发者预览版可让您抢先体验新建议的 API。这意味着部分功能可能尚未实现,并且这些 API 可能会更改。特别是,开发者预览版 build 中的预览版 API 并不适合在最终用户设备上部署

API 参考文档

我们提供完整的开发者预览版 API 参考文档。请注意,这些新 API 还处于开发阶段,只有在使用 Privacy Sandbox on Android 开发者预览版 SDK 进行构建时才能使用这些 API。

支持与反馈

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

时间表和更新

Privacy Sandbox on Android 开发者预览版计划将持续整个 2023 年。您可以查看此计划的定期进度更新,并进行注册以在收件箱中接收更新

在开发阶段的各个关键里程碑,我们将为您的开发和测试环境提供更新。每次更新都包含 SDK 工具、系统映像、模拟器、API 参考文档和示例代码(应用和广告 SDK)。

使开发环境保持最新状态

我们强烈建议您将开发环境保持为最新版本。当有新的更新时,我们会在 Android 开发者博客进度更新页面上通知您。您还可以订阅电子邮件更新,在收件箱中收到相关邮件。