Video Advertising Suite

Docs

> Documentation-Index

Classes

AdSlotAPI

Typedefs

AdBreak : AdBreak

Definition of the upcoming ad slot.

EnvironmentVars : EnvironmentVars

Used for passing implementation-specific runtime variables.

Wrapper : Array

List of URLs that have been requested during a chain of ad server requests.

UniversalAdID : UniversalAdID

A unique creative ID for the ad across multiple systems.

PublicAdSlot : PublicAdSlot

Collection of data that describes the current ad slot.

PublicAd : PublicAd

Collection of data for the current running ad

AdInfo : AdInfo

Collection of data that describes the current video ad.

AdError : AdError

Description object of the most recent ad error or null.

Wrapper : Wrapper

Description object of a AdTag request.

CompanionAd : CompanionAd

Secondary ads included in the VAST tag that accompany the video ad.

CompanionAdResource : CompanionAdResource

Definition of a secondary ad by type.

Extension : Extension

Custom XML element that extends the video ad.

ClosedCaption : ClosedCaption

Subtitle files for the current creative in different languages

AdVerification : AdVerification

Object contains the executable and bootstrapping data required to run the measurement code for a single verification vendor.

PluginError : PluginError

Description object of the most recent error or null.

AdSlotAPI

Kind: global class

adSlotAPI.ad ⇒ PublicAd

Returns information about the current ad, like companions, icons, verifications and more.

Kind: instance property of AdSlotAPI
Returns: PublicAd - Represents static information about the current ad

adSlotAPI.adSlot ⇒ PublicAdSlot

Returns information about the current ad-break, like times and more.

Kind: instance property of AdSlotAPI
Returns: PublicAdSlot - Represents static information about the current ad-break

adSlotAPI.error ⇒ PluginError

Requests details about the most recent error that has occurred on the smartclientcore.

Kind: instance property of AdSlotAPI
Returns: PluginError - Description object of the most recent error or null.

adSlotAPI.rawXML ⇒ String

Returns the XML representation of the entire ad slot.

Kind: instance property of AdSlotAPI
Returns: String - XML as live parsable DOM representation, querySelector and similar work on this

adSlotAPI.dispose()

Removes all event listeners.

Kind: instance method of AdSlotAPI

adSlotAPI.initAdSlot(adBreak, environmentVars)

Invokes a commercial break by requesting the specified ad setup from the ad server.

Kind: instance method of AdSlotAPI

Param Type Description
adBreak AdBreak Configuration for the upcoming ad break.
environmentVars EnvironmentVars Defines environment conditions for the upcoming ad break

adSlotAPI.startAdSlot()

Starts the ad break. The add-on responds by sending an ON_AD_SLOT_START event notifying the video player the ad break is going to start.

Kind: instance method of AdSlotAPI

adSlotAPI.stopAdSlot()

Stops a running ad break. The add-on responds by sending an ON_AD_SLOT_COMPLETE event notifying the video player it has closed and cleaned up ad resources. Also the content of the video player has been reset.

Kind: instance method of AdSlotAPI

adSlotAPI.skipAd()

Skips (stops) a running single ad The add-on responds by sending the ON_AD_SKIPPED event notifying the video player it has closed and cleaned up a single ad.

_Note: The add-on does proceed with the next ad. Canceling the whole ad break requires calling stopAdSlot() instead.

Kind: instance method of AdSlotAPI

adSlotAPI.resize(size)

Following a resize of the video player, the video player calls resize() to allow the add-on to scale and reposition itself within the display area. The add-on responds by sending an ON_AD_SIZE_CHANGED event.

Kind: instance method of AdSlotAPI

Param Type Description
size ElementSize The video content display as a Rectangle and current viewing mode (normal, fullscreen, thumbnail, dynamic)

adSlotAPI.clickThrough(playerHandles) ⇒ String

Following a click on the ad, the video player calls clickThrough() to allow the add-on to request the advertisers landing page and call the ClickThru tracking requests.

Kind: instance method of AdSlotAPI
Returns: string - The landing page URL.

Param Type Default Description
playerHandles Boolean false Whether the player takes responsibility for opening the landing page URL. Defaulting to false if omitted.

adSlotAPI.iconClickThrough(iconProgram, playerHandles) ⇒ String

Following a click on an Industry Icon ad, the video player calls iconClickThrough() to allow the add-on to request the advertisers landing page and call the ClickThru tracking requests.

Kind: instance method of AdSlotAPI
Returns: String - The landing page URL.

Param Type Default Description
iconProgram String The program represented in the icon
playerHandles Boolean false Whether the player takes responsibility for opening the landing page URL. Defaulting to false if omitted.

adSlotAPI.iconView(iconProgram)

The view tracking for icons is used to track when the icon creative is displayed.

Kind: instance method of AdSlotAPI

Param Type Description
iconProgram string The program represented in the icon

adSlotAPI.verificationNotExecuted(vendor, reason)

The player did not or was not able to execute the provided verification code.

Kind: instance method of AdSlotAPI

Param Type Description
vendor String An identifier for the verification vendor.
reason Number The reason code corresponding to the cause of the failure.

adSlotAPI.companionView(companionId)

Requests the view trackers when a creative resource is displayed. The method should be called for each resource file of a Companion Ad.

Kind: instance method of AdSlotAPI

Param Type Description
companionId String Value of the id attribute from the CompanionAd object.

adSlotAPI.companionClickThrough(companionId, playerHandles) ⇒ string

Following a click on a Companion ad, the video player calls companionClickThrough() to allow the add-on to call the ClickThru tracking requests and request the advertisers landing page (most likely with StaticResource creative resource only).

Kind: instance method of AdSlotAPI
Returns: string - The landing page URL.

Param Type Default Description
companionId String Value of the id attribute from the CompanionAd object.
playerHandles Boolean true Whether the player takes responsibility for opening the landing page URL. Defaulting to true since most companion creatives do handle clickthroughs by their own (HTMLResource, IFrameResource).

adSlotAPI.pauseAd()

Pauses the current ad break. The add-on responds by sending the ON_AD_PAUSED event.

Kind: instance method of AdSlotAPI

adSlotAPI.resumeAd()

Resumes the current ad break. The add-on responds by sending the ON_AD_PLAYING event.

Kind: instance method of AdSlotAPI

AdBreak : AdBreak

Definition of the upcoming ad slot.

Kind: global typedef
Properties

Name Type Description
type string of the ad slot. See AdBreak.type Defaulting to linear.
adBreakPosition number of the ad slot. See AdBreak.adBreakPosition
tag string AdRequest URL
response string direct VAST XML
opener string
bumper string
closer string

EnvironmentVars : EnvironmentVars

Used for passing implementation-specific runtime variables.

Kind: global typedef
Properties

Name Type Description
desiredBitrate number Indicates the desired bitrate in kilobits per second (kbps). The player uses this information to select Mediafiles with an appropriate bitrate. Defaulting to null.
desiredMimeTypes [ 'Array' ].<string> Declaration of accepted media types. Defaulting to types that the browser eventually is able to play. Types must be compliant with the IANA Media Type standard
desiredVPAIDVendors [ 'Array' ].<string> Declaration of accepted VPAID vendors (whitelist). Each specified String has to represent an unique identifier that can be found within the creative media file URL, most likely the domain name. If omitted, the plugin tries to deliver VPAID creatives from each vendor.
deviceType string Can be either mobile, tablet, desktop or tv. Defaulting to null.
deviceScreenSize Dimension Maximum size we can achieve when entering fullscreen.
networkReachability string Can be either wan, wifi or unreachable. Defaulting to null.
macro Object as defined by the VAST 4.1 specification.
vastMacroValues Object See EnvironmentVars.macro.
prefetchBuffetAds boolean In order to replace invalid ads in a pod instantly at runtime, buffet ads from wrapper responses must be loaded up-front. prefetchBuffetAds determines whether stand-alone ads (buffet) will be loaded together with the pod of ads or not. Defaulting to false if omitted.
adContainer HTMLElement The element that should be used to deliver non-video creative files. Defaulting to null if omitted.

Wrapper : Array

List of URLs that have been requested during a chain of ad server requests.

Kind: global typedef

UniversalAdID : UniversalAdID

A unique creative ID for the ad across multiple systems.

Kind: global typedef
Properties

Name Type Description
idRegistry string A string used to identify the URL for the registry website where the unique creative ID is cataloged. Defaulting to unknown.
idValue string A string identifying the unique creative identifier. Defaulting to unknown.

PublicAdSlot : PublicAdSlot

Collection of data that describes the current ad slot.

Kind: global typedef
Properties

Name Type Description
currentClip number Index of the current ad, regardless of its variant.
totalClips number Total number of ads within the current ad break, regardless of variants.
currentCommercial number Index of the current ad of variant COMMERCIAL. Defaulting to -1
totalCommercials number Total number of ads with variant COMMERCIAL within the current ad break
totalCommercialsDuration number Total duration of ads with variant COMMERCIAL within the current ad break
totalCommercialsCurrentTime number Current time of all ads with variant COMMERCIAL within the current ad break

PublicAd : PublicAd

Collection of data for the current running ad

Kind: global typedef
Properties

Name Type Description
isExpanded Boolean Indicates if the ad is currently in a expanded state
isInteractive Boolean Returns whether the current ad is interactive (most likely by using VPAID) or * not.
isLinear Boolean Indicates whether the ad’s current mode of operation is linear or non-linear.
isSkippable Boolean If true, the ad can be skipped, based on AdTag skip delay and configurable skipp offset. Changes of the state can be monitored by listening on ON_AD_SKIPPABLE_STATE_CHANGE
skipOffset Number Time in seconds when ad will become skippable based on playback progress. Will return -1 if ad won't become skippable.
hasClickThrough Boolean Returns whether the current ad has a ClickThrough target (URL) or not.
width Number Width of the ad in pixels, as given from AdTag
height Number Height of the ad in pixels, as given from AdTag
currentTime Number Current time of ad in seconds
remainingTime Number Remaining time of ad in seconds
duration Number Duration of current ad, given in seconds
volume Number get and set volume of the current running ad
companions Array<CompanionAd> The value of this property is an Array that provides ad companion details for each <Companion> element. The video player should request this value whenever it receives the ON_COMPANIONS_DETECTED event.
extensions Array<Extension> The value of this property is an Array that provides ad extension details for the <Extensions> element. The video player should request this value whenever it receives the ON_EXTENSIONS_DETECTED add-on event.
icons [ Array<Icon> The value of this property is an Object that provides ad icon details for the <Icon> element. The video player should request this value whenever it receives the ON_ICONS_DETECTED add-on event.
closedCaptions Array<ClosedCaption> The value of this property is an Array of caption details for the <ClosedCaption> element. The video player should request this value whenever it receives the ON_CLOSED_CAPTIONS_DETECTED add-on event.
verifications Array<AdVerification> The value of this property is an Array that provides details for each <Verification> element. The video player may request this value whenever it receives the ON_VERIFICATIONS_DETECTED add-on event, depending on whether the player takes care of the Open Measurement.
info Array<AdInfo> Collection of data that describes the current video ad.
error Array<AdError> Description object of the most recent ad error.
wrappers Array<Wrapper> List of Wrapper objects, starting with the initial request up to the last requested tag URI.

AdInfo : AdInfo

Collection of data that describes the current video ad.

Kind: global typedef
Properties

Name Type Description
adId String Value of the id attribute from the VAST > Ad node
title String Value of the VAST > Ad > AdTitle node
variant String Ad variant, depending on the current schedule and VAST manifest.
skippable Boolean The default value for this property is false. When the ad reaches a point where it can be skipped, the ad unit updates this property to true and sends the ON_AD_SKIPPABLE_STATE_CHANGE event. The video player can check this property at any time, but should always check it when the ON_AD_SKIPPABLE_STATE_CHANGE event is received.
duration Number Total time of the current ad
currentTime Number Current time of the current ad
universalAdID UniversalAdID A unique creative identifier that is maintained across different ad systems.

AdError : AdError

Description object of the most recent ad error or null.

Kind: global typedef
Properties

Name Type Description
code Number Code according to Ad Error - Codes Table Error Codes Table.
timestamp Number Current client time Date.now()
description String A human-readable string which provides specific diagnostic information to help the reader understand the error condition which occurred.

Wrapper : Array

Description object of a AdTag request.

Kind: global typedef
Properties

Name Type Description
url String Tag URI
loadStart String Current client ISO time when starting the request.
loadEnd String Current client ISO time after receiving the response.
loadTime Number Time in milliseconds between loadStart and loadEnd

CompanionAd : CompanionAd

Secondary ads included in the VAST tag that accompany the video ad.

Kind: global typedef
Properties

Name Type Description
id String Value of the id attribute from the Creative > CompanionAds > Companion node
companionXML String Full node.
resources Array<CompanionAdResource> The companion ad may contain one or more resources to represent different versions of the creative for use in different environments. The media player can choose which resource to use when more than one resource file is provided.

CompanionAdResource : CompanionAdResource

Definition of a secondary ad by type.

Kind: global typedef
Properties

Name Type Description
type String Type of the companion creative resource. Can be either StaticResource, IFrameResource or HTMLResource
resource String The asset URL to be loaded.

Extension : Extension

Custom XML element that extends the video ad.

Kind: global typedef
Properties

Name Type Description
type String The MIME type of any code that might be included in the extension. Type should be compliant with the IANA Media Type standard
extensionXML XML Full node.

ClosedCaption : ClosedCaption

Subtitle files for the current creative in different languages

Kind: global typedef
Properties

Name Type Description
fileURL String URL to the subtitle file
type String MIME type of the offered file
language String Language of the file that is provided

AdVerification : AdVerification

Object contains the executable and bootstrapping data required to run the measurement code for a single verification vendor.

Kind: global typedef
Properties

Name Type Description
vendor String An identifier for the verification vendor.
verificationParameters String Information intended for bootstrapping the verification code and providing metadata about the current impression. The format of the string is up to the individual vendor.
javascriptResource JavascriptResource Object with url, apiFramework and browserOptional
tracking Array Array of single tracking elements, e.g. verificationNotExecuted.

PluginError : PluginError

Description object of the most recent error or null.

Kind: global typedef
Properties

Name Type Description
code Number A number which represents the general type of error that occurred.
timestamp Number Current client time Date.now()
message String A human-readable string which provides specific diagnostic information to help the reader understand the error condition which occurred.