開始使用 Android 版 Privacy Sandbox

Android 版 Privacy Sandbox Beta 版計畫提供穩定版 API。我們 並規劃在 2023 年推出多個 Beta 版本。您可以使用 Beta 版計畫 版本：建構及測試解決方案，在 Android 平台進行小範圍的正式版測試 所有 API 均有超過 13 台行動裝置，以及 Android 12 以上版本的 Attribution Reporting API (ARA)。 我們會開始支援少數裝置，並隨著時間增加支援的裝置數量。 機構可要求存取特定裝置、 以及註冊任何使用 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 回報問題及提供意見回饋。

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

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