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 提供的任何標準管道與他們聯絡。

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

另請參閱

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