この記事では、デマンドサイド プラットフォーム（DSP）が代理店プラットフォームとの統合により代理店をサポートし、代理店とパブリッシャーのレポートとワークフローを包括的に効率化する方法について説明します。
代理店は、プログラマティック非保証型取引の交渉をパブリッシャーと直接行って締結できます。こうした代理店レベルの取引は、代理店アカウントとパブリッシャー間で交渉され、その後、代理店アカウントに設定されているすべての DSP で取引できるようになります。代理店取引が作成されると、参加するすべての DSP で使用されるユニバーサル取引 ID が生成されます。これにより、同じキャンペーンで重複する取引 ID が減ります（DSP シートごとに 1 つ）。
代理店シートを使用して取引を行うための統合要件
代理店は、各 DSP の名前空間の DSP シート ID のリストを Google に提供します。Google は、このリストを代理店シートにマッピングします。DSP は、費用を代理店に正しく関連付けることができるよう、入札レスポンスで DSP シート ID を返す必要があります。
- OpenRTB 仕様（JSON または Protobuf）:
seatbidのseatフィールドに入力します。このフィールドにすでに入力しているパートナー様は、特にご対応いただく必要はありません。 - 代理店の DSP シート ID に加えて、入札レスポンスで advertiser_domain フィールドに値を入力します。
Marketplace API と統合されているビッダーの場合、Google は、ビッダー スコープの確定済みの取引リソースで代理店が締結した取引を返します。これらの取引はビッダーの所有ではないため、このリソースで返される代理店取引は読み取り専用となり、対応するプロポーザルもありません。
非保証型取引に対応するための取引フローと API 要件
取引は、Google の UI を通じて代理店とパブリッシャー間で直接交渉されます。
- パブリッシャーが Google アド マネージャーの管理画面で代理店 A に提案するプロポーザルを作成します。
- 代理店 A は、代理店アカウントの管理画面にログインしてプロポーザルを承認するか、変更を交渉します。
- 取引が成立して有効になると、代理店が選択した DSP に表示されます。これらの代理店取引は（従来の取引とは異なり）DSP には読み取り専用となりますが、変更することは可能です（代理店は Google の UI を通じて条件を再交渉できます）。
確定済みの代理店取引にアクセスするには、DSP 側で認定バイヤーの Marketplace API を統合する必要があります。
ビッダー / DSP の主な統合ポイント:
- ビッダーレベルの Finalized Deals API を使用して確定済み取引を取得する: 代理店取引は、DSP 管理のアカウントではなく代理店シートの所有となります。そのため、
buyers.finalizedDealsエンドポイントとbuyers.proposalsエンドポイントではこれらの取引は返されません。ビッダーは、ビッダーレベルの Finalized Deals API を使用して、確定済み取引の完全なリストを取得することもできます。 - オークション パッケージ: 同様のプロセスで、ビッダーは
bidders.auctionPackages.listエンドポイントを呼び出してオークション パッケージを取得できます。
API オブジェクトの更新: 既存の Deals API オブジェクトが拡張され、代理店アカウントに関する追加情報が含められるようになります。公開ドキュメントに追加される変更事項を以下に太字で示します。
取引の JSON 表現
{
// ...
// ... media_planner フィールドが
// 入力されている場合、このフィールドは空で、請求対象の
// 購入者は入札レスポンスに基づいて決定されます。
// 形式: `buyers/{buyerAccountId}`
"billedBuyer" : string
// 共用体フィールド negotiating_buyer は次のいずれかになります。
"buyer": string,
"client": string,
// このフィールドはメディア プランナーを表します（例: 代理店、
// 大手広告主）。
"mediaPlanner" : {
object (MediaPlanner)
}
// 共用体フィールド negotiating_buyer で使用できるタイプのリストは以上です。
// 設定されている場合、このフィールドには、この取引を行える
// DSP 固有のシート ID のリストが含まれます。
"eligibleSeatId": [
string
],
// ...
}
注: 重要な変更点は以下のとおりです。
- 新しい
mediaPlannerフィールドを使用して、代理店固有の取引を識別できます。 - 代理店固有の取引の場合、
billedBuyerフィールドは空になります。 - 新しい
eligibleSeatIdsフィールドには、取引に入札できる DSP 独自の名前空間のシートセットが含まれます。シート ID が指定されていないまたはこのリストにない取引の入札レスポンスは、Google によって除外されます。