長い形式のビデオ サービス

Direct Supply のお客様は、 /prebid/lfv エンドポイントを使用して、アプリまたは Web ロングフォーム広告ポッドのビデオ インベントリを Prebid Server Premium (PSP) と統合できます。 長い形式のビデオ再生時間は、少なくとも 30 分で、プリロール、ミッドロール、ポストロールの位置が考えられる場合があります。

Microsoft 収益化 Ad Server のお客様は、現在の統合を Microsoft 収益化に変更する必要はありません。長い形式のビデオ サービスを無視して、 代わりに PSP のセットアップ手順に従うことができます。

要求と応答プロセス

次の手順では、長い形式のビデオ要求と応答プロセスの概要を示します。

1. パブリッシャーは、 /prebid/lfv エンドポイント経由で Microsoft 収益化のインプレッション バス (ImpBus) に長い形式のビデオ要求を送信します。 この要求には、広告ポッドの POST 値 (広告の再生時間、動画の幅と高さなど)、競合的な分離のためのブランド カテゴリなどのオプションのプロパティが含まれます。
2. ImpBus は要求を開梱し、広告ポッド内で埋める広告スロットの数を決定します。
3. 収益化から構成が取得され、要求された数の広告スロットを含む OpenRTB 要求が ImpBus によって作成されます。
4. ImpBus は、PSP 需要パートナーや Microsoft Invest を含むすべての Microsoft 収益化入札者に OpenRTB 要求を送信します
   1. Prebid 需要パートナーは、それぞれ一意の IAB サブカテゴリを持つ入札を返します。
   2. Microsoft Invest および外部の入札者には、IAB サブカテゴリに変換されるすべての入札に関連付けられた一意の Microsoft 収益化ブランド カテゴリがあります。
5. ImpBus は、Microsoft 収益化マーケットプレースのオークションを実行して、Microsoft 収益化の入札の獲得を決定します。
6. 手順 3 で取得したパブリッシャーと広告サーバーの構成に基づいて、ImpBus は IAB サブカテゴリをプライマリ広告サーバー カテゴリ (Freewheel または Google Ad Manager) に変換します。
   1. Microsoft 収益化入札の場合、ImpBus は Microsoft 収益化カテゴリから IAB サブカテゴリに変換され、最後にプライマリ広告サーバー カテゴリに変換されます。
7. 入札は、価格バケット、プライマリ広告サーバーカテゴリ、期間のタプル値に基づいて重複除去されます。
8. 一意の入札ごとに、ImpBus は一意の VAST XML をキャッシュします。
9. キーと値のターゲティング ペアは、 hb_pb、 hb_pb_cat_dur, 、 hb_cache_idの入札ごとに生成されます。
10. ImpBus は、キーと値のペアとキャッシュ ID をターゲットとする Prebid を含む JSON 応答を返します。

REST API

次の表に、長形式のビデオ入札要求を送信するために必要なパラメーターと省略可能なパラメーターを示します。

xdyn_params 例

{
  "xdyn_params": {
    "appnexus": {
      "keywords": "key1=val1,key2=val2"
    }
  }
}

アプリ

app オブジェクトでは、次の要求パラメーターがサポートされています。

キャッシュ構成

cache config オブジェクトでは、次の要求パラメーターがサポートされています。

コンテンツ

content オブジェクトでは、次の要求パラメーターがサポートされています。

デバイス

device オブジェクトでは、次の要求パラメーターがサポートされています。

Eids

eid オブジェクトでは、次の要求パラメーターがサポートされています。

ブランド カテゴリを含める

includebrandcategory オブジェクトでは、次の要求パラメーターがサポートされています。

サイト

site オブジェクトでは、次の要求パラメーターがサポートされています。

User

user オブジェクトでは、次の要求パラメーターがサポートされています。

ビデオ

video オブジェクトでは、次の要求パラメーターがサポートされています。

ポッド

pod オブジェクトでは、次の要求パラメーターがサポートされています。

ポッド構成

pod config オブジェクトでは、次の要求パラメーターがサポートされています。

期間の範囲

podconfig.durationrangesecは、広告ポッド内の広告スロットの期間を表す整数の配列です。

podconfig.durationrangesec = [15, 30];

EU 一般データ保護規則 (GDPR)

GDPR は、欧州連合によって制定されたデータ プライバシー法です。 GDPR の目標は、より厳格なデータプライバシーとセキュリティ対策を提供し、データ保護プラクティスに関するよりわかりやすい開示とレポートを提供することです。

価格の細分性

価格粒度範囲

応答

需要パートナーは、広告ポッドの入札要求に対する応答を JSON 形式で返します。

広告ポッド

広告ポッドのターゲット設定

例

コード例

curl -X "POST" -H "Content-Type: application/json" -d 

{
   "podconfig":{
      "durationrangesec":[
         30
      ],
      "requireexactduration":false,
      "pods":[
         {
            "podid":1,
            "adpoddurationsec":60,
            "placementid":14997137
         }
      ]
   },
   "site":{
      "page":"https://www.foobar.com/1234.md"
   },
   "user":{
      "yob":1982,
      "gender":"M"
   },
   "device":{
      "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13 (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2",
      "ip":"123.145.167.10",
      "devicetype":1,
      "ifa":"AA000DFE74168477C70D291f574D344790E0BB11"
   },
   "includebrandcategory":{
      "primaryadserver":1
   },
   "video":{
      "w":640,
      "h":480,
      "mimes":[
         "video/mp4"
      ],
      "protocols":[
         2,
         3
      ]
   },
   "content":{
      "episode":6,
      "title":"episodeName",
      "series":"TvName",
      "season":"season3",
      "len":900,
      "livestream":false,
      "genre":"comedy",
      "program_type":"series",
      "contentrating":"GA",
      "id":"ABCDEF12345678",
      "language":"EN",
      "network":"XTV",
      "channel":"XandrTV",
      "airtime":1657827359,
      "album":"showads",
      "cat":[
         "IAB1-7",
         "IAB19-18"
      ],
      "context":1,
      "embeddable":false,
      "isrc":"USXND2100112",
      "keywords":"prizeworth=5000,gameshow,edu=true",
      "prodq":"prosumer",
      "qagmediarating":1,
      "sourcerelationship":true,
      "url":"https://tvname.xandrtv.com/overview",
      "userrating":"4/5 recommended",
      "producer":{
         "id":"xndtv5401",
         "name":"XandrTV",
         "cat":[
            "IAB1-7",
            "IAB19-18"
         ],
         "domain":"xandrtv.com"
      },
      "data":[
         {
            "id":"xandr",
            "name":"xndtv",
            "segment":[
               {
                  "id":"11854",
                  "name":"repeat viewers",
                  "value":"973"
               }
            ]
         }
      ]
   },
   "pricegranularity":{
      "precision":2,
      "ranges":[
         {
            "max":30.00,
            "increment":1.00
         }
      ]
   }
}

関連トピック

PSP でサポートされている形式と統合パス