Android Privacy Sandbox 版本说明

Privacy Sandbox on Android 提供了开发者预览版和 Beta 版计划。我们将逐步在开发者预览版中推出新的 API 和功能，并将稳定版 API 升级至 Beta 版计划。欢迎提供反馈。

如果您刚开始接触 Privacy Sandbox on Android，请先阅读计划概览。如需开始在您的项目中构建 Privacy Sandbox，请设置开发环境，并在测试设备或模拟器中获取 Privacy Sandbox on Android。

当前版本

Android VanillaIceCream 预览版

Protected Audience API

• 添加了将经过身份验证的内容相关广告传递到受保护的竞价的功能。这还包括对设备上已安装的应用进行排除性过滤，以及对点击次数、展示次数、观看次数或胜出次数设置频次上限。该实现与之前的迭代不同，因为内容相关广告需要由广告技术平台签名。要了解如何实现这一点，请参阅开发者指南。
• ContextAds 已重命名为 SignedContextualAds 以及 AdSelectionConfig 中的相关 getter 和 setter；getPerBuyerSignedContextualAds、setPerBuyerSignedContextualAds
• 如果未通过身份验证的上下文相关应用，则会从竞价中移除

Attribution Reporting API

• 在已安装相应应用的情况下，拖放来源的功能
• 从精简版灵活事件报告更新为完整版灵活事件报告

Privacy Sandbox on Android 2023 年 11 月 Beta 版更新

此版本的 Privacy Sandbox on Android Beta 版包含对公开 Android 14 设备上的 Privacy Sandbox API 的更新。可以使用 Android Studio 的 SDK 管理器下载 SDK 和设备映像（作为 Android API 34 扩展级别 10），该功能与 [开发者预览版 9][b25] 类似，但进行一些关键修改。

Protected Audience API

• 广告技术平台现在可以使用 [自定义受众群体委托][b26]，代表设备端不存在的买方加入自定义受众群体。
• Android 现在支持在出价和竞价服务上运行竞价。
• Protected Audience 竞价支持每次点击费用结算。
• Protected Audience 竞价和报告现在支持针对可信出价信号的数据版本标头。
• Protected Audience 竞价支持根据 WIN 事件对频次上限进行过滤。
• Protected Audience 现在支持 [与 Attribution Reporting API 集成][b27]。

Attribution Reporting API

• Attribution Reporting API 现在支持 [与 Protected Audience 集成][b28]

SDK 运行时

• SDK 能够在 SDK 运行时内加载其他 SDK 以支持中介用例

过往版本

开发者预览版 10

发布日期：2023 年 12 月 19 日

已知限制

• 有一个问题会导致 Google Play 服务在后台崩溃，并反复通知用户：
  • 重新启动设备或许能缓解此问题。
  • 在测试时，如果您遇到异步调用超时的问题，请尝试添加以下 adb 命令，以便将阈值延长到超时：
  • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
• 仅限实体设备：不支持添加 Google 帐号。请按以下步骤操作，使设备进入主屏幕：
  • 在手机上安装预览图片。
  • 在未连接到 WLAN 或移动数据网络的情况下，完成设置向导。
  • 进入主屏幕后，连接到 Wi-Fi 或移动数据网络。
  • 重新启动相应设备。

Protected Audience API

• 我们引入了新功能 [受保护的应用信号][dp98]，以支持投放相关的应用安装广告。在本 DP 中，我们将发布一些 API，让广告技术平台能够：
  • 通过将应用事件存储在受保护的设备端存储空间中来挑选信号，该存储空间用于投放相关的应用安装广告。
  • 在可信执行环境中运行的出价和竞价服务受保护竞价，它们可以访问各自的信号以帮助广告选择和出价。

Attribution Reporting API

• 此版本的 Attribution Reporting API：
  • 添加了 Protected Audience 集成，以便在汇总摘要报告中启用自定义受众群体维度。
  • 支持将 Google Cloud Provider 用作汇总服务的 TEE。
  • 添加了 shared_debug_key 字段，以支持调试无重定向的跨广告网络归因。
  • 在详细调试报告请求中添加了版本标头。

设备端个性化

• 面向研究人员的初始版本和早期开发版本。
• 设备端个性化引入了创新方式来自定义产品和服务，同时增强最终用户隐私保护。设备端个性化功能提供了一组服务和算法作为基础组件来实现该目标，包括但不限于：
  • 联合计算 (FC)，支持使用联邦学习来训练、评估和个性化模型。设备端个性化对联合计算的使用将基于模型训练和（根据需要）推断。
  • 基于布谷鸟过滤器的匹配和交叉匹配位于不同位置的数据。
  • 使用 DP 交替最小化（用于针对位置不同的数据进行训练）和 Billboard DP 下的模型个性化等新技术对稀疏模型进行差分隐私 (DP) 训练。### 开发者预览版 9

发布日期：2023 年 8 月 15 日

已知限制

• 在 DP9 中，系统不会自动删除通过调用出价和竞价 API 生成的竞价数据。
• 撤消同意后，调用 getAdSelectionData 和 persistAdSelectionResult 会导致该流程崩溃。
• 排除性过滤功能不适用于 getAdSelectionData 和 persistAdSelectionResult。

Protected Audience API

• 广告技术平台现在可以使用自定义受众群体委托将自定义受众群体加入设备端调用方。
• Android 现在支持在出价和竞价服务上运行竞价 - Protected Audience 竞价支持每次点击费用结算。
• Report Interactions API 现在称为 reportEvent。
• 频次上限方法和计数器类型已重命名。
• 通过调试报告获取相关信息，了解竞价失败的原因，或找出 JavaScript 逻辑中的问题。

Attribution Reporting API

• 此版本通过以下方式改进了 Attribution Reporting API 的调试报告：
  • 支持在网页上支持的详细调试报告。
  • 启用跨网站和应用归因调试报告（网站和应用注册都需要 AdId）。
• 广告技术平台可以针对不同的报告场景配置噪声参数。
• 此版本将改用基于来源的归因，也就是说：
  • 源用于注册。
  • 一个网站可以接受多个来源。
  • 新增速率限制，每个来源应用或注册只能有一个来源。
• 广告技术平台现在可以停用注册，以便在本地测试归因报告用例。

SDK 运行时

• SDK 只能启动或绑定到服务的许可名单。
• SDK 只能访问系统 ContentProvider 的一部分（例如 com.android.providers.settings.SettingsProvider），其中获取的数据缺少标识符，无法用于构建用户指纹。这些检查也适用于使用 ContentResolver 访问 ContentProvider 的情况。
• SDK 只能访问一部分受保护的广播接收器（例如 android.intent.action.AIRPLANE_MODE）。
• SDK 可以启动属于其他应用的 activity，但在 intent 中可发送的内容方面有限制。

Privacy Sandbox on Android 2023 年 3 月 Beta 版更新

2023 年 3 月发布的 Privacy Sandbox on Android Beta 版包含对公开 Android 13 设备上的 Privacy Sandbox API 的更新。此版本包含广告服务扩展 5 API，功能与开发者预览版 6 类似，但进行了一些重要修改。

已知限制

• 为更新 FLEDGE 自定义受众群体而定期运行的后台提取作业会导致进程崩溃。由于此问题，FLEDGE 默认处于停用状态。

常规

• 从此版本开始，您可以使用 Attribution Reporting API。该 API 之前已停用。如果您是在之前的 Beta 版中使用 Attribution Reporting API，请在使用此 Beta 版之前清除您的应用或设备数据，具体步骤之一如下：
  • 在设备或模拟器上，前往“设置”，然后清除应用专用存储空间（而不仅仅是缓存），以存储用于测试的任何应用。
  • 将实体设备或模拟设备恢复出厂设置。
  • 对于模拟设备，请执行擦除数据功能。
• Attribution Reporting 现在支持调试密钥，以便开发者能够从 Attribution API 接收未经更改的报告以及注重隐私保护的报告。调试密钥让您有机会在过渡到 Privacy Sandbox 时更深入地了解报告的结构。
• Attribution Reporting 最近在使用广告服务遇到了一个 bug，其中 registerSource 和 registerTrigger 将失败并出现异常。如果您在开发期间遇到这些问题，我们已推出修复方案，这些问题应该会随着时间的推移而解决。
• Topics API 预览版功能现在与 Privacy Sandbox on Android 开发者预览版功能相当。Topics API 调用方可以预览主题，而无需在每周周期计算中包含主题检索调用，也不会影响调用方的观察到的主题列表。如需了解详情，请参阅 shouldRecordObservation 字段。

• 如需在 Android 版 FLEDGE 中启用测试，请注册 Beta 版计划，并使用同一 Google 帐号登录测试设备。否则，尝试调用 API 会导致出现 IllegalStateException 并显示“Service not available”消息。FLEDGE 应该会在下一个 Beta 版中恢复。

  在此期间，您可以继续使用开发者预览版进行测试，同时我们鼓励您使用，但可以在符合以下注意事项的设备上手动启用 FLEDGE：

  您可以使用以下 adb 命令启用 FLEDGE。但是，这会导致后台提取进程崩溃，对系统运行状况指标产生负面影响。这并不是一个永久性解决方案，因为平台可能会重置这些值。

  adb shell device_config set_sync_disabled_for_tests persistent
  adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
  adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
  adb shell device_config put adservices fledge_background_fetch_enabled true
  

过往版本

开发者预览版 8

发布日期：2023 年 5 月 23 日

已知限制

• 虽然可以将 WIN 类型的频次上限过滤条件添加到 Protected Audience 广告中，但 WIN 类型尚不受支持，并且系统会忽略此类过滤条件。
• 若要向 Protected Audience 竞价的胜出买方报告赢得的展示次数，买方必须已注册 Privacy Sandbox。无法替换此要求。
• 如需在支持 Privacy Sandbox 的设备上访问 Privacy Sandbox 设置，请依次转到设置 > Google > 广告 > Privacy Sandbox。
• 无法在 Android Studio Giraffe 上使用模拟器部署项目。其他版本的 Android Studio 应该可以正常运行。我们将于 2023 年 5 月 26 日针对 Android Studio Giraffe 推出修复程序。

Protected Audience API

• FLEDGE 已重命名为 Protected Audience API。
• Protected Audience 在 2023 年 3 月的 Beta 版中默认处于停用状态。 此问题已解决，Protected Audience 现已向有限数量的用户推出。
• 添加了以下新功能：
  • 频次上限
  • 互动报告
  • 在竞价中加入内容相关广告
  • 应用安装排除广告过滤
  • 预构建的 URI：一个由广告技术平台（而非其 JavaScript）在竞价过程中使用的预定义逻辑库
  • 出价和评分 JavaScript 函数的版本控制

Attribution Reporting API

• 添加了 OR 触发器过滤条件。这意味着，过滤条件现在由一个过滤条件集组成，即过滤条件映射列表。如果集合中的过滤器映射与来源的过滤器数据均不匹配，系统会忽略 event_trigger_data 对象。
• 汇总 API 和事件级 API 的展示过期时间和报告期已分离。
• 新增了对可汇总报告中的重复信息删除键的支持。
• 向事件报告添加了 scheduled_report_time，以便与 Privacy Sandbox for Web 等效。
• 实现了无重定向的跨广告网络归因。

SDK 运行时

• 针对应用进程和 SDK 运行时进程实现了 SDK 到 SDK 通信。
• 自定义 SDK Activity 支持

开发者预览版 7

发布日期：2023 年 1 月 26 日

FLEDGE on Android API

• 在以下 JavaScript 方法中，参数 custom_audience_signals 已重命名：
  • generateBid() 已重命名为 custom_audience_bidding_signals。
  • scoreAd() 已重命名为 custom_audience_scoring_signals。
  • reportWin() 已重命名为 custom_audience_reporting_signals。
• 此版本新增了 selectAds 替换项，该替换项使用 AdSelectionFromOutcomeConfig 来比较 selectAds 结果。这样一来，利用此 API 的广告技术 SDK 就可以运行广告瀑布流中介。如需了解更多详情，请参阅开发者指南。
• selectAds() API 现在支持缓存广告选择流程中提取的出价和评分逻辑 JavaScript。
  • 在 JavaScript 提取调用期间，可通过服务器返回的 Cache-Control 标头来控制缓存。使用 no-cache 或 no-store 可防止 JavaScript 响应被缓存，使用 max-age 可控制缓存时长。
  • 默认情况下，当前缓存条目 max-age 设置为两天。

Android API 上的归因报告

• 此版本增加了对 registerSource() 和 registerTrigger() 菊花链重定向的支持。API 使用者现在可以使用 HTTP 重定向作为服务器响应。

初始 Beta 版于 2023 年 1 月发布

发布日期：2023 年 1 月 9 日

Privacy Sandbox on Android Beta 1 代表 Privacy Sandbox API 首次在公共设备上提供，并改进了下面所列的方面。

常规

• Privacy Sandbox on Android Beta 1 功能等同于开发者预览版 5，并具有以下额外功能和限制。
• 开发者必须完成注册流程，才能使用与广告相关的 API（包括 Topics API、FLEDGE API 和 Attribution Reporting API）。注册过程会验证开发者身份，并收集 API 所需的开发者特定数据。
• 在 Privacy Sandbox on Android Beta 1 版本中，已注册开发者并将详细信息提交到许可名单中的开发者将有机会在自己的实体设备上进行测试。若要针对此版本中的稳定 API 进行开发，请下载新的 SDK 广告服务扩展 4。

Topics API

• 借助 Android Topics Classifier Colab，开发者能够更好地了解分类器模型的工作原理。

Attribution Reporting API

• Attribution Reporting 已停用，无法在此版本中使用。对此 API 的访问权限应该会在下一个 Beta 版中重新启用。 建议您继续使用开发者预览版进行测试。

SDK 运行时

以下限制预计将在下一个主要 Android 平台版本中得到解决：

• RecyclerView 等可滚动视图内的广告渲染目前无法正常运行。调整元素大小时可能会出现卡顿。用户触摸滚动事件未正确传递到运行时。
• WebView 渲染在 SDK 运行时进程中不可用。
• SDK 级存储空间不可用。
• 尚未启用对 getAdId 和 getAppSetId API 的支持。

开发者预览版 6

发布日期：2022 年 10 月 31 日

Privacy Sandbox on Android 开发者预览版 6 在以下方面进行了改进：

常规

• 为准备发布正式版，开发者预览版 6 引入了一个标志，用于默认停用可保护隐私的 API 访问权限。出于测试目的，可通过运行以下命令在开发者预览版中启用隐私保护 API 访问权限：

  adb shell device_config put adservices global_kill_switch false
  

• AdIdManager 和 AppSetIdManager API 需要 Google Play 服务 22.36.16 或更高版本。

  • 在 Android 设备上，验证设置 > 应用 > Google Play 服务下是否列出了正确的版本。
  • 如果您需要将 Google Play 服务更新到正确的版本，请使用 Google 帐号登录 Android 测试设备或模拟器。然后，依次访问 Google Play 商店 > 个人资料图标 > 设置 > 关于。在 Play 商店版本标题下，点按更新 Play 商店。
  • 此步骤仅适用于开发和测试，在 Privacy Sandbox 向公众用户推出后不需要执行此步骤。

Topics API

• 添加了 Preview API，用于切换 getTopics 是否注册为观察者。
• 对 GetTopicsRequest 类的初始化代码进行了细微更改。
• 发布了 Topics 集成指南。

FLEDGE on Android API

• 如果您要针对实际服务器进行测试，则现在会强制启用 API。请按照这些步骤配置您的设备。如果您使用的是示例应用中的远程替换项，则无需执行这些步骤。
• 重大变更：
  • 已将参数中的 Url 替换为 Uri。这适用于所有 FLEDGE API 以及用于出价和评分逻辑的自定义 JavaScript。
  • 从 Custom Audience API 输入中移除了 owner 字段。
• 不完整的自定义受众群体现在会立即符合后台刷新的条件。
• JavaScript 内存上限现在设为 10MB。这适用于出价和评分逻辑。

Attribution Reporting API

• 广告技术平台必须先注册，才能在开发者预览版 6 中使用 Attribution Reporting API。如需了解详情，请参阅注册 Privacy Sandbox 账号。
• 此版本引入了调试密钥，可让开发者从 Attribution Reporting API 接收未经更改的报告以及注重隐私保护的报告。调试密钥让您有机会在使用 Privacy Sandbox 转换时更深入地了解报告的结构。

开发者预览版 5

常规设置

• 您必须先启用 Privacy Sandbox API 并为其配置 API 专属权限，然后才能在开发者预览版 5 中访问这些 API。
  • Privacy Sandbox on Android 的设计允许用户控制其设备上的隐私保护 API 和 SDK 运行时是否处于启用状态。在开发者预览版 5 中，这些设置在默认情况下设置为停用。您可以使用 adb 命令启用 API 访问权限。
  • 调用方应用必须在清单中以及用于控制嵌入式 SDK 访问权限的相关 AdServices 配置中指定 API 专属权限。
• 应用在前台运行时必须调用隐私保护 API。
• AdIdManager 和 AppSetIdManager 目前无法使用。我们会在以后的版本中启用它们。

SDK 运行时

• 在未来的版本中，sendData() 将被废弃。
• loadSdk() 现在会返回一个 IBinder 对象，用于在支持运行时的 SDK 与 AIDL 中定义的应用之间实现双向通信。
• 应用可以访问其他支持运行时的 SDK 生命周期事件，例如 SDK 进程的终止时间。

Attribution Reporting API

此版本在 Attribution Reporting API 中引入了其他功能，包括：

• 支持加密汇总报告。
• 支持跨应用和跨网站衡量。
• 合并了来源和触发器注册响应中的标头：
  • 来源：Attribution-Reporting-Register-Aggregatable-Source 现在是 Attribution-Reporting-Register-Source 的一部分
  • 触发器：Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data 和 Attribution-Reporting-Register-Aggregatable-Values 已合并为名为 Attribution-Reporting-Register-Event-Trigger 的单个标头
  • Attribution-Reporting-Redirects 仍是一个单独的标头

FLEDGE on Android API

此版本包含多项新功能和改进，并做出了一些重大变更：

• 重大变更：
  • runAdSelection() 已重命名为 selectAds()。
  • 已将 AdSelectionConfig.Builder.setAdSelectionSignals() 的参数替换为 AdSelectionSignals，表示一个 JSON 对象。
  • 已将用于表示广告技术买方/卖方的 String 替换为 AdTechIdentifier 对象。
  • 添加了 TestCustomAudienceManager 和 TestAdSelectionManager 类，用于替换远程 JavaScript 提取。
  • 自定义受众群体的所有者必须是发起调用的应用的软件包名称。
• FLEDGE API 现在会根据开发者指南中所述的一系列限制和约束来验证调用方应用。以下是一些值得注意的示例。
  • selectAds 和 reportImpression 现在具有执行时间限制，超过该限制后，调用将被终止。
  • selectAds 和 reportImpression 现在对 JavaScript 执行期间消耗的内存做出了限制。如果内存消耗超过了配置的限制值，API 将抛出错误。
  • selectAds 和 reportImpression 现在会验证 AdSelectionConfig 对象，以确保字段的语法有效并且网址位于卖方字段中使用的 eTLD+1 下。
  • AdServices 现在会在创建时验证自定义受众群体。此验证包括确保到期时间有效，并对应用可以创建的自定义受众群体数量以及 joinCustomAudience 调用中提供的广告总大小应用限制。该验证还强制要求为信号、出价逻辑检索和后台提取提供的 URI 均位于买方的网域下。
• 后台提取进程会每天更新自定义受众群体元数据。
• 卸载“所有者”应用后，系统会移除自定义受众群体。
• 添加了对在广告选择过程中指定可信评分信号和可信出价数据的支持。如需了解响应格式，请参阅代码示例。
• FLEDGE for Android API 依赖于 WebView 版本 105.0.5195.58 或更高版本。如需了解详情，请参阅开发者指南中的设置信息。

• 已知问题：

  • 加入自定义受众群体时，如果任何元数据或 AdData 值为空或 null，平台目前不会立即执行后台更新。自定义受众群体在一天后更新后，才能用于广告选择。未来的版本会让不完整的自定义受众群体立即符合进行后台提取更新的条件。当前对于 JavaScript 执行的默认内存限制过低，可能会导致常规工作负载造成设备上 JavaScriptEngine 崩溃的情况。您的 JavaScript 执行可能会意外终止，并显示错误消息 "Fatal javascript OOM in CALL_AND_RETRY_LAST"。

    您可以使用以下命令配置适当的内存阈值，从而手动解决此问题：

    adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
    

  • 与所需 JSON 结构不符的自定义受众群体广告会在后台提取期间更新。

Topics API

• 更新了用于对移动应用进行分类的分类。
• 更新了设计方案和示例应用，启动“设置”界面来查看分配的主题。

工具动态

Android Studio Canary 支持使用新的模块类型构建 SDK APK。SDK 运行时开发者指南已更新，GitHub 上的 Privacy Sandbox 示例应用反映了此更新。

开发者预览版 4

发布日期：2022 年 7 月 14 日

Privacy Sandbox on Android 开发者预览版 4 在以下方面进行了改进：

SDK 运行时

• 应用现在可以通过添加 sendData() 与启用了运行时的 SDK (RE-SDK) 进行通信。
• 本地存储现已可在 SDK 运行时进程中使用。
• SDK 也可以在 SDK 运行时中呈现基于视频的独立广告或内容。
• 添加了关于反射用法的说明，以便在内容不在其他 RE-SDK 中时使用所提供的反射。

Attribution Reporting API

此版本引入了一些更改，旨在让 Attribution Reporting API 的使用更加明晰，包括：

• 更改了汇总报告格式以改善可读性。
• 更新了转化过滤和出价功能的标头字段。
• 在 WebApp API 参考文档中添加了澄清说明，以解释来源和触发器注册以及隐私权与同意声明 API 的可用性。

FLEDGE on Android API

此版本包含有助于测试和调试的功能，还进行了内部改进：

• 添加了在开发过程中对替换远程网址的支持，以便于检索 JavaScript 逻辑。
• 改进了广告选择期间的错误报告。
• 现在，广告选择过程中会滤除无效自定义受众群体。

Topics API

此版本对 Topics API 进行了多项重大更改，最重要的更改包括：

• getTopics() API 的返回类型已更改为新的 Topic 对象类型，其中封装了与分类中的主题相对应的整数 ID 以及分类器和分类版本的相关信息。您应使用此 API 更新所有现有应用。
• Topics API 现在需要新的一般权限。
• 引入了“设备端分类器”系统，可根据公开可用的应用信息来动态分配主题。

已知问题

• 这些设备映像（修订版 6）的初始版本无法在 Android 模拟器版本 31.2.10 上加载。自 2022 年 7 月 27 日起，我们已推出可解决该问题的更新后的设备映像。

开发者预览版 3

发布日期：2022 年 6 月 9 日

Privacy Sandbox on Android 开发者预览版 3 为 Attribution Reporting API 和 Android 版 FLEDGE 增加了一些功能。

Attribution Reporting API

Attribution Reporting API 通过消除对跨方用户标识符的依赖来增强用户隐私保护，并支持跨应用进行归因和转化衡量的关键用例。

此版本包含可帮助您测试以下 Attribution Reporting API 功能的开发者资源：

• 注册归因来源和触发器事件
• 进行来源优先归因和安装后归因
• 接收事件报告
• 接收可汇总报告（在此版本中未加密）

为帮助您进行测试，我们提供了示例应用和参考广告技术服务器

已知问题：

• Attribution Reporting API 尚无法按照设计方案加密汇总报告。在实现加密之前，如需进行测试，请以明文形式发送报告载荷。

Android 版 FLEDGE

Android 版 FLEDGE 引入了一种根据应用开发者定义的“自定义受众群体”以及应用内的互动来展示广告的新方式。该解决方案会将这些信息和关联的广告存储在本地，并提供一个框架来编排广告选择工作流程。

此版本包含可帮助您测试以下 Android 版 FLEDGE 功能的开发者资源：

• 加入或退出自定义受众群体，并观察参数值如何影响竞价结果
• 从远程端点提取 JavaScript 竞价代码
• 在设备上配置和启动广告竞价
• 处理展示次数报告
• 为帮助您进行测试，我们提供了示例应用和模拟服务器配置

已知问题：

• 自定义受众群体甚至在其“启用时间”之前就可以参与广告选择。

开发者预览版 2

发布日期：2022 年 5 月 17 日

开发者预览版 2 包含 MeasurementManager 归因报告 API 的早期预览版。

• 您可以调用 registerSource() 和 registerTrigger() 来注册应用广告事件，并接收事件级报告数据以进行应用到应用归因。我们当前的实现使用最终接触归因。 报告按照报告期限定义的时间定期发送。如需了解详情，请参阅 MeasurementManager API 参考文档。

• 实际的报告上传会在固定时间间隔结束时进行，而不是在确切的预定时间进行。报告上传间隔默认为 4 小时，但可以使用以下 adb 命令替换：

  adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
  

• 我们会在未来版本中发布用于测试 API 的示例应用和参考广告技术服务器。

• 我们将在后续版本中推出其他 MeasurementManager Attribution Reporting API 功能，例如汇总报告、安装后归因和重定向。

开发者预览版 1

发布日期：2022 年 4 月 28 日

开发者预览版 1 包含 Topics API 和 SDK 运行时的早期预览版。我们将在未来版本中提供 Android 版 FLEDGE 和Attribution Reporting API 的相关功能。

• Topics API
  • getTopics() API 目前会根据对有限的一组应用的离线分类返回测试值。尚未实现设备端分类。
  • 可以使用 adb 命令替换周期间隔并强制触发周期计算。
  • 如需了解详情，请参阅 Topics API 开发者指南。
• SDK 运行时
  • 您可以使用 SDK 应用清单文件中的新 <sdk-library> 元素来打包和构建支持运行时的 SDK (RE SDK)。在受支持的测试设备或模拟器上安装 RE SDK，就像在开发过程中通常安装应用一样。
  • 您可以将应用与 RE SDK 集成，在 SDK 运行时中加载 RE SDK，并测试限制对 SDK 代码（权限、内存和应用到 SDK 通信）的访问带来的影响。尚未实现适用于 RE SDK 的 Storage API，这些 API 将在未来的版本中提供。
  • SDK 可以在 SDK 运行时中呈现基于 WebView 的横幅广告或内容。
  • 如需了解详情，请参阅 SDK 运行时开发者指南。
• Android lint 检查
  • Android lint 检查可能会在使用 API 级别 TiramisuPrivacySandbox 编译的项目中错误地显示警告。例如，您可能会看到以下警告消息：“Call requires API level 33”。您可以使用 @SuppressLint("NewApi") 注解暂时解决此问题。