Topics API：整合指南

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Topics API for Android 旨在支援按照興趣顯示的廣告，不必依賴跨應用程式 ID。

廣告客戶會嘗試放送與使用者興趣相關的廣告。舉例來說，如果某位使用者對烹飪相關資訊有興趣，則相較於與其興趣無關的廣告，該使用者可能會覺得烹飪相關廣告更符合自身需求。

按照興趣顯示廣告 (IBA) 是一種個人化廣告形式，即根據使用者的興趣來選擇廣告。在 Android 版 Privacy Sandbox 中，這些興趣衍生自使用者互動的應用程式。這點與「內容相關廣告」不同。在「內容相關廣告」模式下，系統只會透過使用者目前瀏覽的內容推斷其興趣，並據此顯示廣告。相較於內容相關廣告，IBA 可讓應用程式顯示更符合使用者需求、更具吸引力的廣告。

IBA 通常涉及應用程式、賣家與買家之間的溝通。本指南適用於各方當事人，包括以買家和賣家身分運作的網路和廣告技術。

Topics API 會根據使用者的應用程式使用情形，在裝置上推斷出概略的興趣信號。當這些稱為「主題」的信號與廣告客戶共用後，後者就無需跨應用程式追蹤個別使用者即可支援 IBA。

使用 Topics API 導入按照興趣顯示的廣告時，須考量以下重點：

  • 系統在裝置上處理使用者興趣的推論：使用者關於確切安裝在使用者裝置上的應用程式資訊不會外洩，且隱私權受到保護。這個模型與現行常用的模型建立模型不同。該模型會將使用者跨應用程式的資料傳送至裝置，並由廣告技術伺服器處理。某些類型的處理功能會繼續留在廣告技術伺服器上，例如，使用 Topics API 在個人化和最佳化模型中提供的信號用於廣告選擇。

  • 買家和廣告客戶取決於賣方：若要取得主題，賣方應用程式和 SDK 必須為至少 1 個訓練週期由 Topics API 觀察者建立基礎。

術語

  • 廣告客戶：透過購買廣告空間的方式與使用者互動的公司。
  • 發布商：銷售其內容旁邊的廣告空間的公司。
  • 買家 (或買方)：一種廣告技術公司，可協助廣告客戶購買廣告空間
  • 賣家 (或賣方)：可協助發布商銷售廣告空間的廣告技術公司
  • 網路：同時擔任買方和賣方的廣告技術公司。
  • 自有自營：同時擔任發布商、賣方和買方的公司。

目標

如果 IBA 對您的業務至關重要，我們希望您在應用程式業務案例中建構 Topics API 版本，以便我們取得意見回饋並協助您建立 API。我們希望確保您能解除封鎖設計和開發項目，以便在 Beta 版推出時取得主題。

目前，Android 開發人員預覽版的 Privacy Sandbox 的整合計畫的目標包括具備以下能力：

適用於所有廣告技術

  • 查看主題分類，並就納入的主題提供意見回饋。
  • 試用 Topics API 範例應用程式，瞭解裝置上分類器傳回哪些主題資料。
  • 更新應用程式和 SDK 流程以開始呼叫 Topics API。
  • 更新通訊協定，以開始在廣告請求中傳送主題。
  • 透過 Privacy Sandbox 註冊廣告技術。

適用於賣家廣告技術

  • 成為觀察者以建立 Topics API 足跡。Topics API 是新的信號，請更新 SDK 以開始呼叫 Topics API。如要持續擷取主題，應用程式每訓練週期必須至少要呼叫 API 一次。廣告請求最多需要 4 個週期 (3 個主題) 才能隨著廣告請求傳送。
  • 在廣告請求中加入 Topics API 資訊。針對每個廣告請求，開始與買方合作夥伴分享 Topics API 資料。Topics API 旨在補充其他信號 (例如比對內容訊號)，協助找出特定訪客適用的廣告。
  • 透過通訊協定與您與買方合作夥伴分享主題。Topics API 需要每個 SDK 與下游合作夥伴合作，才能同意 Topics API 資料的共用方式。

適用於買方廣告技術

  • 與賣方合作夥伴聯絡，確認他們有打算觀察主題及建立足跡。如要接收主題，賣方供應商必須至少在每個週期中呼叫 Topics API 一次。
  • 透過通訊協定接收來自賣方合作夥伴的主題。「主題」是新的信號，可讓買方合作夥伴在廣告請求中共用。買方消費者必須確保與上游合作夥伴討論主題的分享方式。
  • 將出價和最佳化模型納入主題。Topics API 應該補充其他信號 (例如比對內容)，協助找出適當的訪客廣告。

事前準備和設定

應用程式開發人員、賣家和買家應按照下列步驟，使用 Topics API 進行設定。

熟悉 API

  1. 首先詳讀設計提案，熟悉 Topics API 和相關功能。
  2. 詳閱開發人員指南，瞭解如何整合用途所需的程式碼和 API 呼叫。
  3. 查看分類，針對清單中的主題提供意見回饋。
  4. 針對設計提案或說明文件提供意見回饋。
  5. 註冊即可接收 Topics API 的最新消息。有助於隨時掌握日後版本推出的新功能。

設定並測試範例應用程式

  1. 請按照本頁的操作說明在 Android Studio 中對 Android 版 Privacy Sandbox 的 SDK 進行設定。
  2. 建立並執行範例應用程式的 Java 或 Kotlin 版本程式碼，以熟悉在裝置上擷取主題的方式。
  3. 在測試期間，嘗試使用應用程式資訊來說明並解釋，變更裝置端分類器會傳回哪些主題。
  4. 瞭解用戶端 API 和裝置端分類的運作方式後，請參考範例應用程式作為示例來引導自己整合。

提示：詳閱應用程式傳回的主題資料實用性。找出您認為可以改善的分類方式或分類法，如果您有如何改善分類法的建議，請提供意見回饋。