Video guidance
This page includes guidance on running video inventory through Prebid Server Premium (PSP).
Guidance on setting up the Prebid.js "send top bid" integration can be found here. To ensure video inventory is accurately represented to demand partners through the /ut/v3/prebid
integration:
- Ensure the Prebid.js version is 8.47.0 or higher is being used.
- Set
tags.video.context
based on the values listed in the table under the section Using "Plcmt and Placement fields together" > Xandr extensions column. - Set
tags.video.startdelay
. - Configure other fields, such as
minduration
,maxduration
,playback_method
,skippable
, and so on, as normal. - For more information about Monetize's support for OpenRTB 2.6, see Integration with OpenRTB 2.6.
Guidance on setting up the Prebid.js send all bids integration can be found here. To ensure video inventory is accurately represented to demand partners through the /openrtb2/prebid
integration:
Ensure the Prebid.js version is 8.47.0 or higher is being used.
Include the header
x-openrtb-version: 2.6
.Set
video.plcmt
based on the values listed here:1
instream2
accompanying content3
interstitial4
no content/standalone
Set
video.placement
based on the values listed here1
instream2
in-banner3
in-article4
in-feed5
interstitial/slider/floating
Set
video.startdelay
based on the values listed here>0
mid-roll (value indicates start delay in second)0
pre-roll-1
generic mid-roll-2
generic post-roll
If needed or preferred, instead of setting
video.plcmt
andvideo.placement
in the bid request, theimp.video.ext.appnexus.context
field can be used based on values listed here. The final request to demand partners will includevideo.placement
andvideo.plcmt
based on the logic in the documentation.Set other fields, such as
minduration
,maxduration
,playbackmethod
,skip
, and so on, as normal.For more information on Monetize's support for OpenRTB 2.6, see this page.
Include the Monetize PSP
cache.url
object in the config settings as shown in the following example:pbjs.setConfig({ "cache":{ "url":"https://prebid.adnxs.com/pbc/v1/cache" }, "debug":true, "enableSendAllBids":true, "s2sConfig":{ "accountId":9325, "bidders":[ "appnexus" ], "defaultVendor":"appnexuspsp" } });
To ensure that the relevant cache key-values are returned, include the
extPrebid.cache.bids[{}]
object within thes2sConfig
as shown in the following example:extPrebid = ([ { "cache":{ "bids":[ { "bidder":"appnexus", "params":{ "placementId":1234567 } } ] }, "targeting":{ "includebidderkeys":true, "includewinners":true } } ])
To ensure that the ad request is made for
Prebid.js s2s
(with PSP), include the renderer object within the adUnit definition as shown in the following example: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." } } ] } ])
Monetize response includes
prebid.type=video
, but if the user sets additional key-value targeting for Prebid, as shown in the below example, then thehb_format=video
key-value will be sent to Google Ad Manager (GAM) and can be targeted accordingly.{ "targetingControls":{ "addTargetingKeys":[ "SOURCE", "ADOMAIN", "FORMAT" ] } }
To leverage passing contextual key-values into the auction, be sure to upgrade to
Prebid.js
version 6.14.0 or higher, and define adUnit-level keywords accordingly. To ensure that the ad request is made properly forPrebid.js s2s
(with PSP), pass adUnit-level keywords to Monetize by including the keywords object within the adUnit definition as shown in the following example:var adUnits = ([ { "code":"div-1", "mediaTypes":{ "banner":{ "sizes":[ { "height":600, "width":160 } ] } }, "bids":[ { "bidder":"appnexus", "params":{ "placementId":21230286, "keywords":{ "test-key":[ "test-value" ] } } } ] } ])
For more information, see Ad Unit specific data and auction-level keywords.
To ensure Monetize considers a bid, demand partners' bids must include the video creative duration in either bid.dur (for OpenRTB 2.6) or ext.prebid.video.duration (if OpenRTB 2.6 is not yet supported). Please note that the duration is not parsed from XML.