privacysandbox ads

  
這個程式庫可讓您整合隱私權保護 API，這種 API 屬於 Android 版 Privacy Sandbox。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 5 月 7 日 - - 1.1.0-beta13 -

宣告依附元件

如要在 privacysandbox-ads 上新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

dependencies {

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

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

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 上取得管理員類別的呼叫現在會傳回空值。

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
  • 新增支援再行銷廣告的展示頻率上限篩選功能
  • 支援加入自訂目標對象的委派作業
  • 刊登序列中介服務鏈截斷支援
  • 支援在出價和競價伺服器上執行 Protected Auction

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)
  • 修正網頁網址中缺少的 HTTPS 架構 (cecdcb8)
  • 在測量 API 中新增擲回註解 (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 會為空值。(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 變更

修正錯誤

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 版包含此連結所列的修訂項目。

新功能

  • 為 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 Extension 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 版本是以內部分支版本為基礎。