Page Summary
-
Version 9.2 (beta) of the Structured Data File (SDF) format introduces several new fields and changes across Line Item QA, Line Item, Ad Group QA, and Ad Group entities, including support for Video Sequence.
-
Version 9.1 added and changed fields in Line Item QA, Line Item, Ad Group QA, and Ad Group, while removing some Insertion Order and Line Item fields.
-
Older versions of the SDF format, starting from v3.1 up to v9, have introduced various additions, changes, and removals across entities like Campaign, Insertion Order, Line Item, Ad Group, and Ad to support features like Demand Gen ads and update targeting functionalities.
-
Key changes across versions highlight the evolution of the SDF format to accommodate new advertising capabilities and refine how targeting data is structured and presented.
This page provides release notes for the Structured Data File format.
Latest supported version: v10
Version 10
| Status | Entity | Field | Property | Value(s) |
|---|---|---|---|---|
| Added | Line Item QA | Curated Ctv Packages Targeting - Include | ||
| Added | Line Item | Curated Ctv Packages Targeting - Include | ||
| Added | Ad Group QA | Geography Regional Location List Targeting - Exclude Qa | ||
| Geography Regional Location List Targeting - Include Qa | ||||
| Added | Ad Group | Geography Regional Location List Targeting - Exclude | ||
| Geography Regional Location List Targeting - Include | ||||
| Changed | Line Item QA | Audio Content Type Targeting | Description | Updated 'online radio' to 'live fm/am broadcast', 'streaming music' to 'music streaming service', and added 'catch up radio', 'web radio', 'video game', and 'text to speech'. |
| Options |
| |||
| Changed | Line Item | Audio Content Type Targeting | Description | Updated 'online radio' to 'live fm/am broadcast', 'streaming music' to 'music streaming service', and added 'catch up radio', 'web radio', 'video game', and 'text to speech'. |
| Options |
| |||
| Removed | Campaign | Brand Safety Custom Settings | ||
| Brand Safety Sensitivity Setting | ||||
| Demographic Targeting Age | ||||
| Demographic Targeting Gender | ||||
| Demographic Targeting Household Income | ||||
| Demographic Targeting Parental Status | ||||
| Digital Content Labels - Exclude | ||||
| Environment Targeting | ||||
| Geography Targeting - Exclude | ||||
| Geography Targeting - Include | ||||
| Inventory Source Targeting - Authorized Seller Options | ||||
| Inventory Source Targeting - Exclude | ||||
| Inventory Source Targeting - Include | ||||
| Inventory Source Targeting - Target New Exchanges | ||||
| Language Targeting - Exclude | ||||
| Language Targeting - Include | ||||
| Position Targeting - Display On Screen | ||||
| Position Targeting - Display Position In Content | ||||
| Position Targeting - Video On Screen | ||||
| Position Targeting - Video Position In Content | ||||
| Third Party Verification Labels | ||||
| Third Party Verification Services | ||||
| Viewability Targeting Active View | ||||
| Removed | Insertion Order | Affinity & In Market Targeting - Exclude | ||
| Affinity & In Market Targeting - Include | ||||
| App Collection Targeting - Exclude | ||||
| App Collection Targeting - Include | ||||
| App Targeting - Exclude | ||||
| App Targeting - Include | ||||
| Audience Targeting - Exclude | ||||
| Audience Targeting - Include | ||||
| Audio Content Type Targeting | ||||
| Brand Safety Custom Settings | ||||
| Brand Safety Sensitivity Setting | ||||
| Browser Targeting - Exclude | ||||
| Browser Targeting - Include | ||||
| Carrier Targeting - Exclude | ||||
| Carrier Targeting - Include | ||||
| Category Targeting - Exclude | ||||
| Category Targeting - Include | ||||
| Channel Targeting - Exclude | ||||
| Channel Targeting - Include | ||||
| Connection Speed Targeting | ||||
| Content Duration Targeting | ||||
| Content Genre Targeting - Exclude | ||||
| Content Genre Targeting - Include | ||||
| Content Stream Type Targeting | ||||
| Custom List Targeting | ||||
| Daypart Targeting Time Zone | ||||
| Daypart Targeting | ||||
| Demographic Targeting Age | ||||
| Demographic Targeting Gender | ||||
| Demographic Targeting Household Income | ||||
| Demographic Targeting Parental Status | ||||
| Device Targeting - Exclude | ||||
| Device Targeting - Include | ||||
| Digital Content Labels - Exclude | ||||
| Environment Targeting | ||||
| Geography Targeting - Exclude | ||||
| Geography Targeting - Include | ||||
| Inventory Source Targeting - Authorized Seller Options | ||||
| Inventory Source Targeting - Exclude | ||||
| Inventory Source Targeting - Include | ||||
| Inventory Source Targeting - Target New Exchanges | ||||
| Keyword List Targeting - Exclude | ||||
| Keyword Targeting - Exclude | ||||
| Keyword Targeting - Include | ||||
| Language Targeting - Exclude | ||||
| Language Targeting - Include | ||||
| Position Targeting - Audio Position In Content | ||||
| Position Targeting - Display On Screen | ||||
| Position Targeting - Display Position In Content | ||||
| Position Targeting - Video On Screen | ||||
| Position Targeting - Video Position In Content | ||||
| Proximity Location List Targeting | ||||
| Proximity Targeting | ||||
| Site Targeting - Exclude | ||||
| Site Targeting - Include | ||||
| Third Party Verification Labels | ||||
| Third Party Verification Services | ||||
| Video Player Size Targeting | ||||
| Viewability Omid Targeting Enabled | ||||
| Viewability Targeting Active View | ||||
| Removed | Line Item QA | Placement Targeting - App Collections - Exclude Qa | ||
| Placement Targeting - Apps - Exclude | ||||
| Placement Targeting - URLs - Exclude | ||||
| Removed | Line Item | Placement Targeting - App Collections - Exclude | ||
| Placement Targeting - Apps - Exclude | ||||
| Placement Targeting - URLs - Exclude |
Version 9.2
Release of v9.2.
| Status | Entity | Field | Property | Value(s) |
|---|---|---|---|---|
| Added | Line Item QA | Detailed Demo Targeting - Exclude Qa | ||
| Detailed Demo Targeting - Include Qa | ||||
| Life Event Targeting - Exclude Qa | ||||
| Life Event Targeting - Include Qa | ||||
| Merchant Center Account Id | ||||
| Optimize Fixed Bidding | ||||
| Placement Targeting - App Collections - Exclude Qa | ||||
| Placement Targeting - Apps - Exclude | ||||
| Placement Targeting - Popular Content - Exclude | ||||
| Placement Targeting - URLs - Exclude | ||||
| Placement Targeting - YouTube Channels - Exclude Qa | ||||
| Placement Targeting - YouTube Videos - Exclude Qa | ||||
| Primary Status Reason | ||||
| Primary Status | ||||
| Related Videos | ||||
| Video Sequence Minimum Duration | ||||
| Video Sequence Steps | ||||
| Added | Line Item | Detailed Demo Targeting - Exclude | ||
| Detailed Demo Targeting - Include | ||||
| Life Event Targeting - Exclude | ||||
| Life Event Targeting - Include | ||||
| Merchant Center Account Id | ||||
| Optimize Fixed Bidding | ||||
| Placement Targeting - App Collections - Exclude | ||||
| Placement Targeting - Apps - Exclude | ||||
| Placement Targeting - Popular Content - Exclude | ||||
| Placement Targeting - URLs - Exclude | ||||
| Placement Targeting - YouTube Channels - Exclude | ||||
| Placement Targeting - YouTube Videos - Exclude | ||||
| Primary Status Reason | ||||
| Primary Status | ||||
| Related Videos | ||||
| Video Sequence Minimum Duration | ||||
| Video Sequence Steps | ||||
| Added | Ad Group QA | Detailed Demo Targeting - Exclude Qa | ||
| Detailed Demo Targeting - Include Qa | ||||
| Life Event Targeting - Exclude Qa | ||||
| Life Event Targeting - Include Qa | ||||
| Placement Targeting - Popular Content - Exclude | ||||
| Product Filter Setting | ||||
| Product Filter Type | ||||
| Video Sequence Step Id | ||||
| Added | Ad Group | Detailed Demo Targeting - Exclude | ||
| Detailed Demo Targeting - Include | ||||
| Life Event Targeting - Exclude | ||||
| Life Event Targeting - Include | ||||
| Placement Targeting - Popular Content - Exclude | ||||
| Product Filter Setting | ||||
| Product Filter Type | ||||
| Video Sequence Step Id | ||||
| Changed | Line Item QA | Subtype | Description | Added 'Video Sequence' subtype for a closed list of Display & Video 360 clients. |
| Options |
| |||
| TrueView Connected TV Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Desktop Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Mobile Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Tablet Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Video Ad Formats | Description | Added restrictions for 'Video Sequence' line items. | ||
| Changed | Line Item | Audience Targeting - Exclude | Description | Added different formatting for 'Video Sequence' line items. |
| Audience Targeting - Include | Description | Added different formatting for 'Video Sequence' line items. | ||
| Demographic Targeting Age | Description | Added different formatting for 'Video Sequence' line items. | ||
| Demographic Targeting Household Income | Description | Added different formatting for 'Video Sequence' line items. | ||
| Subtype | Description | Added 'Video Sequence' subtype for a closed list of Display & Video 360 clients. | ||
| Options |
| |||
| TrueView Connected TV Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Desktop Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Mobile Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Tablet Bid Adjustment Percentage | Description | Added acceptable adjustments for 'Video Sequence' line items. | ||
| TrueView Video Ad Formats | Description | Added restrictions for 'Video Sequence' line items. | ||
| Changed | Ad Group QA | Placement Targeting - Popular Content - Include | Description | Not available for ad groups of 'Video Sequence' line items. |
| Changed | Ad Group | Affinity & In Market Targeting - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. |
| Affinity & In Market Targeting - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Audience Expansion Level | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Audience Expansion Seed List Excluded | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Audience Targeting - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Audience Targeting - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Category Targeting - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Category Targeting - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Combined Audience Targeting | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Custom List Targeting | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Demographic Targeting Age | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Demographic Targeting Gender | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Demographic Targeting Household Income | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Demographic Targeting Parental Status | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Keyword Targeting - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Keyword Targeting - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - App Collections - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - App Collections - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - Apps - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - Apps - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - Popular Content - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - URLs - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - URLs - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - YouTube Channels - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - YouTube Channels - Include | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - YouTube Videos - Exclude | Description | Not available for ad groups of 'Video Sequence' line items. | ||
| Placement Targeting - YouTube Videos - Include | Description | Not available for ad groups of 'Video Sequence' line items. |
Version 9.1
Release of v9.1.
| Status | Entity | Field | Property | Value(s) |
|---|---|---|---|---|
| Added | Line Item QA | Demand Gen Geography And Language Targeting Level | ||
| Added | Line Item | Demand Gen Geography And Language Targeting Level | ||
| Added | Ad Group QA | Combined Audience Targeting Qa | ||
| Added | Ad Group | Combined Audience Targeting | ||
| Changed | Insertion Order | Io Objective | Description | This column is now required. |
| Required | Yes | |||
| Changed | Line Item QA | Bid Strategy Unit | Description | Added the 'REACH' option. |
| Options |
| |||
| TrueView Video Ad Formats | Description | Renamed 'In-stream' to 'Skippable'. Removed 'In-stream / Bumper' and 'Bumper' options. | ||
| Options |
| |||
| Changed | Line Item | Bid Strategy Unit | Description | Added the 'REACH' option. |
| Options |
| |||
| TrueView Video Ad Formats | Description | Renamed 'In-stream' to 'Skippable'. Removed 'In-stream / Bumper' and 'Bumper' options. | ||
| Options |
| |||
| Removed | Insertion Order | Measure DAR Channel | ||
| Measure DAR | ||||
| Removed | Line Item QA | Bid Multipliers | ||
| Removed | Line Item | Bid Multipliers |
Version 9
Release of v9.
| Status | Entity | Field | Property | Value(s) |
|---|---|---|---|---|
| Added | Line Item QA | Contains EU Political Ads | ||
| Added | Line Item | Contains EU Political Ads |
Previous releases
To read about previous releases of sunset Structured Data Files versions, see our archived release notes.