隐私沙盒广告

声明依赖项

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

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

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

dependencies {

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

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

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

反馈

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

创建新的问题

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

1.1 版

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 的支持，这些 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 变更

• 向 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 版本包含这些提交。

错误修复

• 在 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 文件（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 库，它允许与隐私沙盒的隐私保护 API 集成（主题、FLEDGE 和 归因报告）。
• Jetpack Privacy Sandbox API 可作为 扩展 SDK 4 中提供的 Privacy Sandbox API 的直接替代。