開始使用 Android 版 Privacy Sandbox

Android 版 Privacy Sandbox Beta 版計畫提供穩定的 API。我們預計在 2023 年推出數個 Beta 版本。您可以使用 Beta 版計畫建構及測試解決方案,在少數 Android 13 行動裝置上進行正式版測試。我們一開始會支援少數裝置,並逐步增加支援的裝置數量。如要參與計畫,機構組織可以要求使用特定裝置的存取權,並註冊任何使用 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 擴充功能

開始使用

如要開始使用,請按照下列步驟執行:

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

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

步驟 2:設定開發環境

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

步驟 3:設定 AdServices 權限

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

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

如要執行端對端測試,您必須與支援的 Android 13 裝置互動,或使用模擬器映像檔,以取得適當的 SDK Extension。

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

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

排解已知問題

為避免在 Android 12 以下版本裝置上整合 PP API 時發生已知問題,如果開發人員整合 Android 12 以下版本裝置的廣告服務 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 回報問題並提供意見回饋。

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

我們強烈建議您將開發環境維持在最新版本。這可確保您擁有最新的功能和安全性修補程式,且您的環境與最新版本的依附元件相容。如要持續收到新版本的通知,請訂閱電子郵件通知