トピックベース ソリューションのテスト、デプロイ、スケーリング

このページでは、Topics API を使用して、本番環境向けの実装をビルド、テスト、スケーリングする方法について説明します。

Topics バックエンドの実装

バックエンドの実装は、ブラウザで計算されたトピックをどのように使用するかによって異なります。広告テクノロジー ソリューションでは、Topics を追加の IBA シグナルとして使用することをおすすめします。

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Topics を追加のシグナルとして使用する

トピック データは、URL、キーワード、その他のメタデータなどの他のシグナルとともに、オーディエンスに関する追加のシグナルとして考慮されます。

サードパーティ Cookie のない環境で広告の関連性を最大限に高めるで説明したように、Topics を活用して関連性の高い広告を配信する方法は複数あります。その中には、トピックを使用してオーディエンスを構築する方法や、トピックを他のシグナルの一つとして使用し、オーディエンスの追加の興味 / 関心を推測したり、入札ロジックを最適化したりするために使用される機械学習モデルをトレーニングする方法などがあります。

ビルドとデプロイ

  1. 本番環境でユーザーを観察してトピックを収集します（実装にかかる時間の目安: 約 1 週間）。
    • オプションを理解する: HTTP ヘッダーまたは iframe と JavaScript を使用してトピックを呼び出す方法。
    • Topics API を呼び出す iframe のドメインを定義します。
    • ヘッダーのデモまたは JavaScript のデモをコード参照として使用して、ソリューションを構築します。
    • サイト運営者がサイトに埋め込むコード（広告 iframe など）に Topics を統合します。埋め込みからトピックを呼び出すようにしてください。
    • ユーザーのトピックの観測を開始するには、本番環境のウェブサイトに最新バージョンのスクリプトを埋め込みます。まずは、月間訪問者数が少ない自社サイトで実装をテストすることをおすすめします。この段階では、新しいトピックベースのソリューションを少なくとも 5 つのサイトに埋め込むことをおすすめします。
    • この時点で、API は結果として空の配列を返すことが想定されます。これは、ユーザーのトピックがまだ観測されていないためです。ユーザー トピックの取得を開始するまでに、最長で 3 週間かかることがあります。
    • 機能テストと検証を実施します。ソリューションは手動または自動でテストできます。たとえば、次のような情報が得られます。
      • フラグ付きのブラウザを開き、エポックを 15 秒に設定して、ブラウザがトピックをより早く再計算するようにします。
      • スクリプトを埋め込んでいるサイトにアクセスします。
      • chrome://topics-internals/ でスクリプトによってトピックが監視されているかどうかを確認します。
      • 期待できる結果をご確認ください。
  2. Topics データと他のコンテキスト シグナル（URL、メタデータなど）を組み合わせて使用する（推定所要時間: 約 3 日）。
    • 本番環境で 3 週間経過すると、スクリプトは一部のユーザーのトピックを観測しているはずです。この時点で、トピック データを追加のシグナルとして使用できるようになります。
    • トピックの空でないリストを受け取り始めたら、他のコンテキスト シグナルとともにバックエンドに送信できます。

ターゲット サイトにデプロイする

トピック呼び出しをスクリプトに統合したら、最初のテストとして、いくつかの本番環境サイトに埋め込まれていることを確認します。実装が想定どおりに動作することを確認します。

  • Topics API が呼び出されます。
  • この制御された環境では、トピックをモニタリングできます。
  • トピックにアクセスできます（API はユーザーが確認したトピックを返します）。

ターゲット サイトを選択する

パブリッシャーのサイトにソリューションをデプロイする前に、管理された環境で、所有しているウェブサイトでテストすることをおすすめします。次のようにターゲット ウェブサイトを選択することをおすすめします。

  • サイトの月間訪問者数が少ない（約 100 万人未満）: まず、少数のユーザーに API をデプロイすることから始めます。
  • サイトの所有者であり、サイトを管理している: 必要に応じて、複雑な承認なしで実装をすばやく無効にできます。
  • サイトがビジネス クリティカルではない: リスクの低いターゲット サイトから始めます。
  • 合計 5 つ以下のサイト: 現時点では、それほど多くのトラフィックや露出は必要ありません。
  • ターゲット サイトがさまざまなテーマを表している: さまざまなカテゴリを表すウェブサイトを選択します（例: スポーツに関するサイト、ニュースに関するサイト、食べ物や飲み物に関するサイトなど）。Chrome の内部トピックツールを使用すると、ドメインと、トピックの機械学習分類子によるドメインの分類方法を検証できます。

機能をテストして確認する

この制限付き環境で Topics API を呼び出すと、次の結果が返されます。

  • このデバイスから、このサイトと呼び出し元に対して過去 7 日間に初めて呼び出しが行われた場合は、トピックの空の配列 []。

  • このユーザーの興味を表す 0 ～ 3 個のトピックのリスト。7 日間の観察期間の後、次のものが届きます。

    • 1 つのトピック。その週に呼び出し元がトピックを検出したページのホスト名から計算された、ユーザーの上位 5 つのトピックから選択されます。

  • これまでの Topics API 呼び出しとまったく同じ API レスポンス。同じ呼び出し元、ユーザー、トップレベル サイトの場合、API はエポック全体で同じトピックを返します。これにより、ユーザーの興味が過度に公開されるのを防ぐことができます。GitHub で詳細を確認してください。

  • モニタリング期間が 4 週間経過した後に Topics を呼び出した場合、3 つの古いトピックのいずれかが新しいトピックに置き換えられます。

  • 過去 3 週間以上、ユーザーのトピックを観察していない場合、Topics API は再び空の配列 [] を返します。

パフォーマンス指標を収集して、ユーザー エクスペリエンスを評価します。

  • クロスオリジン iframe 内の Topics API への JavaScript 呼び出しの実行時間を測定し、今後のパフォーマンス分析で使用できるようにする必要があります。
  • トピックを受信してから、iframe と postMessage() トピックを作成するまでの時間。

トラブルシューティングについては、 サポート セクションを参照してください。

本番環境にスケーリングする

この時点で、管理された環境（所有している一部のサイト）でトピックをテストしているはずです。すべてが想定どおりに動作したら、この実装をスケーリングします。同じコードを複数のターゲット ウェブサイトにデプロイします。これにより、より多くのユーザーを観察し、より多くのトピックデータを収集して、オーディエンスの理解を深めることができます。

本番環境にスケーリングする手順の概要は次のとおりです。

  1. トピック ベースのソリューションをより多くのトラフィックでテストします。
    • 所有するサイトのうち、アクセス数の多いサイトに iframe を追加し、以下の手順に沿って負荷テストを実施します。
  2. パブリッシャーのサイトにソリューションをデプロイします。
    • ソリューションが独自のテスト環境で正しく動作したら、パブリッシャーと協力して iframe をパブリッシャーのウェブサイトに統合します。たとえば、iframe を含むライブラリの更新が必要になる場合があります。
  3. トピック データを処理して使用します（推定所要時間: 約 4 週間）。
    • トピックデータを他のデータとともに加法的なシグナルとして組み込む。
    • リアルタイム ビッダー テスト パートナーのソース。
    • トピックを他のデータに追加のシグナルとして使用して、ユーティリティ テストを実施します。

負荷テスト

システムがトラフィックを処理できるように、トピック ベースのソリューションをパブリッシャーのサイトにデプロイする前に、負荷テストを実施することをおすすめします。

  1. 所有するターゲット サイト（特にトラフィック量の多いサイト）に段階的にデプロイします。
  2. 予想されるトラフィックに応じて、トピックデータのロードテストを実施します。
    • iframe から バックエンドにトピック情報を送信する必要があります。これにより、Topics API の結果をさらに処理し、ユーザーに関連性の高い広告を選択するための追加シグナルとして使用できます。埋め込みを組み込むサイトが増えるにつれて、バックエンドへの呼び出しの数が大幅に増加します。バックエンドで iframe からの大量の呼び出しを処理できることを確認します。
    • 分析用の指標とログの収集を設定します。
  3. Topics API をデプロイしたらすぐに、指標をチェックしてエンドユーザーに重大な問題が発生していないか確認します。指標を定期的に確認してください。
  4. 中断や予期しない動作が発生した場合は、デプロイをロールバックし、ログを分析して問題を把握し、修正します。

関連情報

ウェブ上の Topics API について理解を深めるには、Google のリソースをご覧ください。