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

Chrome で Topics API の情報を表示するために利用できるツールについて学び、トピックがどのように割り当てられるかを理解します。

Topics API の情報を表示する

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

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

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

[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 を選択します。5 つのトピックを提供できるほど（トピックを監視するサイトでの）閲覧履歴が十分でないため、残りの 3 つのトピックはランダムに選択されています。

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

ホスト名に推論されたトピックを表示する

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

[Classifier] パネルが選択された 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 日間です）。

[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 の説明またはチュートリアル動画をご覧ください。この Colab では古い分類バージョンを使用しています。

prebid.js を使用してウェブサイトで Topics API を使用する

Prebid 7 のリリースで説明したように、コミュニティは新しいモジュールを使用して Topics API との統合を積極的に開発しました。このモジュールは 2022 年 12 月に統合されました。Prebid の Topics API モジュールのドキュメントをお読みください。統合について詳しくは、Prebid.js が提供する標準チャネルを通じてお問い合わせください。