Topics API for Web

Topics API を使用すると、サードパーティ Cookie を使用せずにインタレスト ベースの広告を掲載できます。

Topics API の仕組み

Topics API を使用すると、ユーザーのアクティビティに基づいて、ユーザーの関心を持ちそうなトピックを検出してアクセスを提供できます。これにより、Topics API は、ユーザーのアクティビティに関する追加情報を開示することなく、API 呼び出し元（広告テクノロジー プラットフォームなど）にユーザーの関心トピックへのアクセスを許可できます。

主なコンセプト

  • トピックは、現在のユーザーの興味を示すもので、人が読める形式になっています。Topics 分類に含まれます。
  • 呼び出し元とは、ユーザーの関心を観察またはアクセスするために Topics API にリクエストを行うエンティティ（アプリ、サードパーティ SDK、ウェブサイト、サービスなど）です。
  • トピックは、呼び出し元が、3 エポックの間に、トピックに関連付けられたウェブページまたはアプリから Topics API リクエストを行った場合に参照されます。
  • エポックは、トピックの算出を行う期間です。デフォルトは 1 週間です。
  • 分類は、/Arts & Entertainment/Music & Audio/Soul & R&B や /Business & Industrial/Business Services/Corporate Events などのカテゴリを含む、カテゴリの階層リストです。
  • トピックは、ユーザー アクティビティを 0 個以上のトピックにマッピングする分類モデルを使用して導出されます。

Topics API フローのコアステップ

Topics API のライフサイクルには、主に次の 3 つのステップがあります。

  • ユーザー アクティビティ（ウェブページ https://cats.example/tabby/index.html へのアクセスやアプリ cats のダウンロードなど）をモニタリングします。
  • ユーザー アクティビティ（/Pets & Animals/Pets/Cats など）からトピックを導出します。
  • ユーザーが以前にアクセスしたトピック。関連性の高い広告（猫用フードのプロモーションなど）を選択するためのシグナルとして使用されます。

トピックをモニタリングする

呼び出し元は、確認済みの関心トピックにのみアクセスできます。呼び出し元がトピックを参照するのは、このトピックに関連付けられたコンテキストから Topics API リクエストを行った場合です。このコンセプトを説明するために、次の簡略化された例について考えてみましょう。

  • A と B という 2 つの Topics API 呼び出し元があるとします。
  • コンテキストは 2 つあります。
    • トピック Home & Garden に関連付けられた Greenhouse（Greenhouse という名前のアプリや greenhouse.example というウェブサイトなど）。
    • テニス エクササイズ。たとえば、トピック Sports/Tennis に関連付けられた、Tennis Exercises という名前のアプリや tennis.example というウェブサイトなど。
  • 呼び出し元の A と B の両方が Greenhouse のコンテキストに存在します。
  • テニス エクササイズのコンテキストには、呼び出し元の B のみが存在します。
  • わかりやすくするため、エポック 1 より前にユーザーのトピックが観測されていないとします。
  • ユーザーが Greenhouse アプリにアクセスし、呼び出し元 A と B が Topics API を呼び出して、ページまたはアプリへのユーザーのアクセスを記録します（Topics API の呼び出し方法については、次のステップで推奨されている実装ガイドをご覧ください）。このレコード（ホスト名またはアプリデータ）は、後で興味のあるトピックを導き出すために使用されます。Topics API は、トピック Home & Garden を呼び出し元 A と B の両方によって検出されたトピックとしてマークします。
  • ユーザーが テニス エクササイズ アプリにアクセスします。呼び出し元 B のみが Topics API リクエストを送信します。Topics API は、トピック Sports/Tennis を呼び出し元 B によって確認済みとしてマークします。
  • エポックの終わりまでに、Topics API はユーザーの上位トピックを更新し、ユーザーのアクティビティに基づいてこれらのトピックを観察した呼び出し元を決定します。
  • 後で、呼び出し元 B が Topics API を再度呼び出すと、このユーザーの Home & Garden トピックまたは Sports/Tennis トピック（または 5% の確率でランダムなトピック）がレスポンス配列で取得されます。
  • 呼び出し元 A はトピック Sports/Tennis を検出したことがないため、トピック Home & Garden にのみアクセスできます。つまり、サードパーティは、ユーザーの関心のあるトピックを、そのトピックが存在する特定のコンテキスト（アプリまたはウェブサイト）内でのみ知ることができます。
Topics API は、呼び出し元がコンテキスト内に存在する場合にのみ、トピックを「確認済み」としてマークすることを示す図。
Topics API は、これらのトピックのコンテキストに存在する呼び出し元によってのみ検出されたトピックをマークします。呼び出し元は、確認済みのトピックにのみアクセスできます。

トピックを導出する

Topics は、ユーザー アクティビティから関心のあるトピックを導き出します。トピックは事前に定義されたオープンソースの分類から選択されます。Topics は、エポックごとに 1 回、ユーザーの上位 5 つのトピックと、エポック中にそれらを観測した呼び出し元を更新します。Topics 分類モデルは、ユーザー アクティビティ（ウェブページのアクセスのホスト名、Android のアプリ情報）からトピックを導出します。

呼び出し元がユーザーの関心のあるトピックにアクセスする

API は、直近の 3 エポック内に呼び出し元によってすでに確認されているトピックのみを返します。呼び出し元には最大 3 つのトピックが返されます。最近の 3 つのエポックごとに 1 つのトピックが返されます（呼び出し元がそのエポックのトピックを観測した場合）。返されたトピックは、呼び出し元がコンテキスト情報を補完するために使用できます。また、組み合わせて使用することで、ユーザーに関連性の高い広告を見つけることができます。

エポック

Topics API では、関心のあるトピックが最新の状態に保たれている必要があります。トピックは、エポックと呼ばれる期間（デフォルトでは 1 週間）のアクティビティに基づいてユーザーに対して推測されます。各ユーザーには独自のエポックがあり（エポックは「ユーザーごと」です）、最初の開始時間はランダムに設定されます。

Topics API はエポックごとに 1 回、ユーザーの上位 5 つのトピックを計算し、デバイス上の情報を基に、それらのトピックを検出した呼び出し元を特定します。エポックごとに選ばれるトピックは、その期間にユーザーが最も関心を持っている 5 つのトピックからランダムに抽出したものとなります。プライバシーを強化し、すべてのトピックが使用されるように、20 回に 1 回は興味 / 関心の分類に含まれる可能性があるすべてのトピックから無作為に選ばれます。

ウェブに関するトピックの実践

ウェブでは、ユーザーがアクセスしたページのホスト名からトピックが推測されます。たとえば、ウェブサイト dogs.example から推定されるトピックは /ペット、動物/ペット/犬 などです。

次の図は、Topics API が広告テクノロジー プラットフォームの適切な広告選択にどのように役立つかをわかりやすく示したものです。この例では、ウェブサイトのホスト名をトピックにマッピングするモデルがユーザーのブラウザに組み込み済みであることを前提としています。

ユーザーがウェブサイトにアクセスしてから広告が表示されるまでの、Topics API ライフサイクルの各ステージを示す図。
Topics API のライフサイクル図は、API アクションの各ステージを概要として示しています。

ブラウザは、Topics API を呼び出すコードのコンテキストから呼び出し元のオリジンを判断します。実際には、Topics ユーザーがオリジンから iframe 内の API を呼び出すか、オリジンへのフェッチにトピックを含めます。

たとえば、サプライサイド プラットフォーム（SSP）は複数のパブリッシャーのサイトに埋め込むことができます。SSP は、オリジンから iframe 内の Topics API を呼び出して、パブリッシャーのサイトでユーザーに関連付けられたトピックを検出できます。これらのトピックは、デマンドサイド プラットフォーム（DSP）と共有して、ユーザーに関連性の高い広告を選択できるようにできます。

API がどの呼び出し元にどのトピックを表示するかを決定する仕組み

API 呼び出し元は最近確認したトピックのみを受け取り、ユーザーのトピックはエポックごとに 1 回更新されます。エポックとは、Chrome の実装では 1 週間に設定されている一定期間です。つまり、Topics API には、特定の呼び出し元が確認済みのトピックを受け取ることができるローリング ウィンドウが存在します。

次の表は、1 つのエポックにおけるユーザーの仮想的なブラウジング履歴の例を示しています（ただし、現実的な規模ではありません）。訪問したサイトに関連付けられたトピックと、各サイトに存在する API 呼び出し元（サイトに含まれる JavaScript コードで document.browsingTopics() を呼び出すエンティティ）を示しています。

サイト トピック サイトの API 呼び出し元
running.example Running & Walking
Athletic Shoes		 adtech1.example
adtech2.example
dogs.example Dogs adtech1.example
holiday.example Hotels & Accommodations adtech2.example
sunglasses.example Sunglasses [なし]

エポック（デフォルトは 1 週間）の最後に、Topics API はその週について、ブラウザの上位のトピックを生成します。

  • adtech1.example は、Running & Walking、Athletic Shoes、Dogs のトピックを受け取ることができます（running.example と dogs.example で確認したため）。
  • adtech1.example は、このユーザーについて Hotels & Accommodations トピックを受け取ることができません（このトピックに関連する、ユーザーが最近アクセスしたどのサイトにも存在しないため）。
  • adtech2.example は Running & Walking、Athletic Shoes、Hotels & Accommodations のトピックを確認していますが、Dogs トピックは確認していません。

ユーザーは Sunglasses トピックがある sunglasses.example にアクセスしましたが、そのサイトに Topics API の呼び出しはありませんでした。つまりこの時点では、どの呼び出し元に対しても API が Sunglasses トピックを返すことはありません。

第 2 週に、ユーザーが別のサイトにアクセスします。

サイト トピック サイトの API 呼び出し元
cameras.example Camera & Photo Equipment adtech2.example

また、adtech2.example のコードが sunglasses.example に追加されます。

サイト トピック サイトの API 呼び出し元
sunglasses.example Sunglasses adtech2.example

第 1 週の Running & Walking、Athletic Shoes、Hotels & Accommodations と同様に、adtech2.example は後続のエポック（第 3 週）から Camera & Photo Equipment と Sunglasses のトピックを受け取れるようになります。これにより、第三者がユーザーの過去（この場合、ファッションに興味があること）について、Cookie を使用した場合よりも詳細に把握することはできなくなります。

さらに 2 週間後、Running & Walking、Athletic Shoes、Hotels & Accommodations は、adtech2.example のコードが含まれる、これらのトピックを持つサイトにユーザーがアクセスしなかった場合、adtech2.example の対象トピックのリストから外れる可能性があります。

ユーザーが API を使用するサイトにアクセスしたときに Topics API が行う処理の流れ。
API がトピックをモニタリングしてアクセスする方法。

分類モデル

Topics は、ウェブサイトのホスト名を 0 個以上のトピックにマッピングする分類モデルを使用します（完全な URL やページ コンテンツなどの追加情報を分析することで、広告の関連性が高まる可能性はありますが、プライバシーが損なわれるおそれもあります）。

分類

トピックは分類から選択されます。これらのトピックは、信頼できるエコシステムの協力者による分類の維持管理を目標に、Chrome によって選定されています。分類においては、各トピックにより多くのユーザーのブラウザが関連付けられるよう、トピック数を必要最小限にする必要があります。最終的な目標は、業界全体からのフィードバックやアイデアを組み込んだ外部パーティから分類を取得することです。

デリケートなカテゴリが含まれないよう、トピックは公開され、判読可能で、常に更新される必要があります。Chrome で使用される分類は、一般的にデリケートと考えられるカテゴリ（民族や性的指向など）を除外するように手動で選定されています。

トピックの分類

トピックは、上位 5 万サイトについて手動でキュレートされています。このキュレートされたホスト名とトピックのオーバーライド リストが、分類モデルのトレーニングに使用されます。上位サイトの場合、トピックには分類器モデルではなくオーバーライド リストからアクセスされます。オーバーライド リストをローカルのパソコンで確認できます。

[分類システム] パネルが選択された chrome://topics-internals ページ。
[chrome://topics-internals] ページの [分類システム] パネルには、モデルのバージョン、パス、リスト内の各ホストに関連付けられているトピックが表示されます。

Chrome の実装では、Topics API を使用してモデルを表す TensorFlow Lite ファイルをダウンロードし、ユーザーのデバイスでローカルに使用できるようにします。

ユーザーの上位 5 つのトピックが選ばれる仕組み

API はエポックごとにトピックを 1 つ返します（最大 3 つ）。3 つ返される場合は、現在のエポックのトピックと、前 2 つのエポックのトピックが返されます。

  1. 各エポックの最後に、ブラウザは次の基準を満たすページのリストをコンパイルします。
    • 対象エポック中にユーザーによってアクセスされたページ。
    • このページには、document.browsingTopics() を呼び出すコードが含まれています。
    • API が有効になっている（たとえばユーザーまたはレスポンス ヘッダーによってブロックされていない）。
  2. ユーザーのデバイスで、ブラウザは Topics API が提供する分類モデルを使用して、各ページのホスト名をトピックのリストにマッピングします。
    • 分類の 22 個のルートトピックはそれぞれ、広告エコシステムからのフィードバックに基づいて「高ユーティリティ」または「標準ユーティリティ」のバケットに割り当てられます。ブラウザはまず、トピックをバケットの割り当て順に並べ替えます。すべての子トピックは、親ルートトピックのバケット割り当てを継承します。「有用性が高い」トピックが優先されます。
    • 次に、ブラウザは各バケット内でトピックを頻度順に並べ替えます。
    • この並べ替えられたリストの上位 5 つのトピックが、そのエポックのユーザーの上位トピックとして選択されます。

document.browsingTopics() メソッドは、エポックごとに上位 5 つの中からランダムにトピックを返します（トピックの全分類からランダムに選ばれる確率は 5%）。Chrome では、ユーザーが個々のトピックを削除したり、閲覧履歴を消去したりすることで、API から返されるトピックの数を減らすこともできます。ユーザーは API をオプトアウトすることもできます。

現在のエポックで検出されたトピックに関する情報は、chrome://topics-internals ページで確認できます。

Next steps

Get your environment ready to test and develop web applications with the Topics API.
Check out implementation details and code samples for callers to observe and access topics.

See also

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