長編動画サービス

Direct Supply のお客様は、 /prebid/lfv エンドポイントを使用して、アプリまたは Web の長文形式の広告ポッド動画インベントリを Prebid Server Premium (PSP) と統合できます。 長い形式の動画は 30 分以上で、プレロール、ミッドロール、ポストロールの位置が考えられます。

Microsoft Monetize 広告サーバーのお客様は、Microsoft Monetize への現在の統合を変更する必要はなく、長文ビデオ サービスを無視して、 代わりに PSP のセットアップ手順に従うことができます。

要求と応答のプロセス

次の手順は、長文ビデオの要求と応答のプロセスの概要を示しています:

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

REST API

次の表に、長尺動画の入札要求を送信するために必要なパラメーターとオプションのパラメーターを示します。

xdyn_params 例文

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

アプリ

app オブジェクトは、次の要求パラメーターをサポートします。

キャッシュ構成

cache config オブジェクトは、次の要求パラメーターをサポートします。

コンテンツ

content オブジェクトは、次の要求パラメーターをサポートします。

デバイス

device オブジェクトは、次の要求パラメーターをサポートします。

イード

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 でサポートされる形式と統合パス