隐私沙盒广告

声明依赖项

要添加对 privacysandbox-ads 的依赖项，您必须将 Google Maven 仓库添加到您的项目中。请阅读Google 的 Maven 仓库以了解更多信息。

在您的应用或模块的 build.gradle 文件中添加您需要的工件的依赖项

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
 
}

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta13")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta13"
   
}

有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的想法，请告诉我们。在创建新问题之前，请查看此库中的现有问题。您可以通过点击星形按钮为现有问题投票。

创建新问题

有关详细信息，请参阅问题跟踪器文档。

版本 1.1

版本 1.1.0-beta12

2025 年 3 月 12 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 已发布。版本 1.1.0-beta12 包含这些提交。

新功能

• 自定义受众优先级：我们已在自定义受众中添加了一个优先级字段。这允许买家在 CustomAudience 中指定优先级值。如果买家自定义受众的数量超出每个买家的规模限制，此值将用于识别应包含在竞价中的自定义受众
• 卖家配置：此功能允许卖家定义竞价参数，以控制有效负载大小和竞价参与者。卖家竞价配置将允许卖家指定
  • 允许的买家列表
  • 对于给定卖家发起的竞价，只有允许列表中的买家才能为竞价贡献 CustomAudiences。
  • 每个买家的规模限制
  • 卖家可以指定每个买家的限制，以调节每个买家上传到发送给 SellerFrontendService 的有效负载中的数据大小。如果买家超出每个买家的规模限制，买家有效负载配置中设置的 CustomAudience 优先级将用于获取预期限制内的数据。
  • 有效负载的最大规模限制
  • 不同的卖家可能有不同的资源分配，并且可能希望为每个请求的竞价有效负载设置最大大小限制。最大大小限制将遵循由 ProtectedAudience API 设置的固定大小桶。
• 延迟自定义受众更新：此功能允许买家安排自定义受众的延迟更新。每个更新请求都允许调用方使用新的 scheduleCustomAudienceUpdate() API 安排延迟更新。对于每次更新，用户可以指定要加入或离开的自定义受众集。

API 变更

• 在 GetAdSelectionRequest API 中添加卖家配置 (Ibb5c7)
• 引入实验性 ScheduleCustomAudienceUpdate API (I6b905)

版本 1.1.0-beta11

2024 年 10 月 30 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 已发布。版本 1.1.0-beta11 包含这些提交。

新功能

• 此更新移除了对 Android R 上已弃用的 privacysandbox 衡量和 adid API 的支持。在 Android R 上获取管理器类的调用现在将返回 null。

版本 1.1.0-beta10

2024 年 8 月 21 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 已发布。版本 1.1.0-beta10 包含这些提交。

API 变更

• 为 GetAdSelectionDataOutcome、PersistAdSelectionResultRequest、ReportEventRequest 和 FetchAndJoinCustomAudienceRequest 实验性 API 添加缺少的 Java 构造函数重载。(I19e7f)

版本 1.1.0-beta09

2024 年 7 月 10 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 已发布。版本 1.1.0-beta09 包含这些提交。

API 变更

• 为 GetAdSelectionDataRequest 实验性 API 添加缺少的 Java 构造函数重载。(Ifbf88)。

版本 1.1.0-beta08

2024 年 6 月 26 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 已发布。版本 1.1.0-beta08 包含这些提交。

新功能

• 添加了对受保护应用信号的支持。
• 支持 B&A 服务器竞价的多个云提供商。

API 变更

• 实验性 API GetAdSelectionDataRequest::seller 为非空。(I68044)
• 添加实验性 GetAdSelectionDataRequest::coordinatorOriginUri API。(I18c0b)
• 添加了 updateSignals API。(Ia8512)

版本 1.1.0-beta07

2024 年 5 月 14 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 已发布。版本 1.1.0-beta07 包含这些提交。

新功能

• GetTopics 现在支持加密响应，作为 GetTopicsResponse 的一部分。

API 变更

• 已将 EncryptedTopic 添加到 GetTopicResponse 类。(Iab362)

版本 1.1.0-beta06

2024 年 4 月 17 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 已发布。版本 1.1.0-beta06 包含这些提交。

注意

• 截至 privacysandbox-ads jetpack 1.1.0-beta06 版本，所有启用标志的 Android R 设备都将能够访问 PPAPI。对于不应支持 Android R 的任何用例，在使用 privacysandbox-ads jetpack 代码的代码中将需要额外的防护措施。

新功能

• 对 Android R 的向后兼容性支持。

版本 1.1.0-beta05

2024 年 4 月 3 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 已发布。版本 1.1.0-beta05 包含这些提交。

错误修复

• 当 Android S 设备上由于清单中缺少 uses-library 标签而找不到类定义时，已添加错误捕获。

版本 1.1.0-beta04

2024 年 1 月 24 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 已发布。版本 1.1.0-beta04 包含这些提交。

新功能

• 支持竞价后用户事件报告的新 API
• 添加了对再营销广告的频次限制过滤支持
• 支持加入自定义受众委托
• 支持瀑布式中介链截断
• 支持在竞价和拍卖服务器上进行受保护的竞价

API 变更

• 引入实验性 AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) API (I86cd2)
• 引入实验性 ReportEventRequest::inputEvent API (Ib94f3)
• 使 ReportImpressionRequest::adSelectionConfig 可选 (Ief280)
• 引入实验性 AdSelectionManager::getAdSelectionData 和 AdSelectionManager::persistAdSelectionResultUnified API (Ie4d0e)
• 引入实验性 CustomAudienceManager::fetchAndJoinCustomAudience API (I09152)
• 引入实验性 AdSelectionManager::reportEvent API (I0d7dc)
• 引入了实验性 AdSelectionManager::updateAdCounterHistogram API，并修改了 AdData 以表示一系列 AdFilters (I87b83)

错误修复

• 输入 URI 现在在共享站点/源上进行匹配，而不再要求精确的主机名匹配。
• 修复因缺少 HTTPS 方案而导致的测试失败 (d573058)
• 修复网络 URL 中缺少的 HTTPS 方案 (cecdcb8)
• 为衡量 API 添加 throws 注解 (2dba359)

版本 1.1.0-beta03

2023 年 11 月 15 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 已发布。版本 1.1.0-beta03 包含这些提交。

新功能

• 对 Android S 的向后兼容性支持。

版本 1.1.0-beta02

2023 年 10 月 4 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 已发布。版本 1.1.0-beta02 包含这些提交。

API 变更

• 已从衡量请求类中移除 T+ 版本检查。客户端无需在其端进行 T+ 平台版本检查即可访问隐私沙盒 MeasurementManager 请求类。MeasurementManager 在新行为下将为 null。(Ieb105)

版本 1.1.0-beta01

2023 年 8 月 23 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 已发布，无显著更改。版本 1.1.0-beta01 是从内部分支发布的。

版本 1.1.0-alpha01

2023 年 8 月 9 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 已发布。版本 1.1.0-alpha01 包含以下提交。

API 变更

• 引入 registerSource 列表 (Iae92f)
• 移除了对实验性 isAtLeastU() API 的使用 (Ie9117, b/289269026)

错误修复

• 合并了实验性和公共 API 文件 (I15da3, b/278769092)

版本 1.0

版本 1.0.0-beta05

2023 年 6 月 7 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 和 androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 已发布。版本 1.0.0-beta05 包含以下提交。

错误修复

• 向 TopicsManager 添加了 SDK 扩展版本 5 检查
• 将 Kotlin coroutines 依赖项升级到 1.7.1，以防止 Gradle 中出现重复类构建错误

版本 1.0.0-beta04

2023 年 5 月 10 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 和 androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 已发布。版本 1.0.0-beta04 包含以下提交。

错误修复

• 解决了当调用方在主线程上调用 adservices measurement API 时出现的死锁问题。(I65361)

版本 1.0.0-beta03

2023 年 4 月 19 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 和 androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 已发布。版本 1.0.0-beta03 包含以下提交。

新功能

• 为 Topics 启用了预览 API。

版本 1.0.0-beta02

2023 年 3 月 22 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 和 androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 已发布。版本 1.0.0-beta02 包含以下提交。

错误修复

• 针对 SDK 扩展版本 5 及更高版本启用了 MeasurementManager API。
• 针对 SDK 扩展版本 4 及更低版本停用了 MeasurementManager API。

版本 1.0.0-beta01

2023 年 2 月 22 日

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 和 androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 已发布，无显著更改。版本 1.0.0-beta01 是从内部分支发布的。

行为变更

• 归因报告已禁用，在此版本中不可用。

版本 1.1.0-alpha01

2023 年 1 月 11 日

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 和 androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 已发布。版本 1.1.0-alpha01 是从内部分支发布的。

• 这是一个新的 Jetpack 库，支持与隐私沙盒的隐私保护 API（Topics、FLEDGE 和归因报告）集成。
• Jetpack 隐私沙盒 API 可以作为 Extension SDK 4 中提供的隐私沙盒 API 的直接替代品。