パブリッシャーのページで広告オークションを設定する

Protected Audience API オークションの構成方法について説明します。

販売者が実施するデバイス上のオークション

オンデバイスの Protected Audience オークションは、広告スペースを販売するサイトで実施されるため、 オークションを行っている当事者を販売者と呼びます。多くの関係者が 販売者: サイトで独自の広告オークションを実施する場合と、第三者の スクリプトを使用してオークションを実施するか、SSP と 他のサーバーサイドの広告オークション アクティビティと競合する。営業担当者は デバイス上の広告オークションには 3 つの 基本的なジョブがあります

  1. 販売者が（a）入札に参加する購入者と（b）入札する購入者を決定する そうした購入者からのオークションに参加できる。これにより、 販売者は、サイトに掲載されることが許可される広告について、 できます。
  2. オークションのビジネス ロジック（JavaScript）については、販売者が責任を負います。 各入札の価格とメタデータを考慮して、 「望ましい」スコアです。望み性スコアが最も高い入札が落札 決定します
  3. 販売者はオークション結果について、 清算価格やその他の支払いが含まれます勝ち負けた購入者も 独自のレポートを作成できます

このドキュメントでは、デバイス上のオークションを設定して開始する方法について説明します。

Protected Audience API の広告オークションを設定する

Protected Audience API の広告オークションを実施するには、まず オークションを設定しますそのために auctionConfig オブジェクトを作成します。 そうした構成の例を次に示します。

const auctionConfig = {
  seller: 'https://seller.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://buyer-1.example', 'https://buyer-2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://buyer-1.example': {...},
    'https://buyer-2.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://buyer-1.example': 50,
    'https://buyer-2.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://component-seller.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ],
  resolveToConfig: [true|false],
};

AuctionConfig 件の宿泊施設

必須プロパティ

auctionConfigs の必須プロパティは seller のみです。 decisionLogicUrl、interestGroupBuyers。

プロパティ 例 ロール
seller https://seller.example 販売者の出所。
decisionLogicUrl https://seller.example/decision-logic.js オークションの JavaScript 判断ロジック ワークレットの URL。このフィールドには、販売者フィールドと同じオリジンを指定する必要があります。
interestGroupBuyers [https://buyer-1.example,
] https://buyer-2.example,
...]		 オークションへの入札をリクエストしたすべてのインタレスト グループの所有者の地域

省略可能なプロパティ

auctionConfigs の残りのプロパティは省略可能です。

プロパティ 例 ロール
trustedScoringSignalsUrl https://seller.example/scoring-signals 販売者の Key-Value サーバーの URL。この情報は、広告のスコアリング プロセス中に、クリエイティブのレンダリング URL をキーとして使用してクエリされます。このフィールドには、販売者フィールドと同じオリジンを指定する必要があります。
auctionSignals {"category":"news"} オークションに参加するすべての購入者と販売者が利用できるシグナルを表す、シリアル化可能な JSON オブジェクト。
sellerSignals {...} 販売者のみが使用できるシグナルを表す、シリアル化可能な JSON オブジェクト。
perBuyerSignals {https://dsp.example: {...},
https://another-buyer.example: {...},
... }		 特定の購入者が利用できるシグナル。販売者や購入者自身からシグナルを受け取ることもできます。
perBuyerTimeouts {https://www.example-dsp.com: 50,
https://www.another-buyer.com: 200,
*: 150、
...} 様		 特定の購入者の generateBid() スクリプトの最大実行時間（ミリ秒）。ワイルドカード記号は、タイムアウトが定義されていないすべての購入者に適用されます。
sellerTimeout 100 販売者の ScoreAd() スクリプトの最大実行時間（ミリ秒）。
componentAuctions [{seller: https://www.some-other-ssp.com, decisionLogicUrl: ..., ...}, ...] コンポーネント オークションの追加設定
resolveToConfig 真|偽 runAdAuction() から返される Promise を、true の場合は FencedFrameConfig（<fencedframe> で使用する場合）に、false の場合は不透明な urn:uuid URL（<iframe> で使用する場合）に解決するよう指示するブール値。デフォルトは false です。

非同期でシグナルを提供する

一部のシグナルの値（auctionSignals、 sellerSignals、perBuyerSignals、perBuyerTimeouts フィールド）は、 具体的な値としてではなく、Promise として指定することもできます。これにより、 オークションの一部（スクリプトや信頼できるシグナルの読み込みなど） 独立したワークレット プロセスを起動して、コンピューティング（またはネットワーク 取得できます。ワークレット スクリプトは、解決された 値。いずれかの Promise が拒否された場合、その Promise が拒否されない限りオークションは中止されます 他の方法で中断される場合もあります。

複数の販売者によるオークションを設定する

複数の販売者が 1 つのオークションに入札し、 複数の落札者が別のオークションに回されること あります。見送られるこうした個別のオークションは、コンポーネント オークションと呼ばれます。 これらのコンポーネントのオークションを促進するために、componentAuctions オブジェクトに以下を含めることができます。 販売者のコンポーネント オークションごとに追加のオークション設定を適用できます。「 各オークションの落札単価が 「トップレベル」オークションの最終決定を行います「 コンポーネントの auctionConfig に、独自のオークションがない可能性がある componentAuctions。componentAuctions が空でない場合、次の処理が行われます。 interestGroupBuyers は空にする必要があります。つまり、特定の Protected 向け オーディエンス オークション。販売者が単独で行うもので、要素のないオークション。 それ以外の場合は、すべての入札がコンポーネント オークションにかけられ、トップレベルのオークションのみが オークションの 3 つの選択肢から受賞作品です

オークションの実施

販売者はユーザーのブラウザに、 navigator.runAdAuction() を呼び出しています。

try {
  const auctionResultPromise = navigator.runAdAuction(auctionConfig);
} catch (error) {
  // Handle error.
}

runAdAuction() 呼び出しは、広告に解決される Promise を返します。そうではない 落札した広告を調査する、または それ以外の場合は、runAdAuction() の結果からその内容が学習されます。もし AuctionConfig で resolveToConfig フラグが true に設定されていたため、 FencedFrameConfig オブジェクトが返されます。これは、フェンス内でのみレンダリングできます。 クリックします。フラグが false に設定されている場合は、不透明な URN が返されます。これは、 表示されます。runAdAuction が null 値を返す可能性、 広告が選択されていないことを示しますこの場合 コンテンツ ターゲット広告が表示される。