Topics API を使用してウェブ アプリケーションを使用、テスト、開発するための環境を準備します。
ローカルでのビルドとテスト
このセクションでは、個々のデベロッパーとして Topics API を試すためのローカル環境を設定する方法について説明します。実装の詳細に入る前に、デモで Topics の仕組みを理解することをおすすめします。
ブラウザで Topics を有効にする
ローカルテストのために独自の Chrome インスタンスで Topics API を有効にするには、次の 2 つの方法があります。
chrome://settings/adPrivacyで、すべての広告プライバシー API を有効にします。- （推奨）Topics API 固有のパラメータを使用して、必要に応じて構成し、Chromium フラグを使用してコマンドラインから Chrome を実行します。コマンドラインから Chrome を実行すると、トピック機能をより細かく制御できます。たとえば、Topics エポック（API がユーザーの興味 / 関心を計算するために使用する期間）を設定し、ニーズに応じて API の動作を設定できます。
主な推奨事項
- フラグを使用して新しいプロセスを開始する前に、Chrome プロセスをすべて閉じて停止してください。
chrome://settings/adPrivacyで、すべての広告プライバシー API が有効になっていることを確認します。- API が想定どおりに機能しない場合は、トラブルシューティングのヒントをお試しください。
- ご不明な点がございましたら、GitHub の問題の説明をご覧ください。
Chrome フラグを使用して Topics API を制御する
Chrome フラグで Topics API の動作を変更できます。簡単にテストできるように、指定したパラメータを使用してコマンドラインから Chrome を実行します。たとえば、ヘッダーのデモでは、次のフラグを使用することをおすすめします。
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
次の表に、各パラメータ、デフォルト値、目的を示します。
| フラグ名 | デフォルト値 | 説明 |
|---|---|---|
BrowsingTopics |
有効 | Topics API が有効かどうか。 |
PrivacySandboxAdsAPIsOverride |
有効 | 広告 API（Attribution Reporting、Protected Audience、Topics、Fenced Frames）を有効にします。 |
PrivacySandboxSettings4 |
無効 | プライバシー サンドボックス UI 設定の第 4 リリースを有効にします。 |
OverridePrivacySandboxSettingsLocalTesting |
有効 | 有効にすると、ブラウザで基本的な設定を有効にしなくても、プライバシー サンドボックス機能を有効にすることができます。 |
BrowsingTopicsBypassIPIsPubliclyRoutableCheck |
無効 | 有効にすると、ページがトピックの計算対象となるかどうかを判断する際に、IP アドレスが公開ルーティング可能かどうかの確認が省略されます。 |
BrowsingTopics:number_of_epochs_to_expose |
3 | リクエスト元のコンテキストに渡すトピックを計算するエポックの数。ブラウザは内部で最大 N+1 エポックを保持します。 |
BrowsingTopics:time_period_per_epoch |
7d-0h-0m-0s | 各エポックの期間。デバッグの場合は、デフォルトの 7 日間ではなく、たとえば 15 秒に設定すると便利です。 |
BrowsingTopics:number_of_top_topics_per_epoch |
5 | エポックごとに計算されたトピックの数。 |
BrowsingTopics:use_random_topic_probability_percent |
5 | エポック内の個々のトピックが、トピックの分類全体からランダムに返される確率。ランダム性はエポックとサイトに縛られます。 |
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering |
3 | 呼び出しコンテキストのトピックをフィルタするために使用される API 使用状況データ（トピックのモニタリング）のエポック数。 |
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic |
1000 | 上位のトピックごとに保持する、監視対象のコンテキスト ドメインの最大数。その目的は、使用中のメモリの上限を設定することです。 |
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch |
100000 | API 使用コンテキストのクエリごとにデータベースから取得できるエントリの最大数。このクエリは、トピックの計算時にエポックごとに 1 回実行されます。ピークメモリ使用量を制限することを目的としています。 |
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load |
30 | ページ読み込みごとに保存できる API 使用コンテキスト ドメインの最大数。 |
BrowsingTopics:config_version |
1 | Topics API 設定パラメータをエンコードします。各バージョン番号は 1 つの構成セットにのみマッピングする必要があります。通常、config_version を更新せずに構成パラメータを更新してもローカルテストでは問題ありませんが、状況によっては、ブラウザが不整合な状態になり、ブラウザがクラッシュする可能性があります（number_of_top_topics_per_epoch の更新など）。 |
BrowsingTopics:taxonomy_version |
1 | API で使用される分類のバージョン。 |
実装を始める前に
実装を開始する前に、以下のリソースを確認して Topics API をよく理解しておくことをおすすめします。
- デベロッパー向けドキュメントを確認する:
<ph type="x-smartling-placeholder">
- </ph>
- Topics API の目的と、インタレスト ベース広告におけるその役割を理解する
- ウェブでの Topics の仕組みを理解する。
- デモをお試しください。また、Topics のデモ、Colab、ツールのチュートリアル動画もご覧いただけます。
- デモをフォークして自分のサイトから実行する。
- 詳しくは、API の説明をご覧ください。
- 将来的にはサードパーティ Cookie を利用できなくなるユーザーの割合が高まっているため、広告の関連性の維持における API の役割を理解する。
- この API のステータス変更について通知を受け取るには、デベロッパー向けのメーリング リストにご参加ください。最新の Topics のアップデートにもご注目ください。
- GitHub の問題や W3C の呼び出しで会話に参加する。
- よくわからない用語については、プライバシー サンドボックスの用語集をご覧ください。
- Chrome フラグなどの Chrome のコンセプトについて詳しくは、goo.gle/cc で公開されているショート動画と記事をご確認ください。
<ph type="x-smartling-placeholder"></ph> 次のステップ
Topics を実装する
呼び出し元がトピックをオブザーバブルにしてアクセスするための実装の詳細とコードサンプルを確認します。
<ph type="x-smartling-placeholder"></ph> テストとライブ配信を開始
Topics ベースのソリューションをデプロイ、テスト、スケーリングする方法を学びます。