Structured Data - v8 - 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.
Ad Group NameNostringNoAd Group Name
NameYesstringYesThe name of the entry.
StatusYesstringYesThe status setting for the entry.
  • Active
  • Paused
  • Deleted
Ad TypeRequired for YouTube and Demand Gen AdsstringYesThe ad format of the ad.

In-stream & In-feed Video are YouTube video ad types sold on a CPV basis. Bumper ads are 6-second or less video YouTube ads sold on a CPM basis. Non-skippable video ads are in-stream YouTube ads between 6 and 15 seconds sold on a CPM basis. YouTube audio are audio YouTube ads. Responsive video ads are YouTube ad types that serve as multiple formats. Efficient reach ads will serve as YouTube bumper if the video is short enough, and YouTube in-stream otherwise. Demand Gen Video ads serve on multiple formats, including but not limited to YouTube. Demand Gen Image ads show images. Demand Gen Carousel ads show cards. Demand Gen Product ads show products.

Select one of the following values:
  • In-stream
  • In-feed video
  • Bumper
  • Non skippable
  • YouTube audio
  • Responsive
  • Efficient reach
  • Demand Gen Product
  • Demand Gen Video
  • Demand Gen Image
  • Demand Gen Carousel
Video IdRequired for YouTube and Demand Gen Video AdsstringYesThe YouTube video ID
Display URLYes for In-stream and BumperstringYesThe ad display URL
Landing Page URLRequired for In-stream, Bumper, and Demand Gen adsstringYesThe 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
Click Tracker URL ParametersNostring, list of listsYesThe click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc.
Call to ActionRequired when the parent line item is a YouTube video action line item, 'Headline' is not empty, or 'Ad Type' is 'Demand Gen Video', 'Demand Gen Image', 'Demand Gen Carousel'stringYesLabel for the Call to Action button (1 line with up to 10 characters).
HeadlineRequired for Demand Gen AdsstringYesHeadline for the Call to Action overlay (1 line with up to 15 characters).
Display URL Path 1NostringYesDisplay URL path 1
Display URL Path 2NostringYesDisplay URL path 2
In-feed Video ThumbnailYes for In-feed VideostringYesThe video thumbnail to use for video discovery ads
  • 0
  • 1
  • 2
  • 3
In-feed Video HeadlineRequired for In-feed Video and Demand Gen adsstringYesThe headline text for a discovery or responsive ad, or the long headline for Demand Gen ads.
Description 1Required for In-feed Video and Demand Gen adsstringYesThe discovery ad description 1 text or responsive ad description
Description 2Required for In-feed VideostringYesThe discovery ad description 2 text
In-feed Video Landing PageYes for In-feed VideostringYesThe discovery ad landing page
Mobile Landing Page URLNostringYesThe ad landing page URL for mobile devices
Business NameRequired for Demand Gen AdsstringYesThe name of the business that is being advertised
Landing Page URL SuffixNostringYesThe suffix for the landing page URL
Logo Asset IDsRequired for Demand Gen Adsstring, listYesThe list of asset ids for the logos. This list is generated in ascending numerical order.
Marketing Image Asset IDsRequired when 'Ad Type' is 'Demand Gen Image'string, listYesThe list of asset ids for the marketing images. This list is generated in ascending order.
Demand Gen CardsRequired when 'Ad Type' is 'Demand Gen Carousel'string, list of listsYesThis defines a list of cards, in the following format:

(final url; final mobile; url; headline; cta text; marketing image asset id; additional marketing asset ids...).

For example: (google.com; mobile.google.com; Headline; Click Here; 10020; 20020; 30020).

Each marketing asset must have a unique aspect ratio. If one card under an Ad has a square marketing image, then all cards under that Ad must have a square marketing image (this applies to the other aspect ratios as well).

Companion Banner Asset IDsNostring, listYesThe list of asset ids for the companion banners. This list is generated in ascending numerical order. This is supported for Video Performance, Demand Gen Video, In-stream, Bumper, and Non-skippable Ads. List format = 100; 200;