Structured Data - v9.2 - Ad Group QA

See the overview for an explanation of format.

This is a QA file format. Files in this format are read-only and cannot be uploaded.

FieldTypeDescription
Ad Group Idinteger
Line Item Idinteger
Line Item NamestringLine Item Name
NamestringThe name of the entry.
StatusstringThe status setting for the entry.
  • Active
  • Paused
  • Archived
  • Deleted
  • Draft
Video Ad FormatstringThe 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 CostfloatThe 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 Qastring, list

List of keyword strings to include in targeting. This list is generated in alphabetical order.

If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters.

Keyword Targeting - Exclude Qastring, list

List of keyword strings to exclude in targeting. This list is generated in alphabetical order.

If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters.

Category Targeting - Include Qastring, listList of categories to include in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order.
Category Targeting - Exclude Qastring, listList of categories to exclude in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order.
Placement Targeting - YouTube Channels - Include Qastring, listList of YouTube channels to include. List format = (YouTube channel name; YouTube channel name; etc.). This list is generated in alphabetical order.
Placement Targeting - YouTube Channels - Exclude Qastring, listList of YouTube channels to exclude. List format = (YouTube channel name; YouTube channel name; etc.). This list is generated in alphabetical order.
Placement Targeting - YouTube Videos - Include Qastring, listList of YouTube videos to include. List format = (YouTube video name; YouTube video name; etc.). This list is generated in alphabetical order.
Placement Targeting - YouTube Videos - Exclude Qastring, listList of YouTube videos to exclude. List format = (YouTube video name; YouTube video name; etc.). This list is generated in alphabetical order.
Placement Targeting - Popular Content - Includestring, list

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 - Excludestring, list

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 - Includestring, list

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

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

Placement Targeting - URLs - Excludestring, list

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

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

Placement Targeting - Apps - Includestring, list

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 - Excludestring, list

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 Qastring, listList of app collections to include in targeting. List format = (App collection name; App collection name; etc.). This list is generated in alphabetical order.
Placement Targeting - App Collections - Exclude Qastring, listList of app collections to exclude in targeting. List format = (App collection name; App collection name; etc.). This list is generated in alphabetical order.
Demographic Targeting Genderstring, listList of genders to target. Select one or more of the acceptable values:
  • Female
  • Male
  • Unknown
Demographic Targeting Agestring, list

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 Incomestring, list

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 Statusstring, list

List of parental status to target. Select one or more of the acceptable values.

  • Parent
  • Not a parent
  • Unknown
Optimized TargetingstringEnable 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 LevelintegerAudience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.
Audience Expansion Seed List ExcludedstringEnable audience expansion seed list excluded.
  • TRUE
  • FALSE
Audience Targeting - Include Qastring, list

List of first- and third-party audience lists to include in targeting.

List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.

Audience Targeting - Exclude Qastring, list

List of first- and third-party audience lists to exclude in targeting.

List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.

Lookalike Audience Targeting - Include Qastring, list

A list of lookalike audiences to include in targeting.

List format: Lookalike Audience Name; Lookalike Audience Name;

Lookalike Audience Targeting - Exclude Qastring, list

A list of lookalike audiences to exclude in targeting.

List format: Lookalike Audience Name; Lookalike Audience Name;

Affinity & In Market Targeting - Include Qastring, listList of affinity and/or in-market audience lists to include. List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.
Affinity & In Market Targeting - Exclude Qastring, list
Life Event Targeting - Include Qastring, list

A list of life envents audiences names to include in targeting.

List format: Life Event Name; Life Event Name;

Life Event Targeting - Exclude Qastring, list

A list of life envents audiences names to exclude in targeting.

List format: Life Event Name; Life Event Name;

Detailed Demo Targeting - Include Qastring, list

A list of detailed demo audiences names to include in targeting.

List format: Detailed Demo Name; Detailed Demo Name;

Detailed Demo Targeting - Exclude Qastring, list

A list of detailed demo audiencesnames to exclude in targeting.

List format: Detailed Demo Name; Detailed Demo Name;

Combined Audience Targeting Qastring, listList of combined audience lists to target. List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.
Custom List Targeting Qastring, listList of custom lists to target. List format = (Custom list name; Custom list name; etc.). This list is generated in alphabetical order.
Language Targeting - Include Qastring, listList of languages to include in targeting. List format = (Language name; Language name; etc.). This list is generated in alphabetical order.
Geography Targeting - Include Qastring, listList of geography regions to include in targeting. List format = (Geo Region Name; Geo Region Name; etc.). This list is generated in alphabetical order.
Geography Targeting - Exclude Qastring, listList of geography regions to exclude in targeting. List format = (Geo Region Name; Geo Region Name; etc.). This list is generated in alphabetical order.
Demand Gen Inventory Source StrategystringDemand Gen inventory sources strategy.
  • All Google inventory
  • All Google and Display Network inventory
  • Selected inventories
Demand Gen Enabled Inventory Sourcesstring, listDemand Gen enabled inventory sources. This is used when the inventory source strategy is not set.
Product Filter Typestring

The Product Filter option selection.

  • All Products
  • Specific Products
  • Custom Label
  • No Products
Product Filter Settingstring, list

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 Idinteger

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.