Structured Data - v4.2 - YouTube Ad Group

This SDF version has been sunset. Users should migrate to SDF v7 in order to continue using structured data files. Only use this documentation when referring to previously-generated files.

See the overview for an explanation of format.

Field	Required	Type	Writable	Description
Ad Group Id	Required only when editing existing Ad Groups	integer	No	Numeric 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 Id	Yes	integer	No	Numeric 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.
Name	Yes	string	Yes	The name of the entry.
Status	Yes	string	Yes	The status setting for the entry. Active Paused Deleted
Video Ad Format	Yes	string	Yes	The video ad format of the ad group. In-stream Video discovery Bumper Non Skippable
Max Cost	Yes	float	Yes	The max cost for the ad group. If the ad group is for in-stream or video discovery video ads, the value set will be the max Cost per View (CPV). If the ad group is for bumper video ads, the value set will be the max CPM.
Popular Videos Bid Adjustment	No	integer	Yes	Bid adjustment to increase chances of showing ads on popular videos. Acceptable adjustments are 0-500%.
Keyword Targeting - Include	No	string, list	Yes	List of keyword strings to include in targeting.
Keyword Targeting - Exclude	No	string, list	Yes	List of keyword strings to exclude in targeting.
Category Targeting - Include	No	string, list	Yes	List of categories to include in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Category Targeting - Exclude	No	string, list	Yes	List of categories to exclude in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Placement Targeting - YouTube Channels - Include	No	string, list	Yes	List of YouTube channels to include.
Placement Targeting - YouTube Channels - Exclude	No	string, list	Yes	List of YouTube channels to exclude.
Placement Targeting - YouTube Videos - Include	No	string, list	Yes	List of YouTube videos to include.
Placement Targeting - YouTube Videos - Exclude	No	string, list	Yes	List of YouTube videos to exclude.
Placement Targeting - URLs - Include	No	string, list	Yes	List of URLs to include.
Placement Targeting - URLs - Exclude	No	string, list	Yes	List of URLs to exclude.
Placement Targeting - Apps - Include	No	string, list	Yes	List of mobile apps to include.
Placement Targeting - Apps - Exclude	No	string, list	Yes	List of mobile apps to exclude.
Placement Targeting - App Collections - Include	No	string, list	Yes	List of app collections to include in targeting. List format= App Collection ID; App Collection ID;
Placement Targeting - App Collections - Exclude	No	string, list	Yes	List of app collections to exclude in targeting. List format= App Collection ID; App Collection ID;
Demographic Targeting Gender	Yes	string, list	Yes	List of genders to target. Select one or more of the acceptable values: Female Male Unknown
Demographic Targeting Age	Yes	string, list	Yes	List 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 Household Income	Yes	string, list	Yes	List of household incomes to target. Select one or more of the acceptable values. Top 10% 11-20% 21-30% 31-40% 41-50% Lower 50% Unknown
Demographic Targeting Parental Status	Yes	string, list	Yes	List of parental status to target. Select one or more of the acceptable values. Parent Not a parent Unknown
Audience Targeting - Include	No	string, list	Yes	List of audience lists to include. List format= UserList ID; UserList ID;
Audience Targeting - Exclude	No	string, list	Yes	List of audience lists to exclude. List format= UserList ID; UserList ID;
Affinity & In Market Targeting - Include	No	string, list	Yes	List of affinity and/or in-market audience lists to include. List format= UserList ID; UserList ID;
Affinity & In Market Targeting - Exclude	No	string, list	Yes	List of affinity and/or in-market audience lists to exclude. List format= UserList ID; UserList ID;
Custom List Targeting	No	string, list	Yes	List of custom lists to target. List format= UserList ID; UserList ID;