You may need use v9 or later to upload Structured Data Files. See the deprecations page for more details and the v9 migration guide for step-by-step instructions.

Structured Data - v9 - Ad Group

Page Summary

Ad Group IDs are automatically assigned when creating new Ad Groups unless a custom identifier in the format "ext[custom identifier]" is used.
Line Item Id is a required field for ad groups and can use a custom identifier when creating a new line item simultaneously.
Key fields such as Name, Status, Video Ad Format, and Bid Cost are required for every ad group entry.
Targeting options for ad groups include keywords, categories, placements (YouTube channels, videos, URLs, apps, app collections), demographics (gender, age, household income, parental status), audiences (audience lists, lookalike audiences, affinity/in-market, custom lists), languages, and geographies.
Demand Gen ad groups have specific requirements for inventory source strategy and enabled inventory sources.

See the overview for an explanation of format.

Field

Required

Type

Writable

Description

Ad Group Id

Required only when editing existing Ad Groups

integer

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

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

string

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

string, list

Yes

List of keyword strings to include in targeting.

This list is generated in ascending alphabetical order.

Keyword Targeting - Exclude

string, list

Yes

List of keyword strings to exclude in targeting.

This list is generated in ascending alphabetical order.

Category Targeting - Include

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.

Category Targeting - Exclude

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.

Placement Targeting - YouTube Channels - Include

string, list

Yes

List of YouTube channels to include.

List format = (YouTube Channel ID; YouTube Channel ID; etc.).

Placement Targeting - YouTube Channels - Exclude

string, list

Yes

List of YouTube channels to exclude.

List format = (YouTube Channel ID; YouTube Channel ID; etc.).

Placement Targeting - YouTube Videos - Include

string, list

Yes

List of YouTube videos to include.

List format = (YouTube Video ID; YouTube Video ID; etc.).

Placement Targeting - YouTube Videos - Exclude

string, list

Yes

List of YouTube videos to exclude.

List format = (YouTube Video ID; YouTube Video ID; etc.).

Placement Targeting - Popular Content - Include

string, list

Yes

List of popular content across YouTube and Google video partners to include. Select one or more of the acceptable values:

youtube_popular_content::001a1
gvp_popular_content::global_tier2
video_content::<ID>

Placement Targeting - URLs - Include

string, list

Yes

List of URLs to include in targeting. The list consists of URL strings.

List format = (someurl.com; someurltwo.com; etc.).

Placement Targeting - URLs - Exclude

string, list

Yes

List of URLs to exclude in targeting. The list consists of URL strings.

List format = (someurl.com; someurltwo.com; etc.).

Placement Targeting - Apps - Include

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.).

Placement Targeting - Apps - Exclude

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.).

Placement Targeting - App Collections - Include

string, list

Yes

List of app collections to include in targeting. List format= App Collection ID; App Collection ID;

Placement Targeting - App Collections - Exclude

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

Optimized Targeting

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

integer

Yes

Audience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.

Audience Expansion Seed List Excluded

string

Yes

Enable audience expansion seed list excluded.

TRUE
FALSE

Audience Targeting - Include

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.

Audience Targeting - Exclude

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.

Lookalike Audience Targeting - Include

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

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

string, list

Yes

List of affinity and/or in-market 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.

Affinity & In Market Targeting - Exclude

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.

Custom List Targeting

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.

Language Targeting - Include

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

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

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

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

Structured Data - v9 - Ad Group Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Structured Data - v9 - Ad Group