Structured Data - v8 - Ad Group

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.
Line Item NameNostringNoLine Item Name
NameYesstringYesThe name of the entry.
StatusYesstringYesThe status setting for the entry.
  • Active
  • Paused
  • Deleted
Video Ad FormatYesstringYesThe 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 CostYesfloatYesThe 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 - IncludeNostring, listYes

List of keyword strings to include in targeting.

This list is generated in ascending alphabetical order.

Keyword Targeting - ExcludeNostring, listYes

List of keyword strings to exclude in targeting.

This list is generated in ascending alphabetical order.

Category Targeting - IncludeNostring, listYes

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 - ExcludeNostring, listYesList 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 - 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 - Popular Content - IncludeNostring, listYesList 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 - 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.
Placement Targeting - App Collections - IncludeNostring, listYesList of app collections to include in targeting. List format= App Collection ID; App Collection ID;
Placement Targeting - App Collections - ExcludeNostring, listYesList of app collections to exclude in targeting. List format= App Collection ID; App Collection ID;
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 Household IncomeYesstring, listYesList 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 StatusYesstring, listYesList of parental status to target. Select one or more of the acceptable values.
  • Parent
  • Not a parent
  • Unknown
Optimized TargetingNostringYesEnable optimized targeting.
  • TRUE
  • FALSE

Optimized targeting is not compatible with all bid strategies. This column must be 'FALSE' if:
  • 'Bid Strategy Type' is 'Optimized vCPM'
  • 'Bid Strategy Type' is 'Maximum' and 'Bid Strategy Unit' is 'CIVA', 'IVO_TEN', or 'AV_VIEWED'
Audience Expansion LevelNointegerYesAudience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.
Audience Expansion Seed List ExcludedNostringYesEnable audience expansion seed list excluded.
  • TRUE
  • FALSE
Audience Targeting - IncludeNostring, listYes

List of audience lists to include.

This column uses Display & Video 360 API FirstAndThirdPartyAudience resource IDs.

List format = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; etc.). This list is generated in ascending numerical order.

Audience Targeting - ExcludeNostring, listYes

List of audience lists to exclude.

This column uses Display & Video 360 API FirstAndThirdPartyAudience resource IDs.

List format = (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; etc.). This list is generated in ascending numerical order.

Lookalike Audience Targeting - IncludeNostring, listYes

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 - ExcludeNostring, listYes

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 - IncludeNostring, listYes

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 - ExcludeNostring, listYes

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 TargetingNostring, listYes

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 - IncludeNostring, listYes

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 to Demand Gen ad groups.
Geography Targeting - IncludeNostring, listYes

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 to Demand Gen ad groups.
Geography Targeting - ExcludeNostring, listYes

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 to Demand Gen ad groups.