Create a master video tag manually

A master video tag is a URL used by the video player to retrieve the video ad. Here's a sample master video tag:

http://pubads.g.doubleclick.net/gampad/ads?
env=vp&
gdfp_req=1&
impl=s&
output=vast&
iu=/6062/video-demo&
sz=400x300&
unviewed_position_start=1&
url=http://www.simplevideoad.com&
ciu_szs=728x90,300x250&
correlator=7105

Master video tags support 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 via another page.

To assemble a master video tag using the correct URL parameters, refer to the tables below.

Once you've assembled a master video tag, test it with the VAST Suite Inspector.

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
impl Request mode: should always be sync (s). Always s.
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. Follow this format: /network id/directory tree.../ad unit /6062/videodemo
sz Size of master video ad slot. Multiple sizes should be separated by the pipe (|) character. Important: Don't include "v" after the size. 400x300
url The address (full URL) from which the ad request is being sent. This is the same URL as that of the page that displays the ad.* http://www.simplevideoad.com/golf.html
correlator A random number, typically the timestamp of the page view, that's shared by multiple requests coming from the same page view. If you're not using the Google IMA SDK, see note below.* Correlator is used to implement competitive exclusions, including in cookieless environments. 4345645667
description_url

Describes 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.

  • For publishers that use the Network Partner Management (NPM) feature, the description URL is compared to an NPM publisher's list of classified domains to see if ads are eligible to serve. If the description URL doesn't match a classified domain, no ads serve. For example, if you enter in mynewsite.com/sports/hockey, the top-level domain, mynewsite.com, is compared to your list of classified sites.
  • For apps, such as those built Android or iOS, the description_URL is the page Google contextually crawls to send relevant ads to the app.
  • For all other applications, use the single-encodedversion of the URL parameter detailed above.
The following example is for a single-encoded version of the URL:
http%3A%2F%2Fwww.simplevideoad.com %2Fgolf.html (i.e., the single-encoded version of http://www.simplevideoad.com/golf.html)
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). Please refer here for a list of valid codes: http://www.loc.gov/standards/iso639-2/php/English_list.php. it

*If you aren't using the Google IMA SDK: When you generate tags in the DFP UI, be aware that the tag generator inserts the url and correlator parameters as macros, for which you'll need to insert the appropriate information. (If you're using the Google IMA SDK, the SDK automatically inserts the information for these macros.)

  • url=[referrer_url] - the URL of the page where the ad will appear.
  • correlator=[timestamp] - typically the timestamp of the page view.

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
ciu_szs Comma-separated list of companion sizes 728x90,300x250
cust_params Key-value parameters Learn how to add key-value pairs to an ad tag.
scp slot-specific custom parameters &scp=excl_cat%3Dairline_
exclusion_label%7C
tfcd Tag an ad request for child-directed treatment  (Learn more) http://pubads.g.doubleclick.net/gampad/ad?tfcd=1&iu=/12345/adunit&sz=728x90&c=12345

Custom SDK parameters

The following parameters are the defaults set by the Google IMA SDK (Interactive Media Ads Software Development Kit). 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 1-based index that indicates from which mid-roll (1st, 2nd, 3rd, etc.) a request is made. 2 No
lip=true 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

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 pageview. 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
Was this article helpful?