版本資訊

Android Privacy Sandbox 開發人員預覽版旨在協助初期開發、測試和意見回饋。Android Privacy Sandbox 開發人員預覽版仍在開發階段的初期版本,因此不一定能夠正常運作。Privacy Sandbox 開發人員預覽版日後可能會有所異動,也歡迎提供意見回饋

如要開始使用,請首先設定您的開發環境,然後將 Android 版的 Privacy Sandbox 閃存在您的測試裝置模擬器上。

目前版本

Android 版 Privacy Sandbox 開發人員預覽版 4

發布日期:2022 年 7 月 14 日

Android 版 Privacy Sandbox 開發人員預覽版 4 新增以下功能:

SDK 執行階段

  • 應用程式現在可以透過新增 sendData(),與執行階段啟用的 SDK (RE-SDK) 通訊。
  • 本機儲存空間現在可在 SDK 執行階段流程中使用。
  • SDK 也可以在 SDK 執行階段中呈現獨立式影片廣告或內容。
  • 新增有關反射使用情形的說明,包括內容不在其他 RE-SDK 中的用途。

Attribution Reporting API

這個版本推出了一些變更,讓 Attribution Reporting API 的使用更清楚地呈現,例如:

  • 匯總報表格式的變更以改善可讀性。
  • 更新「轉換篩選」和「可出價」功能的標頭欄位。
  • 在「WebApp API 參考資料」中新增說明,以說明來源和觸發條件註冊,以及隱私權和同意 API 的可用性。

Android API 上的 FLEDGE

這個版本包含可協助測試及偵錯的新功能,以及內部改善功能:

  • 新增支援至覆寫遠端網址,以在開發期間擷取 JavaScript 邏輯。
  • 改善廣告選擇期間的錯誤回報。
  • 系統會在廣告選擇期間篩選出無效的自訂目標對象。

Topics API

這個版本對 Topics API 進行幾項重大變更,最重要的是:

  • [getTopics()] API 的傳回類型已變更為新的 Topic 物件類型,該物件會封裝與分類法中主題對應的整數 ID 以及分類器和分類版本的相關資訊 您應使用此 API 更新任何現有的應用程式。
  • 現在使用 Topics API 需要新的一般權限。
  • 「裝置端分類工具」系統推出,可根據可公開取得的應用程式資訊動態指派主題。

過往版本

開發人員預覽版 3

發布日期:2022 年 6 月 9 日

Android 版 Privacy Sandbox 開發人員預覽 3 加入 Attribution Reporting API 和 Android 版 FLEDGE 的功能。

Attribution Reporting API

Attribution Reporting API 透過避免仰賴跨方 ID 的方式,進一步保護使用者隱私,同時顧及重要使用情境,支援應用程式和網頁的歸因與轉換評估功能。

這個版本包含開發人員資源,可協助您測試下列 Attribution Reporting API 功能:

  • 登錄歸因來源並觸發事件
  • 採用來源優先和安裝後歸因
  • 接收事件報表
  • 接收可匯總的報表 (此版本未經過加密)

提供應用程式範例與參考廣告技術伺服器,以協助進行測試

已知問題:

Android 版 FLEDGE

Android 的 FLEDGE 導入新的廣告顯示方法:根據應用程式開發人員定義的「自訂目標對象」和應用程式內互動情形來放送廣告。這項解決方案會將這些資訊和相關聯的廣告儲存在本機,並提供一個工作流程架構,方便使用自動化調度管理方式選取廣告。

這個版本包含開發人員資源,可協助您測試下列 Android 版 FLEDGE 功能:

  • 加入或退出自訂目標對象,並觀察參數值如何影響競價結果
  • 從遠端端點擷取 JavaScript 競價代碼
  • 設定及啟動裝置端廣告競價
  • 處理曝光報表
  • 提供範例應用程式和模擬伺服器設定,以協助進行測試

已知問題:

開發人員預覽版 2

發布日期:2022 年 5 月 17 日

開發人員預覽版 2 包含 MeasurementManager Attribution Reporting API 的早期預覽。

  • 您可以呼叫 registerSource()registerTrigger() 註冊應用程式廣告事件,並取得應用程式到應用程式歸因的事件層級報表資料。我們目前採用的是最終接觸歸因模式。報表將按照報表期的定義寄送。詳情請參閱 MeasurementManager API 參考資料。
  • 實際上傳報表的時間是固定的時段,而不是確切的安排時間。報表上傳間隔預設為 4 小時,但可以透過下列 adb 指令覆寫:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
    
  • 我們會在日後推出的版本中發布用來測試 API 的範例應用程式和參考廣告技術供應商伺服器。

  • 我們將在日後推出的版本中提供其他 MeasurementManager Attribution Reporting API 功能,例如匯總報表、安裝後歸屬和重新導向。

開發人員預覽版 1

發布日期:2022 年 4 月 28 日

開發人員預覽版 1 包含 Topics APISDK 執行階段的早期預先發布版。日後推出的版本將支援 Android 版 FLEDGEAttribution Reporting API 功能。

  • Topics API
    • getTopics() API 目前會根據部分應用程式的離線分類功能傳回測試值。尚未實作裝置端分類。
    • 您可以使用 adb 指令覆寫週期間隔並強制觸發週期運算。
    • 詳情請參閱「主題開發人員指南」。
  • SDK 執行階段
    • 您可以使用 SDK 應用程式資訊清單檔案中的新 <sdk-library> 元素,來封裝及建構支援執行階段的 SDK (RE SDK)。在支援的測試裝置或模擬器上安裝 RE SDK,如同您平常在開發期間安裝應用程式一樣。
    • 您可以將應用程式與 RE SDK 整合、載入至 SDK 執行階段,並測試受限存取權對 SDK 程式碼的影響 (權限、記憶體和應用程式對 SDK 通訊)。RE SDK 專用的 Storage API 尚未實作,將於日後推出的版本中推出。
    • SDK 可以在 SDK 執行階段中,提供以 WebView 為基礎的橫幅廣告或內容。
    • 詳情請參閱「SDK 執行階段開發人員指南」。
  • Android Lint 檢查
    • 在以 API 級別 TiramisuPrivacySandbox 編譯的專案中,Android Lint 檢查可能會無法正確顯示警告。舉例來說,您可能會看到這樣的警告訊息:「Call requires API level 33」(呼叫需要 API 級別 33)。您可以使用 @SuppressLint("NewApi") 註解來臨時解決這個問題。