Topics API: テストと分析のツール

Topics API 情報の表示、トピックの割り当ての仕組み、実装のデバッグを行うために Chrome に用意されているツールについて説明します。

Topics API の情報を表示する

chrome://topics-internals ページは、Topics API を有効にすると、パソコン版 Chrome で利用できるようになります。現在のユーザーのトピック、ホスト名から推測されるトピック、API 実装に関する技術情報が表示されます。デベロッパーからのフィードバックに基づいて、ページのデザインを改善しています。Topics API の開発にご協力いただける場合は、Chromium のバグとしてフィードバックを送信してください。

ブラウザで確認されたトピックを表示する

ユーザーは chrome://topics-internals を表示することで、現在のエポックと前のエポックでブラウザで検出されたトピックに関する情報を確認できます。

<ph type="x-smartling-placeholder">
</ph> [Topics State] パネルが選択されている chrome://topics-internals ページ。
chrome://topics-internals ページの [トピックの状態] パネルには、トピック ID、ランダムおよび実際のトピック割り当て、分類とモデルのバージョンが表示されます。

このスクリーンショットは、最近アクセスしたサイトに topics-demo-cats.glitch.me と cats-cats-cats-cats.glitch.me が含まれていることを示しています。これにより、Topics API は現在のエポックの上位 2 つのトピックとして Pets と Cats を選択します。残りの 3 つのトピックは、5 つのトピックを表示するのに十分な閲覧履歴が（トピックを検出するサイトに）ないため、ランダムに選択されています。

[観測されたコンテキストのドメイン（ハッシュ）] 列には、トピックが観測されたホスト名のハッシュ値が表示されます。

ホスト名から推測されたトピックを表示

chrome://topics-internals で、1 つ以上のホスト名について Topics の分類モデルによって推論されたトピックを表示することもできます。

<ph type="x-smartling-placeholder">
</ph> [分類システム] パネルが選択された chrome://topics-internals ページ。
[chrome://topics-internals] ページの分類パネルには、選択されたトピック、訪問したホスト、モデルのバージョンとパスが表示されます。

Topics API の現在の実装では、ホスト名からのみトピックを推測します。URL の他の部分からのものはありません。

chrome://topics-internals 分類システムから推測されたトピックを表示するには、ホスト名のみ（プロトコルやパスなし）を使用します。「/」を含めようとすると、chrome://topics-internals でエラーが表示されます」と入力します。

Topics API の情報を表示する

分類バージョンやエポック期間など、Topics API の実装と設定に関する情報は、chrome://topics-internals で確認できます。これらの値は、コマンドラインから正常に設定された API またはパラメータのデフォルト設定を反映しています。これは、コマンドライン フラグが想定どおりに機能していることを確認するのに役立ちます。

この例では、time_period_per_epoch は 15 秒に設定されています（デフォルトは 7 日）。

[機能とパラメータ] パネルが選択された 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 の説明またはチュートリアル動画をご覧ください。この 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.

See also

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