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 が定義されていないプライベート オークションの取引は、無期限で配信できます。