開始使用 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 擴充功能提供 釋出方法。這個發布方法可啟用穩定版 Android 不會推出其他重要版本它採用了新的版本管理機制,可透過 Google Play 系統更新,為不同 API 級別的應用程式提供新的 API。Android 版 Privacy Sandbox 的 SDK 擴充功能稱為「Ad Services Extensions」。進一步瞭解 Android SDK 擴充功能

開始使用

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

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

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

步驟 2:設定開發環境

在 Android Studio 中設定 Android 版 Privacy Sandbox SDK

步驟 3:設定 AdServices 權限

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

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

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

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

調整設定以啟用 (或停用) 隱私權 Android 版沙箱,以便在裝置上執行。

排解已知問題

為避免在 Android 12 以下版本的裝置上整合廣告服務 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 回報問題及提供意見回饋。

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

強烈建議您將開發環境維持在最新狀態 最新版本。這可確保你享有最新功能 修補程式,並確保您的環境與 依附元件版本如要接收新書上架的通知,請按照下列步驟操作: 訂閱電子郵件通知