Implementing a tag-based video solution for Ad Exchange demand without the use of the IMA SDK is a beta offering and might not be available for your network. You can contact your account manager for more information.
The following is a subset of the VAST ad tag URL parameters. These parameters are required for tag-based video solutions for app when not integrating with the IMA SDK.
See the list of required parameters for web or the recommended parameters for Programmatic monetization.
Jump to a specific parameter in the list
rdid sz unviewed_position_start url wta
|
Parameter | Details | |
---|---|---|
correlator
(Correlator) |
The correlator parameter accepts a variable value that is shared by multiple requests coming from the same page view. It's used to implement competitive exclusions, including those in cookieless environments. If the IMA SDK is used, the correlator value is set automatically. If your player attempts to set this value, the SDK overwrites it with its own value. If the IMA SDK is not used, ensure that you set this value to a truly random, positive, integer value that is not being reused by multiple page views. Usage example
RequirementRecommended for Programmatic monetization |
|
description_url
(Description URL) |
The description URL parameter accepts a variable value that should describe the video playing on the page. Outline the page with 1-3 paragraphs describing the content. For example, stitch together the The This parameter is not set automatically by the IMA SDK. It needs to be set manually. Usage exampleURL-encoded: Non-encoded: RequirementRequired for web, app, and Ad Exchange Recommended for Programmatic monetization |
|
env
(Environment) |
The environment parameter accepts a constant value that indicates an in-stream request, or that the request is specifically from a video player. Possible values are Usage exampleVideo and/or audio: Video only: Requirement |
|
gdfp_req
(Ad Manager schema indicator) |
||
iu
(Ad unit) |
||
msid
(App ID) an
(App name) |
The app ID and app name parameters accept variable values which should be applied to requests sent from mobile app and connected TV devices, as most programmatic video ads require them. The IMA SDK will automatically populate both parameters, but they must be manually specified in non-SDK environments, including direct VAST calls, or when using Programmatic Access Library (PAL) or Publisher Authenticated Inventory (PAI). While the app name should be a human-readable name, on iOS and tvOS, it's not possible for the SDK to access the app ID. In these cases, the Usage example
App IDs are named and formatted differently across different app stores. See the IAB guidelines for app identification, or examples of common unique identifiers. For platforms where an app store does not exist, the IAB recommends publishers use the following format for store IDs: RequirementBoth parameters are required for app Recommended for Programmatic monetization |
|
output
(Ad output format) |
The ad output format parameter accepts a constant value which should be set to the output format of ad. Use For VAST, if your video player uses the IMA SDK, the output parameter for a video ad request will always be set to Use Usage exampleYour network's default VAST setting: VAST 4: Your network's default VMAP setting: VMAP 1: VMAP 1, returning VAST 4: Requirement |
|
pvid
(App set ID) pvid_s
(App set scope) |
The app set ID values are needed for monetization when users opt out of personalization on Android devices. The While the IMA/PAL SDK automatically passes this field, publishers with non-SDK implementations must call the app set SDK and pass these parameters manually on ad request. See the Android documentation on how to retrieve the app set ID. Usage example
RequirementRequired for app Recommended for Programmatic monetization |
|
rdid
(Resettable device identifiers) |
The resettable device identifiers accept variable values. With built-in applications (not on web or mobile web), the SDK passes resettable device identifiers for user targeting into your stream requests with the parameters for Nearly all programmatic video ads require the presence of these values.
Usage exampleSee detailed examples of resettable device identifiers. RequirementRequired for app Recommended for Programmatic monetization |
|
sz
(Size) |
The size parameter accepts a variable value which should be set to the size of master video ad slot. Multiple sizes should be separated by the pipe ( Do not include " Usage example
RequirementThis parameter is optional if only requesting |
|
unviewed_position_start
(Delayed impressions) |
||
url
(URL) |
The URL parameter accepts a variable value which should be set to the full URL from which the request is sent. This value is needed to help buyers identify and understand the context of where this request is coming from. To the extent possible, this value should be dynamically populated on the ad request. On a web page, this is the URL of the page that displays the video player. If you use the IMA SDK, the URL value is set automatically. If your player sets this value, the IMA SDK will respect the value being set. In an app (mobile or CTV), this value should be set to a URL that most accurately represents the video or audio inventory being monetized. For instance, if the user is watching a video within a mobile app that is also available on a desktop equivalent URL.* The value of this parameter should be encoded. Usage example
* For apps, if it is not possible to set this parameter to a variable URL value, it's recommended that it be set with the following pattern: RequirementRecommended for Programmatic monetization |
|
wta
(Why this ad) |
The "Why this ad?" parameter accepts a constant value which indicates the video player's support for rendering ad badging. When no The ad badging functionality is supported automatically when using the IMA SDK. When the IMA SDK is not used, video players must implement VAST Publishers are required to send Audio ad requests may send For traffic from the EEA, requests with Ads must comply with applicable regulatory requirements for ads served in the European Economic Area (EEA). This includes a mechanism for users to report illegal content. Publishers must notify Google of any illegal content reports using the appropriate form. Usage exampleSupported:
Unsupported: RequirementRequired for Ad Exchange Required for web and app EEA traffic Recommended for Programmatic monetization |