Structured Data - v3.1 - YouTube Ad Group

  • This documented SDF version is outdated and no longer supported for creating new structured data files.

  • Users are advised to transition to SDF v7 for continued structured data file usage.

  • This documentation serves as a reference for previously generated files only.

  • Refer to the provided overview for a detailed explanation of the SDF format.

  • A comprehensive table outlines the required and optional fields for managing ad groups within structured data files, including details like targeting options, demographics, and ad formats.

See the overview for an explanation of format.

FieldRequiredTypeWritableDescription
Ad Group IdRequired only when editing existing Ad GroupsintegerNoNumeric ID value of the ad group. If left blank, a new Ad Group ID will be created and a unique ID will be assigned. Optionally, when creating new Ad Groups, you can use a custom identifier for the purpose of assigning TrueView Ads to the new Ad Group. The format for a custom identifier is "ext[custom identifier]", for example, ext123. When the file is uploaded and processed, all custom identifiers will be replaced with DBM-assigned IDs and the objects will be associated (for example, Ad to Ad Group) based on the custom identifiers.
Line Item IdYesintegerNoNumeric ID value of the parent line item. You can specify a custom identifier (for example, "ext[custom line item ID]") for a line item that you are creating at the same time as this Ad Group.
NameYesstringYesThe name of the entry.
StatusYesstringYesThe status setting for the entry.
  • Active
  • Paused
  • Deleted
Video Ad FormatYesstringYesThe video ad format of the ad group.
  • In-stream
  • Video discovery
Max Cost Per ViewYesfloatYesMax CPV of the ad group.
Popular Videos Bid AdjustmentNointegerYesBid adjustment to increase chances of showing ads on popular videos. Acceptable adjustments are 0-500%.
Keyword Targeting - IncludeNostring, listYesList of keyword strings to include in targeting.
Keyword Targeting - ExcludeNostring, listYesList of keyword strings to exclude in targeting.
Category Targeting - IncludeNostring, listYesList of categories to include in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Category Targeting - ExcludeNostring, listYesList of categories to exclude in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Placement Targeting - YouTube Channels - IncludeNostring, listYesList of YouTube channels to include.
Placement Targeting - YouTube Channels - ExcludeNostring, listYesList of YouTube channels to exclude.
Placement Targeting - YouTube Videos - IncludeNostring, listYesList of YouTube videos to include.
Placement Targeting - YouTube Videos - ExcludeNostring, listYesList of YouTube videos to exclude.
Placement Targeting - URLs - IncludeNostring, listYesList of URLs to include.
Placement Targeting - URLs - ExcludeNostring, listYesList of URLs to exclude.
Placement Targeting - Apps - IncludeNostring, listYesList of mobile apps to include.
Placement Targeting - Apps - ExcludeNostring, listYesList of mobile apps to exclude.
Demographic Targeting GenderYesstring, listYesList of genders to target. Select one or more of the acceptable values:
  • Female
  • Male
  • Unknown
Demographic Targeting AgeYesstring, listYesList of ages to target. Select one or more of the acceptable values.
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
  • Unknown
Demographic Targeting Parental StatusYesstring, listYesList of parental status to target. Select one or more of the acceptable values.
  • Parent
  • Not a parent
  • Unknown
Audience Targeting - IncludeNostring, listYesList of audience lists to include. List format= UserList ID; UserList ID;
Audience Targeting - ExcludeNostring, listYesList of audience lists to exclude. List format= UserList ID; UserList ID;
Affinity & In Market Targeting - IncludeNostring, listYesList of affinity and/or in-market audience lists to include. List format= UserList ID; UserList ID;
Affinity & In Market Targeting - ExcludeNostring, listYesList of affinity and/or in-market audience lists to exclude. List format= UserList ID; UserList ID;
Custom Affinity TargetingNostring, listYesList of custom lists to target. List format= UserList ID; UserList ID;