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 は現在のエポックの上位 2 つのトピックとして PetsCats を選択します。残りの 3 つのトピックは、5 つのトピックを表示するのに十分な閲覧履歴が(トピックを検出するサイトに)ないため、ランダムに選択されています。

[確認元コンテキスト ドメイン(ハッシュ化)] 列には、トピックが検出されたホスト名のハッシュ値が表示されます。

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

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

[分類システム] パネルが選択された 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.