Topics API：測試和分析工具

瞭解 Chrome 提供的工具，包括查看 Topics API 資訊、瞭解主題的指派方式，以及偵錯實作內容。

查看 Topics API 資訊

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

查看您瀏覽器觀察到的主題

使用者可以查看 chrome://topics-internals，查看在目前和上一個週期期間觀察到的瀏覽器主題相關資訊。

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

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

查看 Topics API 資訊

您可以在 chrome://topics-internals 中找到 Topics API 實作項目和設定，例如分類版本和訓練週期持續時間。這些值反映了 API 或參數的預設設定，這些參數是在透過指令列成功設定。這有助於確認指令列標記是否正常運作。

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

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

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

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.