Structured Data - v9.2 - Ad Group

This SDF version is in beta. It is only available to a subset of users. Unannounced changes may be made to versions in beta.

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.
Line Item Name	No	string	No	Line Item Name
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 ad format of the ad group. Select one of the following values: In-stream In-feed video Bumper Non skippable Responsive Efficient reach YouTube audio Demand Gen
Bid Cost	Yes	float	Yes	The value representing the maximum target bid cost for the ad group based on the bid type set in the 'TrueView Bid Strategy Type' column. For example, if the 'TrueView Bid Strategy Type' is 'Manual CPV', it is the maximum cost-per-view. Note: If the column 'TrueView Bid Strategy Type' is 'Maximize Conversions', 'Maximize Conversion Value' or 'Maximize Clicks', this column must be 0 when uploading.
Keyword Targeting - Include	No	string, list	Yes	List of keyword strings to include in targeting. This list is generated in ascending alphabetical order. Not available for ad groups of 'Video Sequence' line items.
Keyword Targeting - Exclude	No	string, list	Yes	List of keyword strings to exclude in targeting. This list is generated in ascending alphabetical order. Not available for ad groups of 'Video Sequence' line items.
Category Targeting - Include	No	string, list	Yes	List of categories to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CATEGORY. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Category Targeting - Exclude	No	string, list	Yes	List of categories to exclude in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CATEGORY. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - YouTube Channels - Include	No	string, list	Yes	List of YouTube channels to include. List format = (YouTube Channel ID; YouTube Channel ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - YouTube Channels - Exclude	No	string, list	Yes	List of YouTube channels to exclude. List format = (YouTube Channel ID; YouTube Channel ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - YouTube Videos - Include	No	string, list	Yes	List of YouTube videos to include. List format = (YouTube Video ID; YouTube Video ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - YouTube Videos - Exclude	No	string, list	Yes	List of YouTube videos to exclude. List format = (YouTube Video ID; YouTube Video ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - Popular Content - Include	No	string, list	Yes	List of popular content across YouTube and Google video partners to include. Individual content groupings should have the structured 'video_content::Content Grouping ID'. List format = (video_content::Content Grouping ID; video_content::Content Grouping ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - Popular Content - Exclude	No	string, list	Yes	List of popular content across YouTube and Google video partners to exclude. Individual content groupings should have the structured 'video_content::Content Grouping ID'. List format = (video_content::Content Grouping ID; video_content::Content Grouping ID; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - URLs - Include	No	string, list	Yes	List of URLs to include in targeting. The list consists of URL strings. List format = (someurl.com; someurltwo.com; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - URLs - Exclude	No	string, list	Yes	List of URLs to exclude in targeting. The list consists of URL strings. List format = (someurl.com; someurltwo.com; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - Apps - Include	No	string, list	Yes	List of mobile apps to exclude in targeting. The list consists of app platform IDs. The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480). List format = (com.google.android.gm; 422689480; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - Apps - Exclude	No	string, list	Yes	List of mobile apps to exclude in targeting. The list consists of app platform IDs. The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480). List format = (com.google.android.gm; 422689480; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - App Collections - Include	No	string, list	Yes	List of app collections to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Not available for ad groups of 'Video Sequence' line items.
Placement Targeting - App Collections - Exclude	No	string, list	Yes	List of app collections to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Not available for ad groups of 'Video Sequence' line items.
Demographic Targeting Gender	Yes	string, list	Yes	List of genders to target. Select one or more of the acceptable values: Female Male Unknown Not available for ad groups of 'Video Sequence' line items.
Demographic Targeting Age	Yes	string, list	Yes	List of ages to target. Select one or more of the acceptable values. Not available for ad groups of 'Video Sequence' line items.
Demographic Targeting Household Income	Yes	string, list	Yes	List of household incomes to target. Select one or more of the acceptable values. Not available for ad groups of 'Video Sequence' line items.
Demographic Targeting Parental Status	Yes	string, list	Yes	List of parental status to target. Select one or more of the acceptable values. Not available for ad groups of 'Video Sequence' line items.
Optimized Targeting	No	string	Yes	Enable optimized targeting. TRUE FALSE Optimized targeting is not compatible with all bid strategies. This column must be 'FALSE' if: 'Bid Strategy Type' is 'Fixed' 'Bid Strategy Type' is 'Optimized vCPM' 'Bid Strategy Type' is 'Maximum' and 'Bid Strategy Unit' is 'CIVA', 'IVO_TEN', or 'AV_VIEWED'
Audience Expansion Level	No	integer	Yes	Audience expansion level. Can only be set to AdGroups with value 0, 1, 2, 3. Not available for ad groups of 'Video Sequence' line items
Audience Expansion Seed List Excluded	No	string	Yes	Enable audience expansion seed list excluded. TRUE FALSE Not available for ad groups of 'Video Sequence' line items
Audience Targeting - Include	No	string, list	Yes	List of audience lists to include. This column uses Display & Video 360 API FirstPartyAndPartnerAudience resource IDs. List format = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Audience Targeting - Exclude	No	string, list	Yes	List of audience lists to exclude. This column uses Display & Video 360 API FirstPartyAndPartnerAudience resource IDs. List format = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Lookalike Audience Targeting - Include	No	string, list	Yes	A list of lookalike audiences to include in targeting. List format: Lookalike Audience ID; Lookalike Audience ID; Only available to Demand Gen ad groups.
Lookalike Audience Targeting - Exclude	No	string, list	Yes	A list of lookalike audiences to exclude in targeting. List format: Lookalike Audience ID; Lookalike Audience ID; Only available to Demand Gen ad groups.
Affinity & In Market Targeting - Include	No	string, list	Yes	List of affinity and/or in-market audience lists to exclude. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Affinity & In Market Targeting - Exclude	No	string, list	Yes	List of affinity and/or in-market audience lists to exclude. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Life Event Targeting - Include	No	string, list	Yes	List of life event audience lists to include. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Only valid if 'Type' is 'TrueView' or 'Demand Gen'. Not available for ad groups of 'Video Sequence' line items.
Life Event Targeting - Exclude	No	string, list	Yes	List of life event audience lists to exclude. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Only valid if 'Type' is 'TrueView' or 'Demand Gen'. Not available for ad groups of 'Video Sequence' line items.
Detailed Demo Targeting - Include	No	string, list	Yes	List of detailed demo audience lists to include. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Only valid if 'Type' is 'TrueView' or 'Demand Gen'. Not available for ad groups of 'Video Sequence' line items.
Detailed Demo Targeting - Exclude	No	string, list	Yes	List of detailed demo audience lists to exclude. Audience list IDs can be retrieved from the Display & Video 360 interface. List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order. Only valid if 'Type' is 'TrueView' or 'Demand Gen'. Not available for ad groups of 'Video Sequence' line items.
Combined Audience Targeting	No	string, list	Yes	List of combined audience lists to target. This column uses Display & Video 360 API CombinedAudience resource IDs. List format = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Custom List Targeting	No	string, list	Yes	List of custom lists to target. This column uses Display & Video 360 API CustomList resource IDs. List format = (CustomList.customListId; CustomList.customListId; etc.). This list is generated in ascending numerical order. Not available for ad groups of 'Video Sequence' line items.
Language Targeting - Include	No	string, list	Yes	List of languages to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_LANGUAGE. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order. Only available if the following conditions are met: The 'Video Ad Format' column is set to 'Demand Gen' The parent line item has a geography and language targeting level set to ad group in the UI
Geography Targeting - Include	No	string, list	Yes	List of geographies to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_GEO_REGION. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order. Only available if the following conditions are met: The 'Video Ad Format' column is set to 'Demand Gen' The parent line item has a geography and language targeting level set to ad group in the UI
Geography Targeting - Exclude	No	string, list	Yes	List of geographies to exclude in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_GEO_REGION. List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order. Only available if the following conditions are met: The 'Video Ad Format' column is set to 'Demand Gen' The parent line item has a geography and language targeting level set to ad group in the UI
Demand Gen Inventory Source Strategy	Yes for Demand Gen ad groups	string	Yes	Demand Gen inventory sources strategy. All Google inventory All Google and Display Network inventory Selected inventories
Demand Gen Enabled Inventory Sources	No	string, list	Yes	Demand Gen enabled inventory sources. This is used when the inventory source strategy is not set. YouTube Skippable ads YouTube In-feed ads YouTube Shorts ads Gmail Discover Google Display Network
Product Filter Type	Required when 'Merchant Center Account Id' is set for the parent line item	string	Yes	The Product Filter option selection. All Products Specific Products Custom Label No Products
Product Filter Setting	Required when the 'Product Filter Type' is 'Specific Products' or 'Custom Label'	string, list	Yes	The Product Filter setting. Depending on the 'Product Filter Type' selection, it either consists of a list of IDs or key-value pairs. If 'Product Filter Type' is 'Specific Products', the list will contain numeric product IDs that can be found in the Google Merchant Center. Example: (1; 2; 3; etc.). If 'Product Filter Type' is 'Custom Label', the list will contain a list of key-value pairs where the keys are of the form 'Custom Label [0-4]' and the values are strings. Example: (Custom Label 0: value; Custom Label 1: value; etc.) If 'Product Filter Type' is 'All Products' or 'No Products', this column should be empty.
Video Sequence Step Id	Required when the parent line item subtype is 'Video Sequence'	integer	Yes	The ID of the sequence step that this ad group belongs to. The step must exist in the parent line item's 'Video Sequence Steps' before this ad group is created. This field is immutable once set. Only available for ad groups of 'Video Sequence' line items.