Note: You must include the Ad Server’s module in your build.
Configure Prebid
To register a video player with Prebid, you must use setConfig to set a video config compliant with the structure described in the setConfig reference.
Configure Ad Units
In order for Prebid to know which Ad Unit relates to which Video Player, you must include a video configuration in your Ad Unit. This allows Prebid to render the ad in the proper Video Player and obtain the Ortb data from the Video Player that will render the ad.
For the list of properties in the video object of the ad unit please visit the adUnit.video reference.
Features for Publishers
Integrating with the Video Module gives publishers access to the following features
Render ads
Prebid can load the ad directly into the player when the auction is complete.
This feature happens automatically as long as you do not define a bidsBackHandler when calling requestBids.
Events
Media, ad and Player events are added when using the Video Module.
The event payload includes metadata which can be used for analytics, error handling, and customizing your integration.
Event Constant
Event String
Description
SETUP_COMPLETE
‘videoSetupComplete’
Fired when the player is instantiated and the integration is complete. At this point the API is ready to be used.
SETUP_FAILED
‘videoSetupFailed’
Fired when the integration was unsuccessful.
DESTROYED
‘videoDestroyed’
Fired when the player instance has been destroyed.
AD_REQUEST
‘videoAdRequest’
Fired when the player is asked to load an ad.
AD_BREAK_START
‘videoAdBreakStart’
Fired when an ad break begins. An ad break consists of an ad, or a sequence of subsequent ads.
AD_LOADED
‘videoAdLoaded’
Fired when the player has finished loading the ad’s VAST response.
AD_STARTED
‘videoAdStarted’
Fired when the ad playback has started.
AD_IMPRESSION
‘videoAdImpression’
Fired when an ad has been played for 2 consecutive seconds while the player is at least 50% viewable, as defined by the IAB standards for video ad impressions.
AD_PLAY
‘videoAdPlay’
Fired when ad playback starts and is resumed after a pause.
AD_TIME
‘videoAdTime’
Fired as the ad playback progresses. Frequency depends on the player.
AD_PAUSE
‘videoAdPause’
Fired when the ad is paused.
AD_CLICK
‘videoAdClick’
Fired when the ad is clicked or tapped.
AD_SKIPPED
‘videoAdSkipped’
Fired when the ad is skipped.
AD_ERROR
‘videoAdError’
Fired when an error occurred while attempting to load or render the ad.
AD_COMPLETE
‘videoAdComplete’
Fired when the ad has reached its end.
AD_BREAK_END
‘videoAdBreakEnd’
Fired when the sequence of ads in the break has ended.
PLAYLIST
‘videoPlaylist’
Fired when a media playlist has been loaded into the player.
PLAYBACK_REQUEST
‘videoPlaybackRequest’
Fired when an attempt to start the media playback has been made i.e. the viewer has tapped the play icon.
AUTOSTART_BLOCKED
‘videoAutostartBlocked’
Fired when autostart has been prevented. Generally, autostart is prevented by the browser.
PLAY_ATTEMPT_FAILED
‘videoPlayAttemptFailed’
Fired when the user’s attempt to begin playback is unsuccessful.
CONTENT_LOADED
‘videoContentLoaded’
Fired when the content media is loaded into the player.
PLAY
‘videoPlay’
Fired when the content playback begins or is resumed.
PAUSE
‘videoPause’
Fired when the content playback is paused.
BUFFER
‘videoBuffer’
Fired when the player enters a buffer state. Usually caused by a delay in loading video segments to continue playback.
TIME
‘videoTime’
Fired as the content playback progresses. Frequency depends on the player.
SEEK_START
‘videoSeekStart’
Fired when the viewer begins seeking in content.
SEEK_END
‘videoSeekEnd’
Fired when the viewer has finished seeking in the content.
MUTE
‘videoMute’
Fired when the player is muted.
VOLUME
‘videoVolume’
Fired when the player’s volume has changed.
RENDITION_UPDATE
‘videoRenditionUpdate’
Fired when a change occurred in the video’s encoded width, encoded height, reported video bitrate, reported audio bitrate or video framerate.
ERROR
‘videoError’
Fired when a player experiences an unrecoverable playback error while playing or attempting to play content.
COMPLETE
‘videoComplete’
Fired when a media content has reached its end.
PLAYLIST_COMPLETE
‘videoPlaylistComplete’
Fired when the last piece of content in a media playlist has ended.
FULLSCREEN
‘videoFullscreen’
Fired when the player enters or exits fullscreen mode.
PLAYER_RESIZE
‘videoPlayerResize’
Fired when the player’s size is modified.
VIEWABLE
‘videoViewable’
Fired when the player’s viewability is changed. Viewability is a percentage of the player’s size currently in view. The granularity at which this event is triggered depends on the player.
CAST
‘videoCast’
Fired when casting to an external device begins or ends.
AUCTION_AD_LOAD_ATTEMPT
‘videoAuctionAdLoadAttempt’
Fired when Prebid attempts to load the winning ad from a Prebid auction into the player.
AUCTION_AD_LOAD_QUEUED
‘videoAuctionAdLoadQueued’
Fired when Prebid queues the winning ad from a Prebid auction. This occurs when the Video Provider is not yet instantiated. The ad will be loaded into the player once the Video Provider is instantiated.
AUCTION_AD_LOAD_ABORT
‘videoAuctionAdLoadAbort’
Fired when the attempt to load the winning ad from a Prebid auction into the player is prevented.
BID_IMPRESSION
‘videoBidImpression’
Fired when the ad from a bid resulted in an impression.
BID_ERROR
‘videoBidError’
Fired when the ad from a bid resulted in an error.
Event params
All Video Module events include a divId and type param in the payload by default.
The divId is the div id string of the player emitting the event; it can be used as an identifier. The type is the string name of the event.
The remaining Payload params are listed in the following:
SETUP_COMPLETE
argument name
type
description
playerVersion
string
The version of the player on the page
viewable
boolean
Is the player currently viewable?
viewabilityPercentage
number
The percentage of the video that is currently viewable on the user’s screen.
mute
boolean
Whether or not the player is currently muted.
volumePercentage
number
The volume of the player, as a percentage
SETUP_FAILED
argument name
type
description
playerVersion
string
The version of the player on the page
errorCode
number
The identifier of the error preventing the media from rendering
errorMessage
string
Developer friendly description of the reason the error occurred.
sourceError
object
The underlying root Error which prevented the playback.
DESTROYED
No additional params.
AD_REQUEST
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
AD_BREAK_START
argument name
type
description
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
AD_LOADED
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
loadTime
number
Time the ad took to load in milliseconds
vastAdId
string
The ID given to the ad within the ad tag’s XML. Nullable when absent from the VAST xml.
adDescription
string
Description of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
adServer
string
Ad server used (e.g. dart or mediamind) from the vast tag. Nullable when absent from the VAST xml.
adTitle
string
Title of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
advertiserId
string
Optional identifier for the advertiser, provided by the ad server. Nullable when absent from the VAST xml.
advertiserName
string
Name of the advertiser as defined by the ad serving party, from the vast XML. Nullable when absent from the VAST xml.
dealId
string
The ID of the Ads deal. Generally relates to Direct Sold Ad Campaigns. Nullable when absent from the VAST xml.
linear
boolean
Is the ad linear or not?
vastVersion
string
Version of VAST being reported from the tag
creativeUrl
string
The URL representing the VPAID or MP4 ad that is run
adId
string
Unique Ad ID - refers to the ‘attribute’ of the node within the VAST. Nullable when absent from the VAST xml.
universalAdId
string
Unique identifier for an ad in VAST4. Nullable when absent from the VAST xml.
creativeId
string
Ad server’s unique ID for the creative pulled from the ad tag’s XML. Should be used to specify the ad server’s unique identifier as opposed to the Universal Ad Id which is used for maintaining a creative id for the ad across multiple systems. Nullable when absent from the VAST xml.
creativeType
string
The MIME type of the ad creative currently being displayed
redirectUrl
string
the url to which the viewer is being redirected after clicking the ad. Nullable when absent from the VAST xml.
adPlacementType
number
The video placements per IAB guidelines. Enum list: In-Stream: 1, In-Banner: 2, In-Article: 3, In-Feed: 4, Interstitial/Slider/Floating: 5
waterfallIndex
number
Index of the current item in the ad waterfall
waterfallCount
number
The count of items in a given ad waterfall
adPodCount
number
the total number of ads in the pod
adPodIndex
number
The index of the currently playing ad within an ad pod
wrapperAdIds
array[string]
Ad IDs of the VAST Wrappers that were loaded while loading the Ad tag. The list returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
AD_STARTED
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
loadTime
number
Time the ad took to load in milliseconds
vastAdId
string
The ID given to the ad within the ad tag’s XML. Nullable when absent from the VAST xml.
adDescription
string
Description of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
adServer
string
Ad server used (e.g. dart or mediamind) from the vast tag. Nullable when absent from the VAST xml.
adTitle
string
Title of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
advertiserId
string
Optional identifier for the advertiser, provided by the ad server. Nullable when absent from the VAST xml.
advertiserName
string
Name of the advertiser as defined by the ad serving party, from the vast XML. Nullable when absent from the VAST xml.
dealId
string
The ID of the Ads deal. Generally relates to Direct Sold Ad Campaigns. Nullable when absent from the VAST xml.
linear
boolean
Is the ad linear or not?
vastVersion
string
Version of VAST being reported from the tag
creativeUrl
string
The URL representing the VPAID or MP4 ad that is run
adId
string
Unique Ad ID - refers to the ‘attribute’ of the node within the VAST. Nullable when absent from the VAST xml.
universalAdId
string
Unique identifier for an ad in VAST4. Nullable when absent from the VAST xml.
creativeId
string
Ad server’s unique ID for the creative pulled from the ad tag’s XML. Should be used to specify the ad server’s unique identifier as opposed to the Universal Ad Id which is used for maintaining a creative id for the ad across multiple systems. Nullable when absent from the VAST xml.
creativeType
string
The MIME type of the ad creative currently being displayed
redirectUrl
string
the url to which the viewer is being redirected after clicking the ad. Nullable when absent from the VAST xml.
adPlacementType
number
The video placements per IAB guidelines. Enum list: In-Stream: 1, In-Banner: 2, In-Article: 3, In-Feed: 4, Interstitial/Slider/Floating: 5
waterfallIndex
number
Index of the current item in the ad waterfall
waterfallCount
number
The count of items in a given ad waterfall
adPodCount
number
the total number of ads in the pod
adPodIndex
number
The index of the currently playing ad within an ad pod
wrapperAdIds
array[string]
Ad IDs of the VAST Wrappers that were loaded while loading the Ad tag. The list returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
AD_IMPRESSION
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
loadTime
number
Time the ad took to load in milliseconds
vastAdId
string
The ID given to the ad within the ad tag’s XML. Nullable when absent from the VAST xml.
adDescription
string
Description of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
adServer
string
Ad server used (e.g. dart or mediamind) from the vast tag. Nullable when absent from the VAST xml.
adTitle
string
Title of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
advertiserId
string
Optional identifier for the advertiser, provided by the ad server. Nullable when absent from the VAST xml.
advertiserName
string
Name of the advertiser as defined by the ad serving party, from the vast XML. Nullable when absent from the VAST xml.
dealId
string
The ID of the Ads deal. Generally relates to Direct Sold Ad Campaigns. Nullable when absent from the VAST xml.
linear
boolean
Is the ad linear or not?
vastVersion
string
Version of VAST being reported from the tag
creativeUrl
string
The URL representing the VPAID or MP4 ad that is run
adId
string
Unique Ad ID - refers to the ‘attribute’ of the node within the VAST. Nullable when absent from the VAST xml.
universalAdId
string
Unique identifier for an ad in VAST4. Nullable when absent from the VAST xml.
creativeId
string
Ad server’s unique ID for the creative pulled from the ad tag’s XML. Should be used to specify the ad server’s unique identifier as opposed to the Universal Ad Id which is used for maintaining a creative id for the ad across multiple systems. Nullable when absent from the VAST xml.
creativeType
string
The MIME type of the ad creative currently being displayed
redirectUrl
string
the url to which the viewer is being redirected after clicking the ad. Nullable when absent from the VAST xml.
adPlacementType
number
The video placements per IAB guidelines. Enum list: In-Stream: 1, In-Banner: 2, In-Article: 3, In-Feed: 4, Interstitial/Slider/Floating: 5
waterfallIndex
number
Index of the current item in the ad waterfall
waterfallCount
number
The count of items in a given ad waterfall
adPodCount
number
the total number of ads in the pod
adPodIndex
number
The index of the currently playing ad within an ad pod
wrapperAdIds
array[string]
Ad IDs of the VAST Wrappers that were loaded while loading the Ad tag. The list returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
time
number
The playback time in the ad when the event occurs, in seconds.
duration
number
Total duration of an ad in seconds
AD_PLAY
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
AD_TIME
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
time
number
The current poisition in the ad timeline
duration
number
Total duration of an ad in seconds
AD_PAUSE
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
AD_CLICK
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
loadTime
number
Time the ad took to load in milliseconds
vastAdId
string
The ID given to the ad within the ad tag’s XML. Nullable when absent from the VAST xml.
adDescription
string
Description of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
adServer
string
Ad server used (e.g. dart or mediamind) from the vast tag. Nullable when absent from the VAST xml.
adTitle
string
Title of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
advertiserId
string
Optional identifier for the advertiser, provided by the ad server. Nullable when absent from the VAST xml.
advertiserName
string
Name of the advertiser as defined by the ad serving party, from the vast XML. Nullable when absent from the VAST xml.
dealId
string
The ID of the Ads deal. Generally relates to Direct Sold Ad Campaigns. Nullable when absent from the VAST xml.
linear
boolean
Is the ad linear or not?
vastVersion
string
Version of VAST being reported from the tag
creativeUrl
string
The URL representing the VPAID or MP4 ad that is run
adId
string
Unique Ad ID - refers to the ‘attribute’ of the node within the VAST. Nullable when absent from the VAST xml.
universalAdId
string
Unique identifier for an ad in VAST4. Nullable when absent from the VAST xml.
creativeId
string
Ad server’s unique ID for the creative pulled from the ad tag’s XML. Should be used to specify the ad server’s unique identifier as opposed to the Universal Ad Id which is used for maintaining a creative id for the ad across multiple systems. Nullable when absent from the VAST xml.
creativeType
string
The MIME type of the ad creative currently being displayed
redirectUrl
string
the url to which the viewer is being redirected after clicking the ad. Nullable when absent from the VAST xml.
adPlacementType
number
The video placements per IAB guidelines. Enum list: In-Stream: 1, In-Banner: 2, In-Article: 3, In-Feed: 4, Interstitial/Slider/Floating: 5
waterfallIndex
number
Index of the current item in the ad waterfall
waterfallCount
number
The count of items in a given ad waterfall
adPodCount
number
the total number of ads in the pod
adPodIndex
number
The index of the currently playing ad within an ad pod
wrapperAdIds
array[string]
Ad IDs of the VAST Wrappers that were loaded while loading the Ad tag. The list returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
time
number
The playback time in the ad when the event occurs, in seconds.
duration
number
Total duration of an ad in seconds
AD_SKIPPED
argument name
type
description
time
number
The playback time in the ad when the event occurs, in seconds.
duration
number
Total duration of an ad in seconds
AD_ERROR
argument name
type
description
playerErrorCode
number
The ad error code from the Player’s internal spec.
vastErrorCode
number
The error code for the VAST response that is returned from the request, as defined in the VAST spec.
errorMessage
string
Developer friendly description of the reason the error occurred.
sourceError
object
The underlying root Error which prevented the playback.
adTagUrl
string
The URL for the ad tag associated with the given ad event
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
loadTime
number
Time the ad took to load in milliseconds
vastAdId
string
The ID given to the ad within the ad tag’s XML. Nullable when absent from the VAST xml.
adDescription
string
Description of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
adServer
string
Ad server used (e.g. dart or mediamind) from the vast tag. Nullable when absent from the VAST xml.
adTitle
string
Title of the ad pulled from the ad tag’s XML. Nullable when absent from the VAST xml.
advertiserId
string
Optional identifier for the advertiser, provided by the ad server. Nullable when absent from the VAST xml.
advertiserName
string
Name of the advertiser as defined by the ad serving party, from the vast XML. Nullable when absent from the VAST xml.
dealId
string
The ID of the Ads deal. Generally relates to Direct Sold Ad Campaigns. Nullable when absent from the VAST xml.
linear
boolean
Is the ad linear or not?
vastVersion
string
Version of VAST being reported from the tag
creativeUrl
string
The URL representing the VPAID or MP4 ad that is run
adId
string
Unique Ad ID - refers to the ‘attribute’ of the node within the VAST. Nullable when absent from the VAST xml.
universalAdId
string
Unique identifier for an ad in VAST4. Nullable when absent from the VAST xml.
creativeId
string
Ad server’s unique ID for the creative pulled from the ad tag’s XML. Should be used to specify the ad server’s unique identifier as opposed to the Universal Ad Id which is used for maintaining a creative id for the ad across multiple systems. Nullable when absent from the VAST xml.
creativeType
string
The MIME type of the ad creative currently being displayed
redirectUrl
string
the url to which the viewer is being redirected after clicking the ad. Nullable when absent from the VAST xml.
adPlacementType
number
The video placements per IAB guidelines. Enum list: In-Stream: 1, In-Banner: 2, In-Article: 3, In-Feed: 4, Interstitial/Slider/Floating: 5
waterfallIndex
number
Index of the current item in the ad waterfall
waterfallCount
number
The count of items in a given ad waterfall
adPodCount
number
the total number of ads in the pod
adPodIndex
number
The index of the currently playing ad within an ad pod
wrapperAdIds
array[string]
Ad IDs of the VAST Wrappers that were loaded while loading the Ad tag. The list returned starts at the inline ad (innermost) and traverses to the outermost wrapper ad. An empty array is returned if there are no wrapper ads.
time
number
The playback time in the ad when the event occurs, in seconds.
duration
number
Total duration of an ad in seconds
AD_COMPLETE
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
AD_BREAK_END
argument name
type
description
offset
string
Scheduled position in the video for the ad to play. For mid-rolls, will be the position in seconds as string. Other options: ‘pre’ (pre-roll), ‘post’ (post-roll), ‘api’ (ad was not scheduled)
PLAYLIST
argument name
type
description
playlistItemCount
number
The number of items in the current playlist
autostart
boolean
Whether or not the player is set to begin playing automatically.
PLAYBACK_REQUEST
argument name
type
description
playReason
string
wWy the play attempt originated. Options: ‘Unknown’ (Unknown reason:we cannot tell), ‘Interaction’ (A viewer interacts with the UI), ‘Auto’ (Autoplay based on the configuration of the player - autoStart), ‘autoOnViewable’ (autoStart when viewable), ‘autoRepeat’ (media automatically restarted after completion, without any user interaction), ‘Api’ (caused by a call on the player’s API), ‘Internal’ (started because of an internal mechanism i.e. playlist progressed to a recommended item)
AUTOSTART_BLOCKED
argument name
type
description
errorCode
number
The identifier of error preventing the media from rendering
errorMessage
string
Developer friendly description of the reason the error occurred.
sourceError
object
The underlying root Error which prevented the playback.
PLAY_ATTEMPT_FAILED
argument name
type
description
playReason
string
Why the play attempt originated. Options: ‘Unknown’ (Unknown reason:we cannot tell), ‘Interaction’ (A viewer interacts with the UI), ‘Auto’ (Autoplay based on the configuration of the player - autoStart), ‘autoOnViewable’ (autoStart when viewable), ‘autoRepeat’ (media automatically restarted after completion, without any user interaction), ‘Api’ (caused by a call on the player’s API), ‘Internal’ (started because of an internal mechanism i.e. playlist progressed to a recommended item)
errorCode
number
The identifier of error preventing the media from rendering
errorMessage
string
Developer friendly description of the reason the error occurred.
sourceError
object
The underlying root Error which prevented the playback.
CONTENT_LOADED
argument name
type
description
contentId
string
The unique identifier of the media item being rendered by the video player. Nullable when not provided by Publisher, or unknown.
contentUrl
string
The URL of the media source of the playlist item
title
string
The title of the content; not meant to be used as a unique identifier. Nullable when not provided by Publisher, or unknown.
description
string
The description of the content. Nullable when not provided by Publisher, or unknown.
playlistIndex
number
The currently playing media item’s index in the playlist.
contentTags
array[string]
Customer media level tags describing the content. Nullable when not provided by Publisher, or unknown.
PLAY
No additional params.
PAUSE
No additional params.
BUFFER
argument name
type
description
time
number
Playback position of the media in seconds
duration
number
Current media’s length in seconds
playbackMode
number
The current playback mode used by a given player. Enum list: vod: 0, live: 1, dvr: 2
TIME
argument name
type
description
position
number
Playback position of the media in seconds
duration
number
Current media’s length in seconds
SEEK_START
argument name
type
description
position
number
Playback position of the media in seconds, when the seek begins
destination
number
Desired playback position of a seek action, in seconds
duration
number
Current media’s length in seconds
SEEK_END
argument name
type
description
position
number
Playback position of the media in seconds, when the seek has ended
duration
number
Current media’s length in seconds
MUTE
argument name
type
description
mute
boolean
Whether or not the player is currently muted.
VOLUME
argument name
type
description
volumePercentage
number
The volume of the player, as a percentage
RENDITION_UPDATE
argument name
type
description
videoReportedBitrate
number
The bitrate of the currently playing video in kbps as reported by the Adaptive Manifest.
audioReportedBitrate
number
The bitrate of the currently playing audio in kbps as reported by the Adaptive Manifest.
encodedVideoWidth
number
The encoded width in pixels of the currently playing video rendition.
encodedVideoHeight
number
The encoded height in pixels of the currently playing video rendition.
videoFramerate
number
The current rate of playback. For a video that is playing twice as fast as the default playback, the playbackRate value should be 2.00
ERROR
argument name
type
description
errorCode
number
The identifier of the error preventing the media from rendering
errorMessage
string
Developer friendly description of the reason the error occurred.
sourceError
object
The underlying root Error which prevented the playback.
COMPLETE
No additional params.
PLAYLIST_COMPLETE
No additional params.
FULLSCREEN
argument name
type
description
fullscreen
boolean
Whether or not the player is currently in fullscreen
PLAYER_RESIZE
argument name
type
description
height
number
The height of the player in pixels
width
number
The width of the player in pixels
VIEWABLE
argument name
type
description
viewable
boolean
Is the player currently viewable?
viewabilityPercentage
number
The percentage of the video that is currently viewable on the user’s screen.
CAST
argument name
type
description
casting
boolean
Whether or not the current user is casting to a device
AUCTION_AD_LOAD_ATTEMPT
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
adUnitCode
string
Unique identifier that was used when creating the ad unit.
AUCTION_AD_LOAD_QUEUED
argument name
type
description
adTagUrl
string
The URL for the ad tag associated with the given ad event
adUnitCode
string
Unique identifier that was used when creating the ad unit.
AUCTION_AD_LOAD_ABORT
argument name
type
description
adUnitCode
string
Unique identifier that was used when creating the ad unit.
BID_IMPRESSION
argument name
type
description
bid
object
Information about the Bid which resulted in the Ad Impression
When an impression or error from an ad originating from a winning bid occurs, the bid will be automatically marked as used.
Limitations: the mechanism used to determine when an error occurred for an ad originating from a winning might fail at times when the ad server is GAM because of a limitation in GAM.
Bid request Enrichment
For your convenience, when an auction begins, the Video Module will update oRTB params in the auction for SSPs to consume and include in their bid requests.
adUnit.mediaTypes.video
The params in adUnit.mediaTypes.video are populated with information extracted from the player. Any param already filled by the publisher will remain unchanged.
Some params such as battr, minduration, maxduration are specific to a publisher’s preferences and should therefore be populated by the Publisher.
bidderRequest.ortb2.site.content
The params in bidderRequest.ortb2.site.content are populated with information extracted from the video player. Any params already filled by the publisher will remain unchanged.
This feature can be disabled by setting video.contentEnrichmentEnabled to false in the Prebid config.
In the case where multiple video players are registered with the Video Module, the bidderRequest.ortb2.site.content params will be updated by the video player registered to the ad unit in the auction. If one of the Video Players is responsible for rendering the main content on the page, it may be appropriate for the site.content params to be populated with metadata from that player; in such case, you should populate video.mainContentDivId in the Prebid config with the video player’s div id. |
SSPs
Before bids are requested, the Video Module automatically enriches the auction. SSPs can benefit from this by reading from the proper params.
Given that the video player is the source of truth for most video params, SSPs and DSPs can rely on the accuracy of the information.
mediaTypes.video
Before bids are requested, all ad units configured to be handled by the Video Module will be enriched. The adUnit’s mediaTypes.video param will be populated automatically.
SSPs wishing to benefit from this enrichment should read from mediaTypes.video.
bidderRequest.ortb2.site.content
Similarly, before bids are requested, the bidderRequest.ortb2.site.content param is populated in the bidderRequest argument of the buildRequests function with content metadata from the video player and its media.
SSPs wishing to benefit from this enrichment should read from bidderRequest.ortb2.site.content.
Contributing
The Prebid Video Module acts as a simple Video interface which Prebid can connect to. In order for the Video Module to plug into a Video Player, a video submodule must be implemented. The Video Submodule acts as a bridge between the Video Module and the Video Player.
To add a submodule please follow the instructions in How to add a video submodule.