Page Summary
-
This Structured Data File (SDF) version is in beta and currently available to a limited set of users, and unannounced changes may occur.
-
This file format is specifically a read-only QA file format and cannot be used for uploads.
-
The file includes fields for Ad Group and Line Item identification, naming, status, and video ad format.
-
Various targeting options are available, including keyword, category, placement, demographic, audience, language, and geography.
-
The file also includes fields for features like optimized targeting, audience expansion, and product filtering for Demand Gen inventory.
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.
- Active
- Paused
- Archived
- Deleted
- Draft
Select one of the following values:
- In-stream
- In-feed video
- Bumper
- Non skippable
- Responsive
- Efficient reach
- YouTube audio
- Demand Gen
Note: If the column 'TrueView Bid Strategy Type' is 'Maximize Conversions', 'Maximize Conversion Value' or 'Maximize Clicks', this column must be 0 when uploading.
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.
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.
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.
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.
List of URLs to include in targeting. The list consists of URL strings.
List format = (someurl.com; someurltwo.com; etc.).
List of URLs to exclude in targeting. The list consists of URL strings.
List format = (someurl.com; someurltwo.com; etc.).
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.).
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.).
- Female
- Male
- Unknown
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
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
List of parental status to target. Select one or more of the acceptable values.
- Parent
- Not a parent
- Unknown
- 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'
- TRUE
- FALSE
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.
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.
A list of lookalike audiences to include in targeting.
List format: Lookalike Audience Name; Lookalike Audience Name;
A list of lookalike audiences to exclude in targeting.
List format: Lookalike Audience Name; Lookalike Audience Name;
A list of life envents audiences names to include in targeting.
List format: Life Event Name; Life Event Name;
A list of life envents audiences names to exclude in targeting.
List format: Life Event Name; Life Event Name;
A list of detailed demo audiences names to include in targeting.
List format: Detailed Demo Name; Detailed Demo Name;
A list of detailed demo audiencesnames to exclude in targeting.
List format: Detailed Demo Name; Detailed Demo Name;
- All Google inventory
- All Google and Display Network inventory
- Selected inventories
The Product Filter option selection.
- All Products
- Specific Products
- Custom Label
- No Products
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.
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.
