Protected Audience API のオークション結果に関するレポート

Protected Audience API オークション レポートを生成するための販売者と購入者向けガイド。

この記事では、 試験運用版の現在のイテレーションで使用されている、Protected Audience API オークションの落札者 Protected Audience API

詳しくはデベロッパー ガイドをご覧ください。 Protected Audience API のサイクルについて説明されています。詳しくは Protected Audience API の解説をご覧ください。 イベントレベルのレポート（一時的）。

デベロッパー以外の方は、Protected Audience API の概要をご覧ください。

Protected Audience API レポートの内容

Protected Audience API レポートには次の 2 種類があります。

  • 販売者レポート: 広告オークションの落札者を販売者に通知します。
  • 購入者レポート: 落札した購入者のみがオークションに勝ったことを確認できます。

長期的な計画では、ブラウザから 販売者と購入者を Private Aggregation API で呼び出します。 一時的なイベントレベルのレポート メカニズムとして、 販売者の reportResult()、落札者の reportWin() が、 sendReportTo() 関数を呼び出します。この引数は 1 つの引数を取ります。 はオークションの完了後に取得される URL で、 イベントレベルの情報を指定します。

API 関数

販売者: reportResult()

decisionLogicUrl で提供される販売者の JavaScript（ scoreAd()）に reportResult() 関数を含めて、オークションをレポートできます。 できます。

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

この関数に渡される引数は次のとおりです。

auctionConfig

navigator.runAdAuction() に渡されるオークション設定オブジェクト。

browserSignals

オークションに関する情報を提供するブラウザによって構築されるオブジェクト。 例:

  {
    'topWindowHostname': 'publisher.example',
    'interestGroupOwner': 'https://dsp.example',
    'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
    'bid': <bidValue>,
    'desirability': <winningAdScore>
  }

この関数の戻り値は、sellerSignals 引数として、 落札者の reportWin() 関数を呼び出します。

購入者: reportWin()

落札したビッダーの JavaScript（generateBid() も提供）は、 オークション結果をレポートする reportWin() 関数を含める。

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}

この関数に渡される引数は次のとおりです。

auctionSignals、perBuyerSignals

落札したルールと同じ値を generateBid() に渡す 表示されます。

sellerSignals

reportResult() の戻り値。販売者に以下の情報を提供します。 購入者に情報を伝えることができます

browserSignals

オークションに関する情報を提供するブラウザによって構築されるオブジェクト。 例:

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid': <bidValue>
}

一時的なレポートの実装

Chrome では、オークション レポートで一時的に次の 2 つの方法をご利用いただけます。

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

これらのメソッドにそれぞれ 1 つの引数として、オークション後にフェッチする URL、 完了していません。これらは、scoreAd() と 異なる URL 引数を指定した generateBid()。

Chrome では、オークションが完了した場合にのみ、デバッグの損失/落札レポートが送信されます。条件 （新しいナビゲーションなどにより）オークションがキャンセルされた場合、 生成されます。

これらのメソッドは、chrome://settings/adPrivacy で広告プライバシー API をすべて有効にした場合に、Chrome でデフォルトで利用できます。複数の コマンドライン フラグを使用して Chrome で Protected Audience API を有効にする場合は、BiddingAndScoringDebugReportingAPI フラグを含めてメソッドを明示的に有効にする必要があります。フラグが有効になっていない場合、メソッドは引き続き使用できますが、何も行われません。

すべての Protected Audience API リファレンス

API リファレンス ガイドが提供されています。

Protected Audience API の解説では、機能のサポートと制約に関する詳細も説明しています。

次のステップ

誰もが利用できる API を構築するために、Google は皆様との対話を通じてしたいと考えています。

API についてディスカッションする

他のプライバシー サンドボックス API と同様に、この API はドキュメント化され、一般公開されているです。

API を試す

Protected Audience API に関する会話をテストして参加できます。