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

1 つの販売者を対象にブラウザベースのオークションを実施する

このドキュメントでは、Google デマンドジェネレーションと現在のイテレーションで使用される、単一販売者の Protected Audience データ Protected Audience API です。1 人の販売者が参加するオークションでは複数の販売者が関与する複雑なオークションの一部として実施されます。この単一販売者オークションは「コンポーネントオークション」広告候補を「トップレベルのオークション」に送ることができる複数の販売担当者が参加しています。

Protected Audience API のライフサイクルについては、デベロッパーガイドをご覧ください。詳しくは、Protected Audience API の説明をご覧ください。販売者によるオンデバイスオークションの実施方法に関するディスカッションです。

Protected Audience API 広告オークションの 6 つのステージ

広告が表示されたサイトにユーザーがアクセスします。
販売者のコードは 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() を使用します。サーバーに報告する必要があります。