このページは Cloud Translation API によって翻訳されました。

SSP 向け Protected Audience（旧称 FLEDGE）統合およびテストガイド

Chrome はプライバシーサンドボックスの一環として、 Protected Audience API: ブラウザ内 API 広告主や広告テクノロジー企業がインタレストグループを選択してターゲットに設定できるユーザーを保護しながら、サードパーティ Cookie に依存しない（オーディエンスリスト）防ぐことができます開発者ガイド

SSP は、ディスプレイ &ビデオ 360 で Protected Audience API をテストできる動画 360 と Google 広告で以下を実現:

Protected Audience API フローの有効性について学習していきます。
API の潜在的な改善点を提案してフィードバックを生成するフォーラム（GitHub など）から入手できます。
Protected Audience でパーソナライズド広告をサポートする準備をするサードパーティ Cookie に依存しない API を提供しています。

以下のガイドでは、SSP とディスプレイ &ビデオ 360 の統合に関する詳細について説明します。動画 360 と Google 広告テストの調整に関心のある SSP はディスプレイ &ビデオ 360 でVideo 360 パートナーシップの担当者

登録

SSP はアクセスできるようにする Protected Audience API を使用する

サービングフローの概要

次の図は、Chrome、SSP、ディスプレイ、動画 360 と Google 広告

Chrome、SSP、および
DSP

統合オプション

オプション 1: 直接 / 単一販売者

単一販売者向けの詳細なリクエストフロー
オークション

手順:

SSP 広告タグが広告リクエストを SSP サーバーに送信し、ブラウザが Protected Audience API に対応しています。
SSP サーバーがコンテキストに基づく OpenRTB 入札リクエストを DSP に送信し、ブラウザが Protected Audience API に対応
DSP は、対象トラフィックのシグナルを含む OpenRTB 入札レスポンスを決定します
SSP サーバーが、オークション設定を含む広告レスポンスを SSP 広告タグに送信します。
SSP 広告タグが以下を呼び出して、デバイス上のオークションを開始します。 runAdAuction() DSP の openRTB 入札レスポンスからシグナルを perBuyerSignals。
Chrome が Key-Value の信頼できる DSP 入札サーバーを呼び出します。リアルタイムの入札シグナルを取得できます
Chrome が generateBid() を呼び出します。参加するインタレストグループごとの DSP JavaScript 関数。
Chrome が Key-Value の信頼できる SSP スコアリングサーバーを呼び出します。リアルタイムでスコアリングシグナルを取得できます。
Chrome が scoreAd() を呼び出します。参加するインタレストグループごとの SSP JavaScript 関数。
Chrome が reportWin() を呼び出します。落札者を DSP に報告する DSP JavaScript 関数。
Chrome が reportResult() を呼び出します。落札者を SSP に報告する SSP JavaScript 関数。

SSP 側での最小変更

SSP 広告タグを
- ブラウザが Protected Audience API に対応しているかどうかを検出する
- その情報を広告リクエストの一部として SSP サーバー [1] に送信します。
- runAdAuction() を呼び出して、デバイス上のオークションを開始します。 [5] の DSP の OpenRTB 入札レスポンス（入札リクエストとレスポンスの構造を以下に示します。
SSP サーバーに
- Protected Audience API のサポートに関する情報を DSP に伝達 OpenRTB 入札リクエスト [2] のフィールドで確認する（入札に関するセクションを参照リクエストとレスポンスの構造を以下に示します）。
- OpenRTB 入札レスポンスの DSP の購入者シグナルを SSP 広告に反映タグ（入札リクエスト / 入札レスポンスの構成については後述のセクションを参照）[4]
[Optional] SSP はリアルタイムデータを取得するために、信頼できる SSP サーバーを実装する必要があります広告の品質チェック、パブリッシャー設定の適用をサポートするスコアシグナル [8]
SSP は "scoreAd(...)" と "reportResult(...)" を使用して JavaScript を実装する必要があります関数 [9]、[11]

オプション 2: 複数販売者

複数の販売者によるオークションの詳細なリクエストフロー

手順:

SSP アダプタが広告リクエストを SSP サーバーに送信し、ブラウザが Protected Audience API に対応しています。
SSP サーバーがコンテキストに基づく OpenRTB 入札リクエストを DSP に送信し、 Protected Audience API と
DSP サーバーが、OpenRTB の入札レスポンスに次のシグナルを含むレスポンスを返す決定します
SSP サーバーが、オークション設定を含む広告レスポンスを SSP 広告タグに送信します。
SSP Prebid アダプタがコンポーネントオークション設定をパブリッシャー広告サーバーに提供できます。
パブリッシャー広告サーバータグが、パブリッシャー広告サーバーサーバーに広告リクエストを送信します。
パブリッシャーの広告サーバータグが runAdAuction(...) API
Chrome が Key-Value の信頼できる DSP 入札サーバーを呼び出します。リアルタイムの入札シグナルを取得できます
Chrome が generateBid() を呼び出します。参加するインタレストグループごとの DSP JavaScript 関数。
Chrome が Key-Value の信頼できる SSP スコアリングサーバーを呼び出します。リアルタイムでスコアリングシグナルを取得できます。
Chrome が scoreAd() を呼び出します。参加するインタレストグループごとの SSP JavaScript 関数。
Chrome が reportWin() を呼び出します。落札者を DSP に報告する DSP JavaScript 関数。
Chrome が reportResult() を呼び出します。落札者を SSP に報告する SSP JavaScript 関数。

SSP 側での最小変更

SSP アダプターを
- ブラウザが Protected Audience に対応しているかどうかを検出する
- その情報を広告リクエストの一部として SSP サーバー [1] に送信します。
- コンポーネントのオークション設定をパブリッシャー広告サーバーの広告タグ [5] に提供。
- Google アドマネージャーがパブリッシャーの広告サーバーの場合、SSP は次のいずれかを行う: * prebid Protected Audience を使用モジュール * Google アドマネージャー広告タグ setConfig() を呼び出す API （複数可）販売者
SSP サーバーに
- Protected Audience のサポートに関する情報を OpenRTB 入札リクエスト [2] のフィールド（入札に関するセクションをご覧くださいリクエストとレスポンスの構造を以下に示します）。
- OpenRTB 入札レスポンスの DSP の購入者シグナルを SSP 広告に反映タグ（入札リクエスト / 入札レスポンスの構成については後述のセクションを参照）[4]
[Optional] SSP はリアルタイムデータを取得するために、信頼できる SSP サーバーを実装する必要があります広告の品質チェック、パブリッシャー設定の適用をサポートするスコアシグナル [10]
SSP では、scoreAd() と reportResult() を使用して JavaScript を公開する必要があります。関数 [11]、[14]。

入札およびオークションサービス

Google は、入札とキャンペーンの評価をオークションサービス（B&A） proposal。

ディスプレイと動画 360 で Protected Audience API を B&A でテストする準備が整いました。追って詳細をお知らせいたします。

OpenRTB プロトコル

入札リクエスト

Protected でサポートされているインプレッションの機会を区別する Audience API のオンデバイスオークション（標準版のみをサポートしているもの）サーバーサイドエクスチェンジオークションに「オークション」の ae という新しい列挙型フィールドを追加できます。OpenRTB の Imp オブジェクトに拡張機能として追加する必要があります。対応するオークション環境を指定する同じですae 列挙型には次の値を指定できます。

0: 標準のサーバーサイドオークション
1: Protected Audience API をサポートするリクエスト。コンテキストエクスチェンジのサーバーとインタレストグループ入札オークションによって最後のオークションは

{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

入札レスポンス

コンテンツターゲットの入札に加えて、入札レスポンスもディスプレイとネットワークに関するビデオ 360 と Google 広告の Protected Audience API インタレストグループオークション。入札レスポンスが次のようにインタレストグループオークションをサポートします

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

サポートされるシナリオは次のとおりです。

シナリオ 1: ディスプレイと動画 360 と Google 広告が入札のみを希望する場合自動的に配信されますこのシナリオでは、igbid フィールドはありません。
シナリオ 2: ディスプレイと動画 360 と Google 広告が入札のみを希望する場合 1 つのオークションに入札できますディスプレイとビデオ 360 と Google 広告は、入札レスポンスでシート入札フィールドを削除し、 igbid 情報を返します。つまり、igbid フィールドがある場合は、ディスプレイ &ビデオ 360 では動画 360 と Google 広告がインタレストグループを必要としているオークションに参加することもできます
シナリオ 3: ディスプレイとGoogle 広告で動画 360 を使用し、比較できます。ディスプレイと動画 360 と Google 広告では、入札レスポンスで両方の Sheetsbid フィールドが返されます。 igbid 情報が含まれています。

広告の入札単価のメタデータ

Protected Audience API により、passing arbitrary metadata generateBid() 関数から広告に関する情報を取得します。

ディスプレイとビデオ 360 では、以下が計画されています。 specification Protected Audience API と OpenRTB。

Namely ディスプレイ広告と動画 360 は広告の一部として次のフィールドを返しますオブジェクト:

PA 属性	タイプ	OpenRTB の説明
ad.seat	String;必須	代理としてこの入札が行われた購入者シート（広告主、代理店など）の ID。
ad.adomain	String[]	ブロックリストのチェックに使用する広告主様のドメイン（例:「ford.com」）を入力します。クリエイティブをローテーション表示する場合は、の配列になります。エクスチェンジは 1 つのドメインのみを許可することを義務付けることができます。
ad.cid	文字列	広告の品質チェックに役立つキャンペーン ID。
ad.crid	文字列	広告の品質チェックに役立つクリエイティブ ID。
ad.language	文字列	ISO-639-1-alpha-2 形式のクリエイティブの言語です。非標準コード「xx」また、広告に言語に関するコンテンツ（企業のロゴのみのバナーなど）がない場合にも使用できます。language または langb は、いずれか 1 つのみを指定してください。
ad.w	integer	クリエイティブの幅（デバイス独立ピクセル（DIPS）単位）。
ad.h	integer	デバイス独立ピクセル（DIPS）でのクリエイティブの高さ。

例

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

イベントレポート

Protected Audience API は、こちらの GitHub の投稿: Fenced Frame Ads Reporting 名前には「Fenced Frame Ads Reporting」とありますが、この API はフェンス付きフレームと iframe の両方（詳しくは here）。

SSP では、 registerAdBeacon() を呼び出し中 API

ディスプレイとビデオ 360 から reportEvent() が呼び出されます宛先が「component-seller」である APIそのクリエイティブ内からクリックイベントなどがありますこれにより、対象の宛先にビーコンができます。

ディスプレイとVideo 360 はインプレッションと課金のために reportEvent() API を呼び出します。空の投稿データによるクリック。

例

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

Cookie 非推奨のテストラベル

ディスプレイとビデオ 360 は次の動画の Chrome-facilitated testing に参加しますサポートしていますテストを実施するには、次のように OpenRTB 入札リクエストで Chrome のラベルを渡します。 specification:

オブジェクト: Device.ext

属性	型	説明
CDP	文字列	Chrome またはアップストリームパートナーから受け取ったラベル。

SSP 向け Protected Audience（旧称 FLEDGE）統合およびテストガイド コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

登録

サービング フローの概要

統合オプション

オプション 1: 直接 / 単一販売者

SSP 側での最小変更

オプション 2: 複数販売者

SSP 側での最小変更

入札およびオークション サービス

OpenRTB プロトコル

入札リクエスト

入札レスポンス

広告の入札単価のメタデータ

イベント レポート

Cookie 非推奨のテストラベル

関連ドキュメント

SSP 向け Protected Audience（旧称 FLEDGE）統合およびテストガイド

サービングフローの概要

入札およびオークションサービス

イベントレポート