ビデオガイダンス

[アーティクル]
11/14/2024

このページには、Prebid Server Premium (PSP) を使用したビデオインベントリの実行に関するガイダンスが含まれています。

Web Prebid.js 上位の入札を送信する

Prebid.js の "上位入札の送信" 統合の設定に関するガイダンスについては、こちらを参照してください。 /ut/v3/prebid統合を通じて、ビデオインベントリが需要パートナーに正確に表現されるようにするには、次の手順を実行します。

Prebid.js バージョンが 8.47.0 以降で使用されていることを確認します。
[Plcmt フィールドと配置フィールドを一緒に使用する] セクションの下の表に一覧表示されている値に基づいて、tags.video.contextを Xandr extensions 列>設定します。
tags.video.startdelayを設定します。
通常どおり、 minduration、 maxduration、 playback_method、 skippableなどの他のフィールドを構成します。
OpenRTB 2.6 の収益化のサポートの詳細については、「 OpenRTB 2.6 との統合」を参照してください。

Web Prebid.js すべての入札を送信する

すべての入札統合を送信 Prebid.js の設定に関するガイダンスについては、こちらを参照してください。 /openrtb2/prebid統合を通じて、ビデオインベントリが需要パートナーに正確に表現されるようにするには、次の手順を実行します。

Prebid.js バージョンが 8.47.0 以降で使用されていることを確認します。
ヘッダー x-openrtb-version: 2.6を含めます。
次に示す値に基づいてvideo.plcmtを設定します。
- 1 instream
- 2 付随するコンテンツ
- 3 間隙
- 4 コンテンツ/スタンドアロンなし
ここに記載されている値に基づいてvideo.placementを設定する
- 1 instream
- 2 バナー内
- 3 記事内
- 4 フィード内
- 5 スポット/スライダー/フローティング
ここに記載されている値に基づいてvideo.startdelayを設定する
- >0 mid-roll (値は秒の開始遅延を示します)
- 0 プレロール
- -1 汎用ミッドロール
- -2 汎用ポストロール
必要に応じて、入札要求にvideo.plcmtとvideo.placementを設定する代わりに、ここに記載されている値に基づいてimp.video.ext.appnexus.contextフィールドを使用できます。要求パートナーへの最終的な要求には、ドキュメントのロジックに基づくvideo.placementとvideo.plcmtが含まれます。
通常どおり、 minduration、 maxduration、 playbackmethod、 skipなどの他のフィールドを設定します。
OpenRTB 2.6 に対する収益化のサポートの詳細については、こちらのページを参照してください。

Instream

次の例に示すように、構成設定に[PSP cache.url の収益化] オブジェクトを含めます。

pbjs.setConfig({
   "cache":{
      "url":"https://prebid.adnxs.com/pbc/v1/cache"
   },
   "debug":true,
   "enableSendAllBids":true,
   "s2sConfig":{
      "accountId":9325,
      "bidders":[
         "appnexus"
      ],
      "defaultVendor":"appnexuspsp"
   }
});

関連するキャッシュキー値が確実に返されるようにするには、次の例に示すように、s2sConfig内に extPrebid.cache.bids[{}] オブジェクトを含めます。

extPrebid = ([
   {
      "cache":{
         "bids":[
            {
               "bidder":"appnexus",
               "params":{
                  "placementId":1234567
               }
            }
         ]
      },
      "targeting":{
         "includebidderkeys":true,
         "includewinners":true
      }
   }
])

Outstream

(PSP を使用して) Prebid.js s2s に対して広告要求が行われるようにするには、次の例に示すように、adUnit 定義内にレンダラーオブジェクトを含めます。

var adUnits = ([
   {
      "code":"video1",
      "//first_comment":"This renderer would apply to all prebid creatives.",
      "renderer":{
         "url":"https://acdn.adnxs.com/video/outstream/ANOutstreamVideo.js",
         "render":"function (bid)",
         "ANOutstreamVideo.renderAd":{
            "targetId":"bid.adUnitCode",
            "adResponse":"bid.adResponse"
         }
      },
      "mediaTypes":{
         "video":{
            "context":"outstream",
            "playerSize":[
               640,
               480
            ],
            "mimes":[
               "video/mp4"
            ],
            "protocols":[
               1,
               2,
               3,
               4,
               5,
               6,
               7,
               8
            ],
            "playbackmethod":[
               2
            ],
            "skip":0,
            "playback_method":[
               "auto_play_sound_on"
            ]
         }
      },
      "bids":[
         {
            "bidder":"appnexus",
            "params":{
               "placementId":1234567,
               "//first_comment":"Your placement ID."
            }
         }
      ]
   }
])

収益化応答には prebid.type=videoが含まれますが、次の例に示すように、ユーザーが Prebid の追加のキー値ターゲット設定を設定した場合、 hb_format=video キー値は Google Ad Manager (GAM) に送信され、それに応じてターゲットにすることができます。
```
{
   "targetingControls":{
      "addTargetingKeys":[
         "SOURCE",
         "ADOMAIN",
         "FORMAT"
      ]
   }
}                        
```

コンテキストキー値をオークションに渡すためには、バージョン 6.14.0 以降 Prebid.js アップグレードし、それに応じて adUnit レベルのキーワードを定義してください。 (PSP を使用して) Prebid.js s2s に対して広告要求が正しく行われるようにするには、次の例に示すように、adUnit 定義内に keywords オブジェクトを含めることで、adUnit レベルのキーワードを収益化に渡します。

var adUnits = ([
   {
      "code":"div-1",
      "mediaTypes":{
         "banner":{
            "sizes":[
               {
                  "height":600,
                  "width":160
               }
            ]
         }
      },
      "bids":[
         {
            "bidder":"appnexus",
            "params":{
               "placementId":21230286,
               "keywords":{
                  "test-key":[
                     "test-value"
                  ]
               }
            }
         }
      ]
   }
])

詳細については、「広告ユニット固有のデータとオークションレベルのキーワード」を参照してください。

需要パートナーの対応

収益化で入札が考慮されるようにするには、需要パートナーの入札に、bid.dur (OpenRTB 2.6 の場合) または ext.prebid.video.duration (OpenRTB 2.6 がまだサポートされていない場合) のビデオクリエイティブ期間を含める必要があります。期間は XML から解析されないことに注意してください。

次の方法で共有

ビデオガイダンス

Web Prebid.js 上位の入札を送信する

Web Prebid.js すべての入札を送信する

Instream

Outstream

需要パートナーの対応

その他のリソース

次の方法で共有

ビデオ ガイダンス

Web Prebid.js 上位の入札を送信する

Web Prebid.js すべての入札を送信する

Instream

Outstream

需要パートナーの対応

関連項目

その他のリソース

ビデオガイダンス