Interface LinearAd

Represents a linear ad in the VAST specification.

interface LinearAd {
    adBreak: AdBreak;
    adSystem: undefined | string;
    clickThrough: undefined | string;
    companions: CompanionAd[];
    creativeId: undefined | string;
    duration: number;
    height: undefined | number;
    id: undefined | string;
    integration?: string;
    mediaFiles: MediaFile[];
    readyState?: AdReadyState;
    resourceURI: undefined | string;
    skipOffset: undefined | number;
    type: AdType;
    universalAdIds: UniversalAdId[];
    width: undefined | number;
}

Hierarchy (view full)

  • Ad
    • LinearAd

Properties

adBreak: AdBreak

The ad break which the ad is part of.

Remarks


- Available for VAST-ads.

adSystem: undefined | string

The source ad server information included in the ad response.

Remarks


- Available when the Ad.readyState is 'ready'.

clickThrough: undefined | string

The website of the advertisement.

Remarks


- Available when the Ad.readyState is 'ready'.

companions: CompanionAd[]

List of companions which can be displayed outside the player.

Remarks


- Available when the Ad.readyState is 'ready'.
- Only supported for 'theo' and 'google-dai'.

creativeId: undefined | string

The identifier of the selected creative for the ad.

Remarks


- Available when the Ad.readyState is 'ready'.

duration: number

The duration of the ad, in seconds.

Remarks


- Available when the Ad.readyState is 'ready'.

height: undefined | number

The height of the ad.

Remarks


- Available when the Ad.readyState is 'ready'.

id: undefined | string

The identifier of the creative.

Remarks


- Available when the Ad.readyState is 'ready'.

integration?: string

The integration of the ad, represented by a value from AdIntegrationKind or the identifier of a custom integration added with Ads.registerServerSideIntegration.

Default Value

'theo'

mediaFiles: MediaFile[]

List of media files which contain metadata about ad video files.

readyState?: AdReadyState

The ready state of the ad.

resourceURI: undefined | string

The URI of the ad content.

Remarks


- Available when the Ad.readyState is 'ready'.

skipOffset: undefined | number

Offset after which the ad break may be skipped, in seconds.

Remarks


- Available when the Ad.readyState is 'ready'.
- If the offset is -1, the ad is unskippable.
- If the offset is 0, the ad is immediately skippable.
- Otherwise it must be a positive number indicating the offset.

type: AdType

The type of the ad.

universalAdIds: UniversalAdId[]

The list of universal ad ID information of the selected creative for the ad.

Remarks


- Only supported for 'theo' and 'google-ima'.

width: undefined | number

The width of the ad, in pixels.

Remarks


- Available when the Ad.readyState is 'ready'.