Search
Clear search
Close search
Google apps
Main menu

Create a master video tag manually

A master video tag is a URL used by a video player to retrieve video ads. To assemble a master video tag using the correct URL parameters, refer to the tables below. Once you've assembled the tag, you can test it with the VAST suite inspector.

See sample master video tags
https://pubads.g.doubleclick.net/gampad/ads?
env=vp&
gdfp_req=1&
output=vast&
iu=/6062/video-demo&
sz=400x300&
unviewed_position_start=1&
ciu_szs=728x90,300x250

You can also review and test using these sample DFP Video tags.

Jump to a specific parameter in the list


Required parameters               
correlator
description_url
env
gdfp_req
iu
output
sz
unviewed_position_start
url
Optional parameters                
ad_rule
ciu_szs
cmsid | vid
cust_params
hl
msid | an
nofb
pp
ppid
rdid | idtype | is_lat
scp
tfcd
Custom SDK parameters
excl_cat
lip
max_ad_duration | min_ad_duration
mridx
pmad
pmnd | pmxd
pod
ppos
scor
vad_type
vpos
Ad tags for live stream video must contain /live in their path to ensure the ability to handle heavy live stream traffic volumes, where all ad breaks are delivered at the same time.

Live stream tags appear as https://pubads.g.doubleclick.net/gampad/live/ads...

DFP Video supports both https and http. The impressions and VAST tracking URLs respect the SSL setting and will return either https or http as appropriate. Click-through and click-tracking are http since it redirects from another page.

Required parameters

The following parameters are required for all master video tags. Each of these parameters has a constant value. For example, the env parameter always equals vp to indicate that the request is from a video player.

Parameter Description Value
env Indicates that the request is from a video player. vp
gdfp_req Indicates that the user is on the DFP schema and is not a legacy Google Ad Manager (GAM) publisher. 1
unviewed_position_start Setting this to 1 turns on delayed impressions for video. 1

Required parameters with variable values

The following parameters are required for all master video tags. These parameters have variable values, so please refer to the description and sample values for guidance.

Parameter Description Sample value
output

Output format of ad. Use output=vast for the VAST version (e.g., VAST 3) you have enabled for your network. For specific ad tags or parts of your site, you can explicitly ask for VAST 3 with output=xml_vast3, VAST 2 with output=xml_vast2, or VMAP 1 with output=xml_vmap1.

Use output=vmap to return the default VMAP version (e.g., VMAP 1) you have enabled for your network.

vast (for your network's default VAST setting)
xml_vast2 (for VAST 2)

vmap (for you network's default VMAP setting)
output=xml_vmap1 (for VMAP1)

iu Current ad unit. Follows the format:

/network_id/.../ad_unit

/6062/videodemo
sz

Size of master video ad slot. Multiple sizes should be separated by the pipe (|) character.

Do not include "v" after the size.

400x300

description_url

The value should describe the video playing on the page. Usually, it's the page that houses the video player, but could also be a page with text that describes the video. 

You must always url-encode description_url on web page video players.

You should send non-encoded description_url values from mobile in-app video players.

This field is required if you use Ad Exchange. Learn more

URL-encoded example:
http%3A%2F%2Fwww.sample.com%2Fgolf.html

Non-encoded example:
http://www.sample.com/golf.html

url

This is the full URL from which the ad request is being sent. On a web page, this is the URL of the page that displays the video player. In an app, this is the package name.

If you use the IMA SDK, it sets the URL value automatically. If your player sets this value, the IMA SDK overwrites it and set its own value. 

http://www.videoad.com/golf.html
correlator

A random positive number, typically the timestamp of the page view, that's shared by multiple requests coming from the same page view. 

Correlator is used to implement competitive exclusions, including in cookieless environments. 

If you use the IMA SDK, it sets the correlator value automatically. If your player sets this value, the IMA SDK overwrites it and set its own value. 

4345645667

back to top 

Optional parameters

The following parameters are optional. These parameters have variable values, so please refer to the description and sample values for guidance.

Parameter Description Sample value
ad_rule 

Indicates whether to return a creative or an ad rules response.

Learn more about ad rules.

ad_rule=0 to indicate a request for a creative "VAST"
ad_rule=1 to indicate a request for an ad rules "VMAP"
ciu_szs Comma-separated list of companion sizes 728x90,300x250

cmsid
vid

In order to target ads to video content, your master video tag needs to include both cmsid and vid.  

The cmsid is a unique number for each content source. To find it, on the Video tab in DFP, click Content sources and then the name of the content source.

The vid is a string or number identifying a particular piece of video content. This ID is assigned by the CMS that hosts your content. To find it, on the Video tab in DFP, click Content and then the specific content from the list.

cmsid=[value]&vid=[value]

If you are building a tag for Dynamic Ad Insertion with video on demand, you should use the DFP tag macros that will dynamically insert the correct cmsid and vid: &cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

cust_params Key-value parameters Learn how to add key-value pairs to an ad tag.
hl The language code used to request ads in that language. Used for language of ad selection and video ad rendering in dynamic allocation to video in the AdExchange or AdSense Video. The language can be any ISO 639-1 (two-letter) or ISO 639-2 (three-letter) code. Defaults to English (en). See a list of valid codes. it
msid
an

These two parameters should be applied to all requests sent from mobile app and connected TV devices. The msid parameter is the app ID and should be used in direct VAST calls to Google where the IMA SDK is not used. The an parameter is the app name.

Most programmatic video ads require the presence of both of these values on requests from mobile app or connected TV inventory.

msid=com.package.publisher, an=sample%20app
nofb

Indicates whether your ad request should not return a playlist of "video fallback" ads.

Learn more about video fallback.

&nofb=1 
pp

Control which creatives are eligible to serve based on the configuration set up in a video creative profile.

Learn more about video creative profiles.

pp=video_creative_profile
ppid The Publisher Provided Identifier (PPID) allows publishers to send an identifier for use in frequency capping, audience segmentation and targeting, sequential ad rotation and other audience-based ad delivery controls across devices. Learn more 12JD92JD8078S8J29SDOAKC0EF230337
rdid
idtype
is_lat

With native applications (not on web or mobile web), the SDK passes resettable device identifiers for user targeting into your stream requests with the parameters for rdid, idtype, and is_lat. On SSB streams, you must pass these as explicit parameters, just as you would on a client-side DFP Video ad request. Learn more

Nearly all programmatic video ads require the presence of these values.

See detailed examples of resettable device identifiers.
scp Slot-specific custom parameters scp=excl_cat%3Dairline_
exclusion_label%7C
tfcd

Tags an ad request for child-directed treatment. 

Learn more about tfcd.

http://pubads.g.doubleclick.net/gampad/ad?tfcd=1&iu=/12345/adunit&sz=728x90&c=12345

back to top 

Custom SDK parameters

The following parameters are the defaults set by the Google IMA SDK. Only include the parameters below in your master video tag if you're not using the IMA SDK.

The current DFP architecture requires that video ad requests include information about ads previously shown in the stream and on the page. This information helps build a picture of past activity while accounting for ad exclusions and duplicates.

SDK parameters related to ad rules and video positions

Parameter Description Sample value Required
pod Represents a pod within a video. Pass &pod=1 for first pod, &pod=2 for second pod, and so on. Used for competitive exclusions, frequency capping, and related features. 3 No, but must be passed for features such as competitive exclusions, frequency capping, and related features to work correctly.
ppos Represents position within a pod. Necessary for companion autofill. Pass &ppos=1 for the first position, &ppos=2 for the second position, and so on. Used for competitive exclusions, frequency capping, and related features. 2 No, but must be passed for features such as competitive exclusions, frequency capping, and related features to work correctly.
vpos Indicates whether the ad request is being sent from pre-roll, mid-roll or post-roll preroll
midroll
postroll
No
mridx Number-based index that indicates from which mid-roll a request is made (1st, 2nd, 3rd, etc.) 2 No
lip Needs to be added for a request from the last position in a pod in case of standardized pods true Yes, for standardized pods
min_ad_duration
max_ad_duration
Taken together, these specify the duration range that an ad must match, in milliseconds.
Used to request a single ad.
15000
30000
No
pmnd
pmxd
Taken together, these specify the duration range that a pod must match, in milliseconds.
Used to request multiple ads (i.e., pods). *
0
60000
Yes, for optimized pods
pmad Max number of ads in a pod * 4 No

* These parameters are specific to optimized pods, which are available to publishers with an advanced video package.

Other SDK parameters

Parameter Description Sample value Required
scor An integer generated for each video stream; the number needs to be the same within a stream and unique within a page view. Used for competitive exclusions, frequency capping, and related features if a user is watching multiple videos on the same page. 17 No, but must be passed for features such as competitive exclusions, frequency capping, and related features to work correctly.
vad_type Indicates whether a linear or non-linear ad should be returned for the request linear
nonlinear
No
excl_cat Ad exclusion category. Blocks any line items containing the exclusion label in question from being eligible for a given ad request; works with scp and cust_params. &scp=excl_cat%3Dairline_
exclusion_label%7C
No

back to top 

Was this article helpful?
How can we improve it?