Deal は、広告を配信するための広告枠、用語、ターゲティングの詳細などの情報のセグメントを表します。Proposal に 1 つ以上の取引を追加して、パブリッシャーと交渉できます。
取引の種類
交渉で使用できる取引は 3 種類あります。
- プライベート オークション取引（パブリッシャーが開始）
- 優先取引
- プログラマティック保証型取引
ライフサイクル
このセクションでは、取引のライフサイクルのさまざまなステージについて説明します。
提案を作成する
購入者は提案依頼書（RFP）を送信することで交渉を開始できます。ここで、取引タイプはリクエスト本文の preferredDealTerms または programmaticGuaranteedTerms で指定します。これらの取引タイプには、flightStartTime フィールドと flightEndTime フィールドが必要です。
プロポーザルを送信するには、PublisherProfile でパブリッシャーを参照する必要があります。
パブリッシャーと交渉する
この段階では、次のことを行います。
- プロポーザルとそれに対応する取引を更新します。
- パブリッシャーからの更新情報をポーリングします。
- 提案の利用規約をいつ承諾するかを決定します。
プロポーザルまたは取引にパッチを適用して変更を加えることができます。プロポーザルを更新すると、proposalRevision インクリメントします。
交渉をキャンセル
プロポーザルとそれに対応する取引の交渉をキャンセルした場合の動作は、プロポーザルに確定した proposalRevision があるかどうかによって異なります。
確定した proposalRevision が存在しない場合、プロポーザルのステータスは TERMINATED になり、そのプロポーザルは交渉できなくなります。この場合、パブリッシャーとの交渉を再開するには、新しいプロポーザルを送信する必要があります。
それ以外の場合は、プロポーザルとその取引は、最後に確定した proposalRevision に戻ります。
Marketplace API を使用してプライベート オークション取引の提案をキャンセルすることはできません。 プライベート オークション取引は、認定バイヤーのマーケットプレイスの管理画面でアーカイブできます。
ディールの成約
両者がプロポーザルを承認すると、プロポーザル内の取引は確定済みと見なされます。buyers.finalizedDeals リソースを使用して、確定した取引を管理できます。
双方が承認する前にプロポーザルが変更された場合、プロポーザル内の取引が確定されたとみなされる前に、両方の当事者が新しいリビジョンに同意する必要があります。
確定した取引を配信する
取引が確定すると、flightStartTime と flightEndTime で指定された期間に基づいて、入札リクエストに表示されます。掲載期間が指定されていない場合（プライベート オークション取引の場合のみ可能）、取引は無期限に配信されます。
取引は確定後すぐに配信が開始されます。サービス提供は通常、指定された flightStartTime に開始されます。
デフォルトの配信動作を無効にし、入札リクエストを受信するタイミングを手動で指定する場合は、テクニカル アカウント マネージャーに依頼して、手動で取引を配信準備完了として設定できるようにしてください。
プログラマティック保証型取引のクリエイティブを用意する必要がある場合は、プログラマティック保証型取引の広告配信を手動で開始することをおすすめします。これにより、取引の配信を開始する前に、クリエイティブの審査を受け、リアルタイム ビッダーの入札で送信できるようになります。プログラマティック保証型取引で使用するクリエイティブを追加したら、配信を開始する前に、取引に関連付けられたクリエイティブを確認することをおすすめします。
入札リクエストでは、取引はプロトコルに応じて次のいずれかのフィールドで表されます。
- Google:
BidRequest.adslot[].matching_ad_data[].direct_deal[].direct_deal_id - OpenRTB:
BidRequest.imp[].pmp.deals[].id
優先取引とプログラマティック保証型取引は、配信開始後に一時停止または再開できます。取引を一時停止すると、取引を再開するまで、その取引の入札リクエストを受信できなくなります。
プライベート オークション取引を一時停止できるのは、パブリッシャーのみです。
再交渉を開始する
購入者とパブリッシャーは、確定した優先取引とプログラマティック保証型取引の再交渉を開始できます。再交渉を開始するには、プロポーザルまたはその取引を修正します。両当事者が変更を承認するか、再交渉がキャンセルされるまで、再交渉することができます。
取引が承認されると、既存の確定済み取引が提案の改訂された取引に置き換わり、更新された条件に基づいて配信されます。
キャンセルされると、プロポーザルとその取引は最後に確定した proposalRevision に戻ります。
再交渉中も、以前に確定した取引は引き続き配信されます。確定した取引と最新の提案の改訂は引き続き表示できます。
プライベート オークション取引では、再交渉はサポートされていません。
配信を終了
サポートされているすべての取引タイプの確定した取引では、取引の配信が停止すると、dealServingStatus が ENDED に設定されます。取引の配信期間が終了する可能性がある条件の例を次に示します。
flightStartTimeとflightEndTimeで設定した期間が経過する。優先取引またはプログラマティック保証型取引では、これらのフィールドが必須であるため、これは一般的な方法です。- プログラマティック保証型取引の
impressionCapにリーチしました。
flightStartTime と flightEndTime を定義していないプライベート オークション取引は、無期限に配信できます。