SDK 執行階段 API:整合指南

本文件包含指南,以協助您根據常見用途為 SDK 執行階段整合做好準備。

為協助您進行整合規劃,這可讓您全面瞭解整合程序,其中可能包含尚未在 Privacy Sandbox Android 開發人員預覽階段中實作的功能。在這些情況下,相關詳細資料會標示為尚未實作。

整合目標

目前 Android 版 Privacy Sandbox 開發人員預覽版階段,整合計劃的目標包括:

  • 確認測試環境中的技術正確性
  • 確認與現有技術基礎架構的相容性
  • 定義並驗證整合規定

目前開發人員預覽版本目前支援的應用實例和功能:

  • 遠端載入及顯示橫幅廣告
  • 從儲存空間寫入/讀取
  • 雙向通訊
  • 獨立影片廣告

即將推出的開發人員預覽版計劃支援更多用途及技術功能。待這些功能推出後,本指南就會反映相關細節進行更新。

  • 原生廣告
  • 全螢幕廣告

必要條件

整合步驟

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 執行階段程序是否可進行偵錯。