このドキュメントでは、Google デマンド ジェネレーションと 現在のイテレーションで使用される、単一販売者の Protected Audience データ Protected Audience API です。1 人の販売者が参加するオークションでは 複数の販売者が関与する複雑なオークションの一部として実施されます。この 単一販売者オークションは「コンポーネント オークション」 広告候補を「トップレベルのオークション」に送ることができる複数の販売担当者が 参加しています。
Protected Audience API のライフサイクルについては、デベロッパー ガイドをご覧ください。 詳しくは、Protected Audience API の説明をご覧ください。 販売者によるオンデバイス オークションの実施方法に関するディスカッションです。
Protected Audience API 広告オークションの 6 つのステージ
<ph type="x-smartling-placeholder">![Protected Audience API 広告オークションの 6 つのステージ](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/six-stages-a-protected-a-3e1dd6fdeddbe.png?authuser=0000&hl=ja)
- 広告が表示されたサイトにユーザーがアクセスします。
- 販売者のコードは
navigator.runAdAuction()
を実行します。これにより、 入札可能な購入者などです営業担当者はスクリプトも含める必要があります。 (scoreAd()
)。 - 招待された購入者のコードが実行され、関連性の高い広告の入札単価と URL が生成されます その他のデータが含まれます。入札スクリプトでリアルタイム データをクエリし、 広告主からの広告キャンペーンの予算など Key-Value サービス。
- 販売者のコードが各入札のスコアを算出し、落札者を選択します。このロジックでは、 入札価格などのデータから、入札単価の好ましさが返されます。他を圧倒する広告 拒否されます営業担当者は独自の リアルタイム データ用の Key-Value サービス。
- 落札広告は不透明な値として返され、 フェンス付きフレーム。営業担当者と パブリッシャーはこの値を表示できません
- オークションは、販売者と落札した購入者にレポートされます。
オークションは、広告が表示されるページにユーザーが移動すると発生します。 オークションを前もって実施して、広告が配信される時点で広告クリエイティブを準備しておくことができます。 スロットが見えてきます。
販売者が広告オークションを開始し、提供されるカスタム ロジックを使用して広告候補を採点
scoreAd()
関数として機能し、
落札者にも配信します営業担当者は
パブリッシャーのルールを適用し、scoreAd()
を使用して広告の品質をフィルタ
使用します。
「営業担当者」とは、次のようなことを指します。
- 自身のウェブサイトで広告コンテンツをホストしているコンテンツ パブリッシャー
- 広告パブリッシャーと連携してその他のサービスを提供するサプライサイド プラットフォーム(SSP)
- パブリッシャーに代わって広告オークションに参加できるようにする第三者のスクリプト。
オークション実施の前提条件
ある販売者がオークションを実施するには、次の 2 つの JavaScript 関数を定義する必要があります。
scoreAd()
: 広告候補をスコア付けしますreportResult()
: オークションの結果を販売者に報告します
これらのスクリプトは、営業担当者が所有する単一のエンドポイントから配信する必要があります。
scoreAd()
営業担当者は、エンドポイントから提供される scoreAd()
関数を定義する必要があります。
自動的に作成されます。エンドポイントは、オークション設定で
decisionLogicUrl
。scoreAd()
関数には、次のシグネチャがあります。
scoreAd(
adMetadata,
bid,
auctionConfig,
trustedScoringSignals,
browserSignals,
directFromSellerSignals)
scoreAd()
パラメータは次のとおりです。
adMetaData
: 表示される広告クリエイティブに関する任意のメタデータ 購入者から提示される場合もありますこれはシリアル化可能な JSON オブジェクトで、 購入者側でこの構造を定義し、それに合意する必要があります。bid
: 入札単価を表す数値です。auctionConfig
: オークションの実施に使用されるオークション構成。trustedScoringSignals
: オークション時に、 販売者の Key-Value サーバーに送信されます。プラットフォームは、renderUrl
を使用します。 この検索のキーとして使用しますbrowserSignals
: ブラウザによって作成されるオブジェクトで、以下が含まれます。 ブラウザが認識している情報と販売者のオークション スクリプトが 確認します。directFromSellerSignals
は、次のフィールドを含めることができるオブジェクトです。 **sellerSignals
:auctionConfig.sellerSignals
に似ていますが、directFromSellerSignals
メカニズム。 **auctionSignals
:auctionConfig.auctionSignals
に似ていますが、directFromSellerSignals
メカニズムを使用します。
browserSignals
の例を次に示します。renderUrl
の
広告候補は、次のシグナルを介して利用可能になります。
{ 'topWindowHostname': 'www.example-publisher.com',
'interestGroupOwner': 'https://www.example-buyer.com',
'renderURL': 'https://cdn.com/render_url_of_bid',
'renderSize': {width: 100, height: 200}, /* if specified in the bid */
'adComponents': ['https://cdn.com/ad_component_of_bid',
'https://cdn.com/next_ad_component_of_bid',
...],
'biddingDurationMsec': 12,
'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}
reportResult()
販売者は、reportResult()
関数を定義する必要があります。この関数は、
管理する必要がありますエンドポイントはオークション設定で指定します。
(decisionLogicUrl
として)reportResult()
関数は次のとおりです。
署名:
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
reportResult()
パラメータは次のとおりです。
auctionConfig
: オークションの実施に使用されるオークション構成。browserSignals
: ブラウザによって作成されるオブジェクトで、以下が含まれます。 ブラウザが認識している情報と販売者のオークション スクリプトが 確認します。これは、scoreAds()
関数に渡されるオブジェクトと同じです。
reportResult()
は signalsForWinner
(任意の JSON オブジェクト)を返します。
落札した購入者のレポート関数に渡されます次の内容を含める必要があります。
オークションに関して販売者が提供できる関連情報
必要があります
Protected Audience API オークションを実施する
販売者がオークションを実施するには、主に 4 つのステップを行う必要があります。なお、 必要な JavaScript を返すようにエンドポイントが設定されていることを前提としています。 すでに説明しました
- オークションの設定このステップには、
auctionConfig
オブジェクトの作成が含まれます。 これにより、販売者は入札に参加する購入者を指定できます。 入札時に関連性の高いシグナルを提供できます 重要な役割を果たします navigator.runAdAuction()
を呼び出してオークションを実施します。その際、 構成します。これにより 入札単価の設定、スコアリングを行います。このステップの最終結果は広告候補の 広告を表示できます- フェンス付きのフレームまたは iframe で落札広告をレンダリングします。
- オークションの結果を報告します。関数があり
navigator.sendReportTo()
: レポートが開始されます。販売者は常に オークション結果のレポートを受け取れますオークションで落札した購入者のみ レポートが送信されます。これは、前述の販売者のreportResult()
を使用します。 サーバーに報告する必要があります。