ビデオガイダンス

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

Web Prebid.js 統合

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

Prebid.js バージョンが 10.13.0 以降で使用されていることを確認します。
ヘッダー x-openrtb-version: 2.6を含めます。
次に示す値に基づいてvideo.plcmtを設定します。
- 1 インストリーム
- 2 付随するコンテンツ
- 3 間隙
- 4 コンテンツ/スタンドアロンなし
ここに記載されている値に基づいてvideo.placementを設定する
- 1 インストリーム
- 2 バナー内
- 3 記事内
- 4 フィード内
- 5 スポット/スライダー/フローティング
ここに記載されている値に基づいてvideo.startdelayを設定する
- >0 mid-roll (値は秒の開始遅延を示します)
- 0 プレロール
- -1 汎用ミッドロール
- -2 汎用ポストロール

通常どおり、 minduration、 maxduration、 playbackmethod、 skipなどの他のフィールドを設定します。
OpenRTB 2.6 に対する収益化のサポートの詳細については、こちらのページを参照してください。

インストリーム

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

pbjs.setConfig({
   "cache":{
      "useLocal":true
   },
   "debug":true,
   "enableSendAllBids":true,
   "s2sConfig":{
      "accountId":9325,
      "bidders":[
         "msft"
      ]
   }
});

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

extPrebid = ([
   {
      "cache":{
         "bids":[
            {
               "bidder":"msft",
               "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":"msft",
            "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":"msft",
            "params":{
               "placementId":21230286,
               "keywords":{
                  "test-key":[
                     "test-value"
                  ]
               }
            }
         }
      ]
   }
])

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

需要パートナーの対応

需要パートナーは、広告がインストリームと広告ポッドの機会の両方で予想される時間を埋めるように、すべての入札で期間を送信する必要があります。

インストリーム: 期間は厳密には必要ありません。送信された期間が 0 の場合、入札は引き続き勝利し、配信できますが、収益化ではビデオが適切な長さであることを確認できません。
広告ポッド: 入札には、 bid.dur (OpenRTB 2.6 の場合) または ext.prebid.video.duration (OpenRTB 2.6 がまだサポートされていない場合) にビデオクリエイティブ期間を含める必要があります。期間は XML から解析されないことに注意してください。

外部広告サーバーの設定

収益化以外の広告サーバーを使用すると、Prebid 広告申込情報と関連するクリエイティブに VAST タグ URL またはキャッシュ URL が必要になる場合があります。これらのシナリオの詳細については、Prebid.org ドキュメントを参照してください。

PSP で外部広告サーバーを使用する場合は、

Prebid.js Web の構成: ここで説明 Prebid.js クライアント側キャッシュとローカルクライアント側キャッシュオプションに関するページを参照し、要件に従って構成します。また、こちらの「 setConfig 入札キャッシュ関数」を参照し、適切な手順を実行します。
Prebid Mobile SDK アプリを構成する: 理想的には、広告サーバーは PSP 応答から hb_cache_host と hb_cache_path ターゲットキーを組み合わせて、完全かつ動的なキャッシュ URL を取得します。それがサポートされていない場合、広告サーバーには静的でハードコーディングされたパスが必要です。 https://ib.adnxs.com/prebid/cache?uuid=%%PATTERN:hb_uuid_BIDDERCODE%%を静的 URL として使用できます。

Last updated on 2025-12-19

次の方法で共有

ビデオ ガイダンス