測試、部署及擴大採用以主題為基礎的解決方案

本頁說明如何使用 Topics API 建構、測試及擴充實作項目，以供正式環境使用。

主題後端實作

後端實作方式取決於您要如何使用瀏覽器計算出的主題。建議廣告技術解決方案將 Topics 做為額外的IBA信號。

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

將 Topics 做為額外信號

主題資料可與網址、關鍵字或其他中繼資料等其他信號一併視為目標對象的額外信號。

如「在無第三方 Cookie 時代盡可能提高廣告關聯性」一文所述，您可以透過多種方式運用 Topics 放送相關廣告。其中有些方法會使用主題建立目標對象，其他方法則建議將主題當做其中一個信號，用來訓練機器學習模型，藉此推斷目標對象的其他興趣，甚至是最佳化出價邏輯。

建構及部署

  1. 在正式環境中觀察使用者，收集主題 (預估實作時間：約一週)：
    • 瞭解選項：如何透過 HTTP 標頭或 iframe 和 JavaScript 呼叫 Topics。
    • 定義將呼叫 Topics API 的 iframe 網域。
    • 使用標頭示範或 JavaScript 示範做為程式碼參考，建構解決方案。
    • 將 Topics 整合至發布商嵌入網站的程式碼 (例如廣告 iframe)。請務必從嵌入呼叫主題。
    • 如要開始觀察使用者主題，請在正式版網站中嵌入最新版指令碼。我們建議您先在每月造訪次數較少的自家網站上測試導入作業，在這個階段，建議您在至少五個網站上嵌入新的主題式解決方案。
    • 此時，API 預期會傳回空陣列做為結果。這是因為系統尚未觀察到使用者的任何主題。最多可能需要三週，才能開始取得使用者主題。
    • 執行功能測試和驗證。您可以手動或自動測試解決方案。例如：
      • 開啟瀏覽器並設定旗標，將時間間隔設為 15 秒，讓瀏覽器更快重新計算主題。
      • 前往嵌入指令碼的網站。
      • 檢查指令碼是否在 chrome://topics-internals/ 上觀察主題。
      • 瞭解預期結果。
  2. 搭配其他比對內容信號 (例如網址、中繼資料等) 使用 Topics 資料。(預估時間：約 3 天)。
    • 在實際工作環境中執行三週後，指令碼應該會觀察到部分使用者的主題。此時，您應該就能使用主題資料做為額外的信號。
    • 開始收到非空白的主題清單後，您就可以將清單連同其他比對內容信號傳送至後端。

部署至目標網站

將 Topics 呼叫整合至指令碼後，請務必先在部分正式版網站上嵌入指令碼，進行初步測試。請確認導入作業是否正常運作：

  • 呼叫 Topics API。
  • 您可以在這個受控環境中觀察主題。
  • 存取主題 (API 會傳回使用者觀察到的主題)。

選擇目標網站

將解決方案部署至發布商網站前，建議您先在自己擁有的網站上，於受控環境中進行測試。建議您按照下列方式挑選目標網站：

  • 網站每月造訪次數較少 (每月約少於一百萬次)：您應先向一小部分目標對象部署 API。
  • 您擁有並控管網站：如有需要，您可以快速停用實作項目，不必經過複雜的核准程序。
  • 網站並非業務關鍵：從低風險目標網站開始。
  • 最多五個網站：目前不需要太多流量或曝光度。
  • 目標網站代表不同主題：選擇代表不同類別的網站 (例如運動、新聞、美食和飲料)。您可以使用 Chrome 內建的主題工具，驗證網域以及 Topics 機械學習分類器如何分類網域。

功能測試和驗證

在這種受限環境中呼叫 Topics API 時，預期會得到下列結果：

  • 如果這是過去七天內，這個裝置首次為這個網站和呼叫端呼叫這個方法，則會傳回主題的空陣列 []。

  • 最多三個主題的清單，代表這位使用者的興趣。觀察期結束後，您應該會收到：

    • 系統會根據該週呼叫端觀察到主題的網頁主機名稱，計算出使用者最感興趣的五大主題，並從中選取一個。

  • 與先前所有 Topics API 呼叫完全相同的 API 回應。對於同一呼叫端、使用者和頂層網站，API 會在整個週期內傳回相同的主題。以免暴露過多使用者興趣。如要瞭解詳情，請參閱 GitHub。

  • 如果您在觀察期滿四週後呼叫 Topics，系統會以新主題取代其中一個舊主題。

  • 如果您在過去三週或更久的時間內，未觀察到使用者的主題，Topics API 就會再次傳回空白陣列 []。

收集成效指標，評估使用者體驗：

  • 應測量跨來源 iframe 中對 Topics API 的 JavaScript 呼叫執行時間，以供日後進行效能分析。
  • 收到主題後，建立 iframe 和 postMessage() 主題所需的時間。

如要排解問題，請參閱 支援一節。

擴大規模以供實際運作

此時您應該已在受控環境 (您擁有的部分網站) 中測試過 Topics。如果一切運作正常，就可以開始擴大導入範圍。將相同程式碼部署至更多目標網站。這樣一來，您就能觀察更多使用者、收集更多主題資料，並深入瞭解目標對象。

以下逐步摘要說明如何擴大規模以用於正式環境：

  1. 在流量較高的情況下測試主題型解決方案。
    • 將 iframe 新增至更多您擁有的網站，並增加造訪次數，然後按照下列操作說明執行負載測試。
  2. 將解決方案部署至發布商網站。
    • 確認解決方案在自己的測試環境中正常運作後，請與發布商合作，將 iframe 整合至他們的網站。舉例來說，他們可能需要更新包含 iframe 的程式庫。
  3. 處理及使用主題資料 (預估時間：約四週)。
    • 將主題資料與其他資料一併做為加成信號。
    • 尋找即時出價測試合作夥伴。
    • 以主題做為其他資料的加成信號，執行公用程式測試。

負載測試

為確保系統能處理流量，建議您先執行負載測試，再將主題解決方案部署至發布商網站。

  1. 逐步在更多您擁有的目標網站上部署，尤其是流量較大的網站。
  2. 根據預期流量，對主題資料執行負載測試。
    • 您需要將主題資訊從 iframe 傳送至後端。您可以進一步處理 Topics API 結果，並將其做為額外信號，協助選取與使用者更相關的廣告。隨著越來越多網站納入您的嵌入內容，後端呼叫次數會大幅增加。確認後端可處理來自 iframe 的大量呼叫。
    • 設定指標收集和記錄檔，以利分析。
  3. 部署 Topics API 後，請立即檢查指標，偵測是否有嚴重的使用者問題。請定期查看指標。
  4. 如果發生中斷或異常行為，請回溯部署作業，並分析記錄來瞭解及修正問題。

另請參閱

請參閱我們的資源，進一步瞭解 Topics API 在網路上的運作方式。