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

Structured Data - v4 - 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.
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
Mobile App IdYes for Mobile App Install subtypestringYesThe mobile app used for mobile app install ads. Format:com.google.android.gm or 422689480