隐私沙盒广告

声明依赖项

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

在应用程序或模块的 build.gradle 文件中添加所需工件的依赖项。

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

dependencies {

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

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

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

反馈

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

创建新问题

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

版本 1.1

版本 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 添加缺少的 Java 构造函数重载。实验性 API。(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)
• 修复从 Web 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+ 平台版本检查以访问 privacysandbox 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 和公共 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 协程依赖项提升到 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 测量 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 包含这些提交。

新功能

• 启用主题的预览 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.0.0-alpha01

2023 年 1 月 11 日

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

• 这是一个新的 Jetpack 库，它支持与 Privacy Sandbox 的隐私保护 API (主题、FLEDGE 和 归因报告) 的集成。
• Jetpack Privacy Sandbox API 可以用作 扩展 SDK 4 中提供的 Privacy Sandbox API 的替代品。