此页面由 Cloud Translation API 翻译。

privacysandbox ads

API 参考文档
androidx.privacysandbox.ads.adservices.adid
androidx.privacysandbox.ads.adservices.adselection
androidx.privacysandbox.ads.adservices.appsetid
androidx.privacysandbox.ads.adservices.common
androidx.privacysandbox.ads.adservices.customaudience
androidx.privacysandbox.ads.adservices.measurement
androidx.privacysandbox.ads.adservices.topics

此库支持与可保护隐私的 API（Android Privacy Sandbox 的一部分）集成。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2025 年 3 月 12 日	-	-	1.1.0-beta12	-

声明依赖项

如需为 privacysandbox-ads 添加依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

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

Groovy

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

Kotlin

dependencies {

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

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 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 引入为实验性 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 衡量 API 和 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 不可为 null。(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 变更

向 GetTopicResponse 类添加了 EncryptedTopic。(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 包含这些提交内容。

bug 修复

添加了在 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)

bug 修复

现在，输入 URI 将在共享站点/来源方面匹配，而无需与主机名完全匹配。
修复了因缺少 HTTPS 架构而导致测试失败的问题 (d573058)
修复了网址缺少 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）

bug 修复

合并了实验性 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 中包含这些提交内容。

bug 修复

向 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 中包含这些提交内容。

bug 修复

解决了调用方在主线程上调用 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 中包含这些提交内容。

新功能

为 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 中包含这些提交内容。

bug 修复

为 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 是从内部分支发布的。

行为变更

Attribution Reporting 已停用，无法在此版本中使用。

版本 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（Topics、FLEDGE 和 Attribution Reporting）集成。
这些 Jetpack Privacy Sandbox API 可用作 Extension SDK 4 中提供的 Privacy Sandbox API 的直接替代品。