Attribution Reporting API:整合指南

Attribution Reporting API 的設計宗旨是要避免仰賴跨各方使用者 ID,進一步保護使用者隱私,同時顧及重要使用情境,支援應用程式的歸因與轉換評估功能。這份文件包含的指南可協助您準備 Attribution Reporting API 的整合作業。

本指南會嘗試提供完整的檢視畫面,其中可能包括 Android 開發人員預覽版 Privacy Sandbox 中目前尚未實作的功能。在這些情況下,相關詳細資料會標示為尚未實作。

整合目標

在 Privacy Sandbox 開發人員預覽階段中,整合規劃的目標包括:

目前和即將推出的支援

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

  • 來源優先、最終接觸歸因和安裝後歸因。
  • 註冊應用程式歸因來源和應用程式觸發條件。
  • 接收事件層級報表。
  • 接收未加密的匯總報表。

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

  • 廣告技術平台註冊
  • 偵錯支援,協助開發人員將匯總報表與現有機制的報表進行比較。
  • 註冊網頁歸因來源和網站觸發條件,以支援應用程式到網路的歸因分析。
  • 接收來自 API 的加密匯總報表,並將批次資料傳送至匯總服務。
  • 從匯總服務接收摘要報表。
  • 使用 API 需要新的一般權限。

適用的廣告技術目標對象

如要接收來自 Attribution Reporting API 的報表,廣告技術平台必須同時註冊歸因來源和觸發條件。至少要啟用完整的端對端測試,廣告放送技術和行動評估合作夥伴應攜手合作,以呼叫同一廣告客戶的 API,且可能需要在登錄呼叫中使用重新導向。您可能還需要與發布商或廣告客戶應用程式合作。

如果是歸因來源註冊,API 呼叫通常是由用來在發布商應用程式中放送廣告的廣告技術 SDK 啟動,但應用程式也可以直接呼叫 API。

針對觸發條件註冊,API 呼叫通常是由廣告客戶的應用程式中的行動裝置測量夥伴的 SDK 所啟動,或者單獨從廣告客戶應用程式自行啟動。

必要條件

整合步驟

為了準備將 Attribution Reporting API 整合至解決方案,請完成下列各節所述的步驟。

確認測試環境中的技術正確性

  • 建立測試應用程式和測試 SDK,以熟悉 Android Attribution Reporting API 中的 Privacy Sandbox。在這個階段,您也可以開始使用 GitHub 上的範例應用程式
  • 設定模擬伺服器端點使用我們的範例伺服器,以便瞭解歸因報表用戶端 API 所使用的 REST API 簽章。
  • 註冊事件,包括觀看、點擊和轉換 (觸發條件) 事件。
  • 為了進行測試,請使用適當的 ADB 指令強制執行報表工作,以縮短接收事件層級和匯總報表的報表資料時間。
  • 評估 API 簽名是否適用於目前的技術堆疊。包括輸入參數和傳回值。找出資料流和因應措施中的任何落差。

確認與現有技術基礎架構的相容性

  • 用戶端開發環境和程式碼集:
    • 開發人員預覽功能推出後,Android 上的 Privacy Sandbox 需要至少 33 的目標 API 級別。找出現有程式碼集的遷移路徑。評估您的應用程式或 SDK 與 Android 13 中導入的其他變更是否相容。
  • 伺服器端:
    • 將 API 虛設端點新增至現有的技術基礎架構,以找出並驗證任何技術限制。
    • 新增回呼以接受現有技術基礎架構的報表。

定義並驗證整合規定

  • 驗證記錄或伺服器資料中的報表,其中包含來自觀看、點擊和轉換的資料。
  • 驗證事件層級和匯總層級報表。