開始使用 Android 版 Privacy Sandbox

Android 版 Privacy Sandbox Beta 版計畫提供穩定版 API。您可以使用 Beta 版計畫建構及測試解決方案,在少數 Android 13 以上行動裝置上進行正式版測試,適用於所有 API,以及 Android 12 以上版本的 Attribution Reporting API (ARA)。我們會開始支援少數裝置,並隨著時間增加支援的裝置數量。 如要參與這項計畫,機構可以要求使用特定裝置,並註冊任何使用 Privacy Sandbox API 的應用程式。

針對 SDK 執行階段,我們即將推出 Beta 版封測程序,可讓開發人員測試將支援執行階段的 SDK 發布至特定應用程式。

如要使用 Beta 版,開發人員必須使用 API 級別 33 SDK 擴充功能更新來編譯解決方案。

Android SDK Extensions

Beta 版中的穩定版 API 會透過新的 Android SDK Extensions 發布方法提供。這個發布方法可在各個主要版本之間發布穩定的 Android 功能,它採用了新的版本管理機制,可透過 Google Play 系統更新,為不同 API 級別的應用程式提供新的 API。Android 版 Privacy Sandbox 的 SDK 擴充功能稱為「Ad Services Extensions」。進一步瞭解 Android SDK 擴充功能

開始使用

如要開始使用 Android 版 Privacy Sandbox,請執行下列步驟:

步驟 1:註冊並登錄 Beta 版計畫

  • 註冊:完成註冊程序,即可使用廣告相關 API。
  • 登錄:您必須登錄才能參與 Beta 版計畫。註冊後即可:
    • 啟用自己的裝置進行內部測試。
    • 在 Google Play 商店中指定少量發布的應用程式,這些應用程式要能直接整合隱私維護 API,或整合使用這些 API 的 SDK 解決方案。
    • 使用 Google Play 商店測試支援執行階段的 SDK 發布功能。如果您只需要測試裝置端 SDK 執行階段,則可略過這個步驟。

步驟 2:設定開發環境

在 Android Studio 中設定 Android SDK 的 Privacy Sandbox。

步驟 3:設定 AdServices 權限

針對目標 API 所管理的資源宣告 API 專屬權限,並設定 SDK 存取權

步驟 4:設定裝置或模擬器映像檔

如要執行端對端測試,您需要與支援的 Android 13 裝置互動,或使用模擬器映像檔取得適當的 SDK 擴充功能。

步驟 5:設定使用 Android 版 Privacy Sandbox 的裝置

調整設定以啟用 (或停用) Android 版 Privacy Sandbox,以便在裝置上執行。

排解已知問題

為避免在搭載 Android 12 以下版本的裝置上,發生已知的 PP API 整合問題,開發人員應為這些裝置整合廣告服務 API,並採取下列行動:

  1. 確認用戶端應用程式的資訊清單檔案包含 <uses-library> extservices 標記。相關標記如下:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. 如果您使用的是 androidx.privacysandbox.ads Jetpack 程式庫,請務必使用 1.1.0-beta05 以上版本

有哪些開發人員資源可供使用?

Android 版 Privacy Sandbox Beta 版計畫提供下列工具和資源。

SDK 和模擬器系統映像檔

在 Android Studio 中,您可以透過 SDK Manager 下載最新的 Ad Services Extension 和模擬器系統映像檔。進一步瞭解如何設定開發環境及設定 API 存取權。

API 參考資料

歡迎查看完整的 API 參考資料

支援和意見回饋

在使用 Android 版 Privacy Sandbox 測試和開發應用程式時,請查看版本資訊,並使用 Issue Tracker 回報問題,提供意見回饋。

將開發環境維持在最新狀態

我們強烈建議您將開發環境維持在最新版本狀態。這樣一來,您就能取得最新的功能和安全性修補程式,環境也能與依附元件的最新版本相容。如要接收新版本的通知,請訂閱電子郵件最新消息