版本说明

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

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

当前版本

Android VanillaIceCream 预览版

此版本包含 Android VanillaIceCream 预览版中的 Privacy Sandbox API。您可在 Android Studio 中以 Android VanillaIceCream 预览版的形式下载 SDK 和模拟器映像。此版本包含与先前发布的开发者预览版 10 相同的功能，但新增了下面列出的其他更改。

Protected Audience API

• 添加了将经过身份验证的内容相关广告传递到受保护竞价的功能。这还包括对设备上已安装的应用进行排除性过滤，以及对点击次数、展示次数、观看次数或胜出次数设置频次上限。该实现与之前的迭代不同，因为内容相关广告需要由广告技术平台签名。如需了解如何实现此功能，请参阅开发者指南。
• 将 ContextualAds 重命名为 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 的更新。SDK 和设备映像可供使用 Android Studio 的 SDK 管理器下载作为 Android API 34（扩展级别 10），在功能方面与开发者预览版 9 类似，但有几项关键修改。

Protected Audience API

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

Attribution Reporting API

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

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 账号。执行以下操作即可使设备进入主屏幕：
  • 在手机上安装预览图片。
  • 在未连接到 Wi-Fi 或移动数据网络的情况下，按照设置向导逐步操作。
  • 进入主屏幕后，连接到 Wi-Fi 或移动数据网络。
  • 重新启动相应设备。

Protected Audience API

• 我们正在更新内容相关路径中的广告参与受保护竞价的方式。此开发者预览版中移除了以下类和方法：
  • AdSelectionConfig.getBuyerContextualAds()
  • AdSelectionConfig.Builder.setBuyerContextualAds()
  • AdSelectionManager.setAppInstallAdvertisers()
  • ContextualAds
  • AdWithBid
  • AppInstallFilters
• ReportInteractionRequest 已重命名为 ReportEventRequest
• 我们即将推出新功能受保护的应用信号，以支持投放相关的应用安装广告。我们会在此开发者预览版中发布一些 API，让广告技术平台能够：
  • 通过将应用事件存储在受保护的设备端存储空间中，管理用于投放相关的应用安装广告的信号。
  • 通过在可信执行环境中运行的出价和竞价服务开展受保护竞价，这些服务可在此类环境中获取各自的信号以帮助进行广告选择和出价。

Attribution Reporting API

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

设备端个性化

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

开发者预览版 9

发布日期：2023 年 8 月 15 日

已知限制

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

Protected Audience API

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

Attribution Reporting API

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

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 字段。

• 如需在 FLEDGE on Android 中启用测试，请注册 Beta 版计划，并使用同一 Google 账号登录您的测试设备。否则，尝试调用 API 会导致出现 IllegalStateException 并显示“Service is 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 设置为两天。

Attribution Reporting on 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 日起，我们已推出可解决该问题的更新后的设备映像。

  注意：如果您在 2022 年 7 月 27 日之前安装了设备映像（修订版 6），必须先卸载旧映像，然后才能安装更新后的映像。

开发者预览版 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") 注解暂时解决此问题。