本文件包含指南,以協助您根據常見用途為 SDK 執行階段整合做好準備。
為協助您進行整合規劃,這可讓您全面瞭解整合程序,其中可能包含尚未在 Privacy Sandbox Android 開發人員預覽階段中實作的功能。在這些情況下,相關詳細資料會標示為尚未實作。
整合目標
目前 Android 版 Privacy Sandbox 開發人員預覽版階段,整合計劃的目標包括:
- 確認測試環境中的技術正確性
- 確認與現有技術基礎架構的相容性
- 定義並驗證整合規定
目前開發人員預覽版本目前支援的應用實例和功能:
- 遠端載入及顯示橫幅廣告
- 從儲存空間寫入/讀取
- 雙向通訊
- 獨立影片廣告
即將推出的開發人員預覽版計劃支援更多用途及技術功能。待這些功能推出後,本指南就會反映相關細節進行更新。
- 原生廣告
- 全螢幕廣告
必要條件
- 設定 Android Studio 和 Developer Preview SDK。
- 為裝置或模擬器安裝系統映像檔。
- 查看「SDK 執行階段開發人員指南」,並視需要查看範例程式碼。
整合步驟
1. 確認測試環境中的技術正確性。
- 建立測試應用程式和測試 SDK,以熟悉 Android SDK 執行階段中的 Privacy Sandbox。在這個階段,您也可以開始使用 GitHub 上的範例應用程式。
- 在裝置或模擬器上安裝及執行 SDK 與應用程式,並確認
WebView
會載入所提供的網址。 - 透過 SDK 執行階段從遠端在應用程式中顯示廣告。
- 在 SDK 程式碼中新增中斷點並連線至該程序,確保系統可以進行偵錯。
2.確認與現有技術基礎架構的相容性。
- 開發人員預覽功能推出後,Android 上的 Privacy Sandbox 需要至少 33 的目標 API 級別。找出現有程式碼集的遷移路徑。評估您的應用程式或 SDK 與 Android 13 中導入的其他變更是否相容。
- 確認開發工具鏈與您的應用程式是否相容 (如適用)。
- 視需求重構程式碼集,以重複使用任何一般邏輯。有些開發人員可能偏好使用單一程式碼集。如果是這種情況,請確認這個方法的可行性。
3.定義並驗證整合規定。
- 檢查目前 SDK 解決方案的資料存取權需求、與用戶端應用程式的互動模型,以及 SDK 執行階段設計的系統元件。
- 顯示 SDK 執行階段中支援的其中一個廣告類型,並確認廣告是否可互動,藉此驗證 SDK 是否已載入。
- 如果適用於您業務的應用實例,請確認 TOPICS、FLEDGE 或 Attribution Reporting APIs 可透過 SDK 執行階段程序執行。
- 透過 ADB 或 Android Studio,然後逐步檢查程式碼,檢查 SDK 執行階段程序是否可進行偵錯。