Topics API：測試和分析工具

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

查看 Topics API 資訊

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

查看瀏覽器觀察到的主題

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

「Topics」頁面的「Topics State」面板會顯示主題 ID、隨機和實際主題指派，以及分類和模型版本。

chrome://topics-internals

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

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

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

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

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

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

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

查看 Topics API 資訊

您可以在 chrome://topics-internals 中找到 Topics API 導入和設定的相關資訊，例如分類法版本和紀元時間長度。這些值反映了 API 或參數的預設設定，這些參數是透過指令列成功設定。這有助於確認指令列旗標是否正常運作。

注意：在 2023 年 6 月前，Topics 使用的是舊版分類。

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

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

「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

Control & transparency

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.

Support

Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.

• Check out Topics demos, collab and walkthrough videos.
• See the list of Chrome flags that allow developers to customize the Topics API for testing.
• See how users and developers can control the API.
• Check out the resources for technical explainers and support. Ask questions, engage and share feedback.