Salesforce

VAST video redirect

« Go Back
Information
VAST video redirect
VAST-Wrapper-script-templates
Details
User-added image

Summary

Overview
Demo
Creative template parameters
Features
Limitations
Known issues
Release notes

Overview

Formerly named "[VIDEO] VAST x - WRAPPER LINEAR". The "VAST video redirect" creative template displays a linear VAST video ad hosted in a remote, third party system/platform.

Demo

Check out Equativ’s video showcase to set up parameters and retrieve video ads.

Creative template parameters

NameDescriptionDefault valueVAST
2.0*
VAST
3.0*
VAST
4.x*
Is ad conditionalIn case of programmatic video ad serving, a VPAID ad unit might be used to decide whether there is an ad that matches the placement. When there is no match, an ad may not be served.
With this parameter, publishers can avoid accepting these ads in placements where an ad must be served.
A value of true indicates that the ad is conditional and should be used in all cases where the inline executable unit (such as VPAID) is not an ad but is instead a framework for finding an ad.
A value of false indicates that an ad is available.
false
Multiple ads allowed in requested VAST responseA Boolean value that indicates if multiple ads are allowed in the requested VAST response. If true, both pods and stand-alone ads are allowed. If false, only the first stand-alone Ad (with no sequence values) in the requested VAST response is allowed.false
Use fallback if wrapper returns no adA Boolean value that provides instructions for using an available passback ad when the wrapper ad returns no ad.
If true, the video player will select from any stand-alone ads available to try to replace the wrapper ad.
If false and the wrapper represents an ad in a pod, the video player will move on to the next ad in the pod.
If not specified, the video player can follow through at its own discretion where no-ad responses are returned.
not specified
Follow additional wrappersA Boolean value that indicates if subsequent wrappers after a requested VAST response are allowed. If false, any Wrappers received (i.e. not an Inline VAST response) will be ignored. Otherwise, VAST Wrappers received will be accepted.true
URLs for custom impressionsA single custom impression URL or a list of custom impression URLs. Use "||" as a separator. 
Custom click-tracking for main creativeA custom tracking URL fired when a click occurs on the main creative (linear or non-linear). You can provide a single custom click-tracking URL or a list of custom click-tracking URLs. Use "||" as a separator. 
URLs for custom errorsAn optional, custom error URL that will be placed in the <Error> node of the VAST response. Starting from VAST 4.x, several URLs can be provided using the "||" separator. 
Progress offsetAvailable formats: "HH:MM:SS" / "HH:MM:SS.mmm" / "n%”. 
Custom VAST impression-tracking for viewableA custom tracking URI that the video player will trigger at the time the criteria for a viewable impression are met. Several URLs can be provided using the "||" separator (no white spaces). 
Custom VAST impression-tracking for notViewableA custom tracking URI that the video player will trigger if the ad is executed but does not meet the criteria for a viewable impression.  Several URLs can be provided using the "||" separator (no white spaces). 
Custom VAST impression-tracking for viewUndeterminedA custom tracking URI that the video player should trigger if it cannot determine whether the criteria for a viewable impression are met. Several URLs can be provided using the "||" separator (no white spaces). 
Verification vendorAn identifier for the verification vendor.
Note: add the vendor name if you want the AdVerifications node to be included in a VAST response file.
 
JavaScriptResource's apiFramework and URLValues of the apiFramework attribute and the URL of the JavaScriptResource element. The values should be provided in the following pattern:
apiFramework, URL.
 
ExecutableResource's apiFramework, type and URLValues of the apiFramework and type attributes together with the URL of the ExecutableResource element. The values should be provided in the following pattern:
apiFramework, type, URL.
 
Verification Tracking URLs

A reporting URL for the verificationNotExecuted event. Several URLs can be provided by using the "||" separator (no white spaces).

 
Verification parameters

A string intended for bootstrapping the verification code and providing metadata about the current impression.

 
Custom VAST Tracking for VAST [tracking_event]

A custom reporting URL for the VAST [tracking_event]. Several urls can be provided using the "||" separator.
You can find a list of the <TrackingEvent>s available in VAST 2.0, VAST 3.0 or VAST 4.x specifications.

 
Use publisher's skipoffsetIf true, Equativ's VAST plugin will use the skip policy defined in the plugin configuration. Publishers can make all the ads non-skippable or skippable after the same delay.
If false, the skip policy defined by the publisher (plugin configuration) will be ignored.
For linear ads in version VAST 3.0 and later, the skip-offset defined in the VAST will be used. The VAST 2.0 linear ads will be non-skippable.
true
Set skipoffsetIf true, enables overriding the skipoffset of the wrapped VAST document through the next parameter below.
If false, the skipoffset of the final VAST document will not be edited and the next parameter below will not be taken into account.
 
SkipoffsetThe duration before the user can skip this ad. This setting will override the wrapped VAST's skip policy. Leave empty if you want the ad to be non-skippable.
Available formats: "HH:MM:SS" / "HH:MM:SS.mmm" / "n%".
When using Equativ Video Plugin or SDKs, this setup can be overwritten by the publisher configuration depending on the value of “Use publisher’s skipoffset” parameter.
 
ID (advEntityId) provided by IASDedicated ID (advertisingEntityId) used in Video Ad Network Solution (VANS) provided by Integral Ad Science (IAS). This ID is used when integrating the Firewall (FW) solution dedicated to advertisers/agencies. FW technology can block the ad's display if the impression does not respect brand-safety thresholds and fraud criteria defined for this campaign in the VANS interface. For more information refer to Integralads.
Both advEntityId and pubEntityId are required in FW integration.
 
ID (pubEntityId) provided by IASDedicated ID (pubEntityId) used in Video Ad Network Solution (VANS) provided by Integral Ad Science (IAS). This ID is used when integrating the Firewall (FW) solution dedicated to advertisers/agencies. FW technology can block the ad's display if the impression does not respect brand-safety thresholds and fraud criteria defined for this campaign in the VANS interface. For more information refer to Integralads.
Both advEntityId and pubEntityId are required in FW integration.
 
* Indicates in which VAST version the given parameter is available; see also "VAST version management" below 


Features

CORS Compliancy

Wrappers and all subsequent wrappers must be CORS compliant; CORS compliancy is part of the IAB standard

VAST version management

The "VAST video redirect" creative template supports all VAST versions. For proper VAST version management, it is mandatory that the publisher's player passes the highest VAST version it supports in the ad request, using the out= parameter. Based on the passed VAST version, the creative template will automatically leverage only the parameters supported by the given version. Possible values of the out parameter:
  • out=vast2
  • out=vast3
  • out=vast4
  • out=vast4.1
  • out=vast4.2

Limitations

URLs pasted into any of the Custom Tracker fields (available on the VAST trackings tab on the creative's side panel) are not compatible with the  VAST video redirect creative template, i. e. these URLs are not triggered if the  VAST video redirect template is used. 
User-added image

Known issues

n/a

Release notes 

  • 13-09-2023 - removed "Duration" parameter
  • 02-08-2023 - replace Smart by Equativ in AdSystem node
  • 29-06-2023 - replace [sas_smartBaseUrl] with [sas_pixelDomain]
  • 19-04-2023 - rolled back last change
  • 19-04-2023 - removed wrapped_vast and duration parameters. VAST URL is now uploaded directly into the Creative Section of the insertion.
  • 02-03-2023 - added vastResponseType meta parameter
  • 14-02-2023 - highlight duration parameter and make it required
  • 05-10-2022 - removed "Use custom VAST metrics" checkbox
  • 12-08-2022 - added VAST version management
  • 21-07-2020 - added AdVerifications node parameters

Powered by