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
の残りのプロパティは省略可能です。
非同期でシグナルを提供する
一部のシグナルの値(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 値を返す可能性、
広告が選択されていないことを示しますこの場合
コンテンツ ターゲット広告が表示される。