Topics API:測試和分析工具

瞭解 Chrome 提供的工具,查看 Topics API 資訊,並瞭解主題的指派方式。

查看 Topics API 資訊

chrome://topics-internals 頁面會在您啟用 Topics API 後,顯示在 Chrome 電腦版中。這會顯示目前使用者的主題、為主機名稱推斷的主題,以及 API 實作的技術資訊。我們會根據開發人員的意見回饋,反覆改善頁面設計。如要影響 Topics API 的發展方向,請以 Chromium 錯誤的形式提交意見回饋。

查看瀏覽器觀察到的主題

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

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

這張螢幕截圖顯示最近造訪的網站包括 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推斷的主題。如果您嘗試在「主機」欄位中加入「/」,chrome://topics-internals 會顯示錯誤訊息。

查看 Topics API 資訊

您可以在 chrome://topics-internals 中找到 Topics API 實作和設定的相關資訊,例如分類法版本和週期長度。這些值會反映 API 的預設設定,或從指令列成功設定的參數。這有助於確認指令列旗標是否正常運作。

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

選取「Features」和「Parameters」面板的 chrome://topics-internals 頁面。
「功能和參數」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 說明或逐步解說影片中。請注意,本程式碼研究室使用的是舊版分類

在採用 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 在網路上的運作方式。