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

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

トピックのバックエンドの実装

バックエンドの実装は、ブラウザで計算されたトピックをどのように使用するかによって異なります。広告テクノロジー ソリューションでは、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 週間）。 <ph type="x-smartling-placeholder">
      </ph>
    • オプションについて理解する: HTTP ヘッダーまたは iframe と JavaScript を使用して Topics を呼び出す方法。
    • Topics API を呼び出す iframe のドメインを定義します。
    • ヘッダーのデモまたは JavaScript のデモをコード リファレンスとして使用して、ソリューションを構築します。
    • パブリッシャーがサイトに埋め込むコード（広告 iframe など）に Topics を統合します。埋め込みからトピックを呼び出してください。
    • ユーザー トピックのモニタリングを開始するには、最新バージョンのスクリプトを本番環境のウェブサイトに埋め込みます。まずは、毎月のアクセス数が少ないご自身のウェブサイトで実装をテストすることをおすすめします。この段階では、少なくとも 5 つのサイトに新しいトピックベースのソリューションを埋め込むことをおすすめします。
    • この時点では、API は結果として空の配列を返すことが想定されています。これは、ユーザーのトピックがまだ確認されていないためです。ユーザーのトピックを獲得できるようになるまでに、最長で 3 週間かかることがあります。
    • 機能テストと検証を実施する。ソリューションを手動または自動でテストできます。たとえば、次のような情報が得られます。
      • フラグを使用してブラウザを開き、エポックを 15 秒に設定して、ブラウザが Topics をより早く再計算するようにします。
      • スクリプトが埋め込まれているサイトにアクセスします。
      • chrome://topics-internals/ でスクリプトによってトピックが検出されているかどうかを確認します。
      • 期待できる結果を確認する。
  2. Topics データを他のコンテキスト シグナル（URL、メタデータなど）と組み合わせて使用します。（所要時間: 約 3 日）。
    • 本番環境で 3 週間経過すると、スクリプトは一部のユーザーのトピックを検出しているはずです。これで、Topics データを追加のシグナルとして使用できるようになります。
    • 空でないトピックのリストが届き始めたら、他のコンテキスト シグナルとともにバックエンドに送信できます。

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

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

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

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

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

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

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

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

  • トピックの空の配列 []（このデバイスからの最初の呼び出しの場合、このサイトと過去 7 日間の呼び出し元）。

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

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

  • これまでのすべての Topics API 呼び出しと同じ API レスポンスです。呼び出し元、ユーザー、トップレベル サイトが同じ場合、API はエポック全体を通して同じトピックを返します。これにより、ユーザーの関心事が多くなりすぎないようにすることができます。GitHub で詳細を確認する

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

  • 過去 3 週間以上、ユーザーのトピックを監視していない場合、Topics API から空の配列 [] が再び返されます。

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

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

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

本番環境へのスケーリング

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

本番環境にスケーリングする方法については、次の手順の概要をご覧ください。

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

負荷テスト

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

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

関連情報

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