Follow

Twitter Pre-Roll VAST Specs

General Info

  • Supported formats include VAST 3.0 & 2.0
  • All URIs (VAST URI, VAST Redirect URI, Impression/Error/Tracking URIs) must use https
  • Server-side VAST request and beaconing
    • Additional information can be passed through supported macros in Impression, Tracking and Error callbacks: 

Macro

Description

%%TRUNCATED_IP%%

IP of the user with last octet truncated. Eg. 192.168.0 

  • Vast Wrappers supported.
    • Max 1 redirect.
  • Survey elements are ignored.
  • <VideoClicks> elements are ignored.
  • Icons (and therefore IconClicks & IconViewTracking) are ignored.
  • Ad formats supported:
    • Linear Ads
    • Skippable Ads (skipOffset is ignored in favor of Twitter’s skip behavior)
  • Ad formats not supported:
    • Companion Ads
    • Non-linear Ads
    • Ad Pods
  • Regardless of the ad format (Linear or Skippable), Twitter does not show a skip button if ad is < 7s, and always shows a skip button at 0 seconds if ad >= 7s. The maximum duration allowed is 10 minutes.
  • Static images for linear creative are not supported.
  • Every VAST response must contain a Linear or Skippable ad.
  • Minimum Required Video Variants
  • TBD

Supported Tracking Events

Event Name

creativeView

start

firstQuartile

midpoint

thirdQuartile

complete

twitter_view (Custom view definition. 3 seconds at 100% viewability)

mrc_view (Custom view definition. 2 seconds continuous at 50% viewability)

Error codes

Code

Description

Supported?

100

XML parsing error

yes

101

VAST schema validation error

yes

102

VAST version of response not supported

yes

200

Trafficking error. Video player received an Ad type that it was not expecting and/or cannot display

yes

201

Video player expecting different linearity.

yes

202

Video player expecting different duration.

No (we do not have duration requirements)

203

Video player expecting different size

no

300

General Wrapper error

Yes (will be sent for non-whitelisted redirects).

301

Timeout of VAST URI provided in Wrapper element, or of VAST URI provided in a subsequent Wrapper element. (URI was either unavailable or reached a timeout as defined by the video player.)

yes

302

Wrapper limit reached, as defined by the video player. Too many Wrapper responses have been received with no InLine response.

yes

303

No Ads VAST response after one or more Wrappers.

yes

400

General Linear error. Video player is unable to display the Linear Ad.

yes

401

File not found. Unable to find Linear/MediaFile from URL.

No. Supported in the future.

402

Timeout of MediaFile URI.

No. Supported in the future.

403

Couldn’t find MediaFile that is supported by this video player, based on the attributes of the MediaFile element.

yes

405

Problem displaying MediaFile. Video player found a MediaFile with supported type but couldn’t display it. MediaFile may include: unsupported codecs, different MIME type than MediaFile@type, unsupported delivery method, etc

yes

5XX

Non-Linear Ads errors

No (Non-Linear Ads not supported).

6XX

Companion Ads errors

No (Companion Ads are not supported).

900

Undefined Error

yes

901

General VPAID error.

No (VPAID not supported).

VAST Macros

Macro

Description

Supported?

ERRORCODE

Error codes, reserved for error tracking URIs.

yes

CONTENTPLAYHEAD

Replaced with current time offset of the video content.

no

CACHEBUSTING

Replaced with a random 8-digit number

yes

ASSETURI

Replaced with the URI of the ad asset being played

no

 

Comments

Powered by Zendesk