Structured Data - v8 - Ad Group QA

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

SDF v8 supports Demand Gen resources, which is in beta. Demand Gen line items, ad groups, and ads are only available to users enrolled in the beta.

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.

Field	Type	Description
Ad Group Id	integer
Line Item Id	integer
Line Item Name	string	Line Item Name
Name	string	The name of the entry.
Status	string	The status setting for the entry. Active Paused Archived Deleted Draft
Video Ad Format	string	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	float	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 Qa	string, 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 Qa	string, 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 Qa	string, list	List of categories to include in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order.
Category Targeting - Exclude Qa	string, list	List 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 Qa	string, list	List 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 Qa	string, list	List 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 Qa	string, list	List 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 Qa	string, list	List 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 - Include	string, list	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	List of URLs to include.
Placement Targeting - URLs - Exclude	string, list	List of URLs to exclude.
Placement Targeting - Apps - Include	string, list	List of mobile apps to include.
Placement Targeting - Apps - Exclude	string, list	List of mobile apps to exclude.
Placement Targeting - App Collections - Include Qa	string, list	List 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 Qa	string, list	List 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 Gender	string, list	List of genders to target. Select one or more of the acceptable values: Female Male Unknown
Demographic Targeting Age	string, 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 Income	string, 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 Status	string, list	List of parental status to target. Select one or more of the acceptable values. Parent Not a parent Unknown
Optimized Targeting	string	Enable optimized targeting. TRUE FALSE On September 30, 2024, optimized targeting will no longer be compatible with certain bid strategies. This value will be updated from 'TRUE' to '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 Level	integer	Audience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.
Audience Expansion Seed List Excluded	string	Enable audience expansion seed list excluded. TRUE FALSE
Audience Targeting - Include Qa	string, 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 Qa	string, 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 Qa	string, list	A list of lookalike audiences to include in targeting. List format: Lookalike Audience Name; Lookalike Audience Name;
Lookalike Audience Targeting - Exclude Qa	string, list	A list of lookalike audiences to exclude in targeting. List format: Lookalike Audience Name; Lookalike Audience Name;
Affinity & In Market Targeting - Include Qa	string, list	List 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 Qa	string, list
Custom List Targeting Qa	string, list	List of custom lists to target. List format = (Custom list name; Custom list name; etc.). This list is generated in alphabetical order.
Language Targeting - Include Qa	string, list	List of languages to include in targeting. List format = (Language name; Language name; etc.). This list is generated in alphabetical order.
Geography Targeting - Include Qa	string, list	List 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 Qa	string, list	List of geography regions to exclude in targeting. List format = (Geo Region Name; Geo Region Name; etc.). This list is generated in alphabetical order.