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

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

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

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

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

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

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 値を返す可能性、広告が選択されていないことを示しますこの場合コンテンツターゲット広告が表示される。