Topics API:測試和分析工具

瞭解 Chrome 中可用於查看 Topics API 資訊的工具,以及主題的指定方式。

查看 Topics API 資訊

啟用 Topics API 後,電腦版 Chrome 就會提供 chrome://topics-internals 頁面。這會顯示目前使用者的主題、主機名稱推測的主題,以及 API 實作方式的技術資訊。我們會根據開發人員的意見回饋,不斷調整及改善頁面設計。如要塑造 Topics API,請提交 Chromium 錯誤做為意見回饋。

查看瀏覽器觀察到的主題

使用者可以查看 chrome://topics-internals,瞭解瀏覽器在目前和先前週期觀察到的主題。

chrome://topics-internals 頁面,已選取「Topics State」面板。
「Topics」(主題) 頁面「Topics State」(主題狀態) 面板會顯示主題 ID、隨機和實際主題指派,以及分類和模型版本。
chrome://topics-internals

這張螢幕截圖顯示最近造訪的網站包括 topics-demo-cats.glitch.mecats-cats-cats-cats.glitch.me。這會導致 Topics API 選取 PetsCats 做為目前週期中的兩個熱門主題。系統會隨機選擇剩餘的三個主題,因為瀏覽記錄 (在觀察主題的網站上) 不足以提供五個主題。

「觀察到的內容網域 (經雜湊處理)」欄會提供主題觀察到的主機名稱的雜湊值。

查看系統為主機名稱推斷的主題

您也可以查看主題分類器模型針對 chrome://topics-internals 中一或多個主機名稱推論的主題。

chrome://topics-internals 頁面,並選取「分類器」面板。
chrome://topics-internals 頁面「分類器」面板會顯示所選主題、造訪主機、模型版本和路徑。

Topics API 目前的實作方式只會從主機名稱推斷主題,不會從網址的任何其他部分推斷。

請只使用主機名稱 (不含通訊協定或路徑),查看 chrome://topics-internals 分類器推斷的主題。如果您嘗試在「Host」欄位中加入「/」,chrome://topics-internals 會顯示錯誤訊息。

查看 Topics API 資訊

如要瞭解 Topics API 導入和設定 (例如分類法版本和紀元時間長度),請參閱 chrome://topics-internals。這些值反映了 API 或參數的預設設定,這些參數是在透過指令列成功設定。這有助於確認指令列旗標是否正常運作。

我們建議使用最新的分類版本,放送更貼近您需求的廣告。

在這個範例中,time_period_per_epoch 已設為 15 秒 (預設為七天)。

chrome://topics-internals 頁面,已選取「功能和參數」面板。
「Features and Parameters」面板會顯示已啟用的功能、每個 epoch 的時間、用於計算主題的 epoch 數量、分類版本和其他設定。
chrome://topics-internals

螢幕截圖中顯示的參數對應至指令列執行 Chrome 時可設定的標記。如要進一步瞭解如何使用 Chrome 旗標控制 Topics API,請參閱專屬的設定部分。

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Colab

請執行 Colab,瞭解如何載入 Chrome 用於從主機名稱推論主題的 TensorFlow Lite 模型。您可以在 Colab 說明或操作說明影片中找到操作說明。請注意,這個 Colab 使用的是舊版分類系統

在使用 prebid.js 的網站上使用 Topics API

Prebid 7 的發布說明所述,社群積極使用新模組開發與 Topics API 的整合功能。這個模組已於 2022 年 12 月合併。請參閱 Prebid 的 Topics API 模組說明文件。如要進一步瞭解整合作業,請透過 Prebid.js 提供的任何標準管道與他們聯絡。

後續步驟

瞭解使用者和開發人員如何管理及自訂 Topics API,以符合使用者的偏好設定和需求。
請查看我們的資源,瞭解如何排解問題、取得技術支援、回報錯誤和提出問題。

另請參閱

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