You might have to migrate to v9 to upload Structured Data Files afterSeptember 8, 2025. See ourdeprecations pagefor more details and ourv9 migration guidefor step-by-step instructions.
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 video ad format of the ad group.
In-stream
In-feed video
Bumper
Non skippable
Responsive
Efficient reach
YouTube audio
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 Target ROAS, 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.
Keyword Targeting - Exclude
No
string, list
Yes
List of keyword strings to exclude in targeting.
This list is generated in ascending alphabetical order.
Category Targeting - Include
No
string, list
Yes
List of categories to include in targeting. This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_CATEGORY.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
Category Targeting - Exclude
No
string, list
Yes
List of categories to exclude in targeting. This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_CATEGORY.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
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 - Popular Content - Include
No
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
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 ofapp collectionsto include in targeting. List format= App Collection ID; App Collection ID;
Placement Targeting - App Collections - Exclude
No
string, list
Yes
List ofapp collectionsto 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
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. It can only be set to AdGroups with value 0, 1, 2, 3.
List format = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). This list is generated in ascending numerical order.
List format = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). This list is generated in ascending numerical order.
Affinity & In Market Targeting - Include
No
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
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.
Custom List Targeting
No
string, list
Yes
List of custom lists to target.
This column uses Display & Video 360 APICustomListresource IDs.
List format = (CustomList.customListId; CustomList.customListId; etc.). This list is generated in ascending numerical order.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[[["\u003cp\u003eThis document outlines the format for a structured data file used to manage TrueView Ad Groups within Display & Video 360.\u003c/p\u003e\n"],["\u003cp\u003eIt details the required fields for creating and editing Ad Groups, including their associated Line Items, targeting criteria, and bidding strategies.\u003c/p\u003e\n"],["\u003cp\u003eThe table provides a comprehensive list of fields, specifying their data type, whether they are required, and a description of their function.\u003c/p\u003e\n"],["\u003cp\u003eVarious targeting options are available, such as keyword, category, placement (YouTube channels, videos, URLs, apps), demographic (gender, age, household income, parental status), audience, and affinity/in-market targeting.\u003c/p\u003e\n"],["\u003cp\u003eAd Groups can be further customized with settings for optimized targeting, audience expansion, and video ad formats (in-stream, in-feed, bumper, non-skippable, responsive, efficient reach, YouTube audio).\u003c/p\u003e\n"]]],["This document details the required and optional fields for configuring ad groups. Key actions include setting the ad group's name, status (Active, Paused, Deleted), video ad format, and bid cost. Users can specify line item associations, include or exclude keyword, category, placement, and audience targeting lists. Demographic targeting options such as gender, age, household income, and parental status are available. Additionally, the user can optimize targeting and manage audience expansion parameters.\n"],null,[]]
