Chrome で利用可能な Topics API 情報を表示するツールと、トピックの割り当て方法について学びます。
Topics API の情報を表示する
chrome://topics-internals ページは、Topics API を有効にすると、パソコン版 Chrome で利用できるようになります。現在のユーザーのトピック、ホスト名から推測されたトピック、API 実装に関する技術情報が表示されます。デベロッパーからのフィードバックに基づいて、ページのデザインを改善しています。Topics API の開発にご協力いただくには、Chromium のバグとしてフィードバックを送信してください。
ブラウザで検出されたトピックを表示する
ユーザーは chrome://topics-internals を表示することで、現在のエポックと前のエポックでブラウザで検出されたトピックに関する情報を確認できます。
![[トピックの状態] パネルが選択された chrome://topics-internals ページ。](https://privacysandbox.google.com/static/private-advertising/topics/web/tooling/the-chrometopics-inter-0a0a54332c409.png?authuser=19&hl=ja)
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 の分類モデルによって推論されたトピックを確認することもできます。
![[分類システム] パネルが選択された chrome://topics-internals ページ。](https://privacysandbox.google.com/static/private-advertising/topics/web/tooling/the-chrometopics-inter-680196727dbe8.png?authuser=19&hl=ja)
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 ページ。](https://privacysandbox.google.com/static/private-advertising/topics/web/tooling/chrometopics-internals-a56a143c41aa1.png?authuser=19&hl=ja)
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 が提供する標準チャネルを通じてお問い合わせください。
次のステップ
関連情報
ウェブ上の Topics API について理解を深めるには、Google のリソースをご覧ください。
- トピックのデモ、コラボレーション、チュートリアル動画をご覧ください。
- デベロッパーが Topics API をテスト用にカスタマイズできる Chrome フラグのリストをご覧ください。
- ユーザーとデベロッパーが API を制御する方法を確認する。
- 技術的な解説とサポートについては、リソースをご確認ください。質問したり、フィードバックを提供したり、交流したりできます。