Coming soon: Changes to environment and position targeting in Structured Data Files. Learn more.

Structured Data - v5 - TrueView Ad

See the overview for an explanation of format.

FieldRequiredTypeWritableDescription
Ad IdRequired only when editing existing AdsintegerNoNumeric ID value of the ad group ad. If left blank a new Ad will be created and a unique ID will be assigned.
Ad Group IdYesintegerNoNumeric ID value of the parent ad group. You can specify a custom identifier (for example, "ext[custom ad group ID]") for an Ad Group that you are creating at the same time as this Ad.
NameYesstringYesThe name of the entry.
StatusYesstringYesThe status setting for the entry.
  • Active
  • Paused
  • Deleted
Video IdYesstringYesThe YouTube video ID
Display URLYes for In-stream and BumperstringYesThe ad display URL
Landing Page URLYes for In-stream and BumperstringYesThe ad landing page URL
DCM Tracking - Placement IdRequired only when updating DCM Tracking AdintegerYesNumeric ID value of DCM placement for the corresponding tracking ad.
To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank.
DCM Tracking - Ad IdRequired only when updating DCM Tracking AdintegerYesNumeric ID value of DCM Ad for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank.
DCM Tracking - Creative IdRequired only when updating DCM Tracking AdintegerYesNumeric ID value of the creative for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank.
Click Tracker URLNostringYesThe ad click tracker URL
In-stream Custom ParametersNostring, list of listsYesThe click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc.
Action Button LabelYes if the parent line item is a TrueView for action line item or column Action Headline is not emptystringYesLabel for the Call to Action button (1 line with up to 10 characters).
Action HeadlineNostringYesHeadline for the Call to Action overlay (1 line with up to 15 characters).
Video Discovery Video ThumbnailYes for Video DiscoverystringYesThe video thumbnail to use for video discovery ads
  • 0
  • 1
  • 2
  • 3
Video Discovery HeadlineYes for Video DiscoverystringYesThe discovery ad headline text
Video Discovery Description 1Yes for Video DiscoverystringYesThe discovery ad description 1 text
Video Discovery Description 2Yes for Video DiscoverystringYesThe discovery ad description 2 text
Video Discovery Landing PageYes for Video DiscoverystringYesThe discovery ad landing page