Structured Data - v5.2 - YouTube Ad

  • This specific Structured Data File (SDF) version is outdated and no longer supported for new uploads.

  • Users are strongly encouraged to switch to SDF version 7 to continue utilizing structured data files for campaign management.

  • This documentation remains available solely for reference purposes when working with previously created files using this older SDF version.

  • The documentation details the required fields and their specifications for defining various aspects of an ad, including its identification, status, targeting, and creative elements.

  • Users can find a comprehensive explanation of the overall SDF format through the provided overview link.

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 headline text for a discovery or responsive ad
Video Discovery Description 1Yes for Video DiscoverystringYesThe discovery ad description 1 text or responsive ad description
Video Discovery Description 2Yes for Video DiscoverystringYesThe discovery ad description 2 text
Video Discovery Landing PageYes for Video DiscoverystringYesThe discovery ad landing page