This page provides release notes for the Structured Data File format.
Latest supported version: v7.1
Version 7.1
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Insertion Order | Io Objective | ||
Kpi Algorithm Id | ||||
Kpi Type | ||||
Kpi Value | ||||
Added | Line Item | TrueView Video Ad Inventory Control | ||
Changed | Line Item | TrueView Inventory Source Targeting | Description | Added Google TV to inventory source targeting. |
Options |
| |||
TrueView Video Ad Formats | Description | Added Responsive ad format to be used in multiple line item types. | ||
Options |
| |||
Removed | Insertion Order | Billable Outcome | ||
Performance Goal Algorithm Id | ||||
Performance Goal Type | ||||
Performance Goal Value |
Version 7
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Line Item | TrueView Target Frequency Count | ||
TrueView Target Frequency Time Window | ||||
Added | TrueView Ad Group | Optimized Targeting | ||
Changed | Campaign | Geography Targeting - Exclude | Description | Updated to generate in ascending numerical order. |
Geography Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Changed | Insertion Order | Affinity & In Market Targeting - Exclude | Description | Updated to generate in ascending numerical order. |
Affinity & In Market Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
App Targeting - Exclude | Description | Updated to use a concatenated string values of app platform and app platform ID in place of site IDs. Updated to generate in ascending alphabetical order. | ||
App Targeting - Include | Description | Updated to use a concatenated string values of app platform and app platform ID in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Browser Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Browser Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Carrier Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Carrier Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Category Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Category Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Channel Targeting - Exclude | Description | Updated the ID space to use Display & Video 360 API | ||
Channel Targeting - Include | Description | Updated the ID space to use Display & Video 360 API | ||
Content Genre Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Content Genre Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Custom List Targeting | Description | Updated to generate in ascending numerical order. | ||
Daypart Targeting | Description | Updated to generate in ascending numerical order. | ||
Device Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API
Updated to generate in ascending numerical order. | ||
Device Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API
Updated to generate in ascending numerical order. | ||
Geography Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Geography Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Keyword List Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Keyword Targeting - Exclude | Description | Updated to generate in ascending alphabetical order. | ||
Keyword Targeting - Include | Description | Updated to generate in ascending alphabetical order. | ||
Language Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Measure DAR Channel | Description | Updated to use the Display & Video 360 API | ||
Site Targeting - Exclude | Description | Updated to use URLs in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Site Targeting - Include | Description | Updated to use URLs in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Changed | Line Item | Affinity & In Market Targeting - Exclude | Description | Updated to generate in ascending numerical order. |
Affinity & In Market Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
App Targeting - Exclude | Description | Updated to use a concatenated string values of app platform and app platform ID in place of site IDs. Updated to generate in ascending alphabetical order. | ||
App Targeting - Include | Description | Updated to use a concatenated string values of app platform and app platform ID in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Bid Multipliers | Description | Updated the app row type to use a concatenated string values of app platform and app platform ID in place of site IDs. Updated the site row type to use URLs in place of site IDs. | ||
Browser Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Browser Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Carrier Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Carrier Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API Updated to generate in ascending numerical order. | ||
Category Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Category Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Channel Targeting - Exclude | Description | Updated the ID space to use Display & Video 360 API | ||
Channel Targeting - Include | Description | Updated the ID space to use Display & Video 360 API | ||
Combined Audience Targeting | Description | Updated to generate in ascending numerical order. | ||
Content Genre Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Content Genre Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Creative Assignments | Description | Updated to generate in ascending numerical order. | ||
Custom List Targeting | Description | Updated to generate in ascending numerical order. | ||
Daypart Targeting | Description | Updated to generate in ascending numerical order. | ||
Device Targeting - Exclude | Description | Updated the ID space used by the column to use the Display & Video 360 API
Updated to generate in ascending numerical order. | ||
Device Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API
Updated to generate in ascending numerical order. | ||
Geography Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Geography Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Keyword List Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Keyword Targeting - Exclude | Description | Updated to generate in ascending alphabetical order. | ||
Keyword Targeting - Include | Description | Updated to generate in ascending alphabetical order. | ||
Language Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Private Deal Group Targeting Include | Description | Updated to generate in ascending numerical order. | ||
Site Targeting - Exclude | Description | Updated to use URLs in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Site Targeting - Include | Description | Updated to use URLs in place of site IDs. Updated to generate in ascending alphabetical order. | ||
Subtype | Description | Added Target Frequency subtype. | ||
Options |
| |||
TrueView Video Ad Formats | Description | Added In-stream / Bumper / Non-skippable ad format for Target Frequency line item type. | ||
Options |
| |||
Changed | Media Product | Category Targeting - Exclude | Description | Updated to generate in ascending numerical order. |
Category Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Channel Targeting - Exclude | Description | Updated the ID space to use Display & Video 360 API | ||
Channel Targeting - Include | Description | Updated the ID space to use Display & Video 360 API | ||
Device Targeting - Include | Description | Updated the ID space used by the column to use the Display & Video 360 API
Updated to generate in ascending numerical order. | ||
Geography Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Language Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Changed | TrueView Ad Group | Affinity & In Market Targeting - Exclude | Description | Updated to generate in ascending numerical order. |
Affinity & In Market Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Audience Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Audience Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Category Targeting - Exclude | Description | Updated to generate in ascending numerical order. | ||
Category Targeting - Include | Description | Updated to generate in ascending numerical order. | ||
Custom List Targeting | Description | Updated to generate in ascending numerical order. | ||
Keyword Targeting - Exclude | Description | Updated to generate in ascending alphabetical order. | ||
Keyword Targeting - Include | Description | Updated to generate in ascending alphabetical order. |
Version 6
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Insertion Order | Proximity Location List Targeting | ||
Proximity Targeting | ||||
Added | Line Item | Optimized Targeting | ||
Primary Attribution Model Id | ||||
Proximity Location List Targeting | ||||
Added | TrueView Ad Group | Audience Expansion Level | ||
Audience Expansion Seed List Excluded | ||||
Changed | Line Item | Subtype | Options |
|
TrueView Inventory Source Targeting | Description | Consolidated YouTube Search and YouTube Videos values | ||
Options |
| |||
TrueView Video Ad Formats | Description | Added In-stream ad format. | ||
Options |
| |||
Removed | Insertion Order | Audience Targeting - Similar Audiences | ||
Removed | Line Item | Audience Targeting - Similar Audiences | ||
Removed | TrueView Ad Group | Popular Videos Bid Adjustment |
Version 5.5
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Insertion Order | Audio Content Type Targeting | ||
Content Genre Targeting - Exclude | ||||
Content Genre Targeting - Include | ||||
Added | Line Item | Audio Content Type Targeting | ||
Content Genre Targeting - Exclude | ||||
Content Genre Targeting - Include | ||||
Added | TrueView Ad | Responsive Ad Display Url Path 1 | ||
Responsive Ad Display Url Path 2 | ||||
Changed | Line Item | TrueView Video Ad Formats | Description | Renamed "Video Discovery" to "In-feed Video". |
Options |
| |||
Changed | TrueView Ad Group | Video Ad Format | Description | Renamed "Video discovery" to "In-feed video". |
Options |
| |||
Changed | TrueView Ad | Video Discovery Description 1 | Name | In-feed Video Description 1 |
Required | Yes for In-feed Video | |||
Video Discovery Description 2 | Name | In-feed Video Description 2 | ||
Required | Yes for In-feed Video | |||
Video Discovery Headline | Name | In-feed Video Headline | ||
Required | Yes for In-feed Video | |||
Video Discovery Landing Page | Name | In-feed Video Landing Page | ||
Required | Yes for In-feed Video | |||
Video Discovery Video Thumbnail | Name | In-feed Video Thumbnail | ||
Required | Yes for In-feed Video |
Version 5.4
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | Campaign Budget Segments | ||
Added | Insertion Order | Content Duration Targeting | ||
Content Stream Type Targeting | ||||
Io Subtype | ||||
Performance Goal Algorithm Id | ||||
Viewability Omid Targeting Enabled | ||||
Added | Line Item | Content Duration Targeting | ||
Content Stream Type Targeting | ||||
Io Name | ||||
Viewability Omid Targeting Enabled | ||||
Added | TrueView Ad Group | Line Item Name | ||
Added | TrueView Ad | Ad Group Name | ||
Changed | Campaign | Brand Safety Custom Settings | Description | Changed BRAND_SAFETY_CUSTOM_TRANSLATIONS enum value to "Sexual" from "Adult" |
Options |
| |||
Changed | Insertion Order | Brand Safety Custom Settings | Description | Changed BRAND_SAFETY_CUSTOM_TRANSLATIONS enum value to "Sexual" from "Adult" |
Options |
| |||
Budget Segments | Description | Added Campaign Budget ID and description to budget segment. | ||
Changed | Line Item | Brand Safety Custom Settings | Description | Changed BRAND_SAFETY_CUSTOM_TRANSLATIONS enum value to "Sexual" from "Adult" |
Options |
| |||
TrueView Video Ad Formats | Description | Added In-stream / Bumper ad format. | ||
Options |
| |||
Changed | TrueView Ad Group | Video Ad Format | Description | Added efficient reach to video ad format. |
Options |
|
Version 5.3
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Line Item | Proximity Targeting | ||
Changed | Campaign | Brand Safety Sensitivity Setting | Description | Changed BRAND_SAFETY_SENSITIVITY_SETTING enum option to "Use Campaign Manager 360 Verification" from "Use Campaign Manager Verification" |
Options |
| |||
Changed | Insertion Order | Brand Safety Sensitivity Setting | Description | Changed BRAND_SAFETY_SENSITIVITY_SETTING enum option to "Use Campaign Manager 360 Verification" from "Use Campaign Manager Verification" |
Options |
| |||
Changed | Line Item | Brand Safety Sensitivity Setting | Description | Changed BRAND_SAFETY_SENSITIVITY_SETTING enum option to "Use Campaign Manager 360 Verification" from "Use Campaign Manager Verification" |
Options |
|
Version 5.2
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Line Item | Combined Audience Targeting | ||
TrueView Third-Party Brand Lift Reporting ID | ||||
TrueView Third-Party Brand Lift Vendor | ||||
TrueView Third-Party Brand Safety Reporting ID | ||||
TrueView Third-Party Reach Reporting ID | ||||
TrueView Third-Party Reach Vendor | ||||
TrueView Third-Party Viewability Reporting ID | ||||
Changed | Line Item | End Date | Description | Dropped HH:mm specification from flight end date. Will now default to end of flight end date, or 23:59. |
Start Date | Description | Dropped HH:mm specification from flight start date. Will now default to beginning of flight start date, or 00:00. |
Version 5.1
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Insertion Order | Algorithm Id | ||
Billable Outcome | ||||
Added | Line Item | Algorithm Id | ||
Private Deal Group Targeting Include | ||||
Added | TrueView Ad Group | Placement Targeting - Popular Content - Include |
Version 5
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | Inventory Source Targeting - Authorized Seller Options | ||
Position Targeting - Display On Screen | ||||
Position Targeting - Display Position In Content | ||||
Position Targeting - Video On Screen | ||||
Position Targeting - Video Position In Content | ||||
Added | Insertion Order | Apply Floor Price For Deals | ||
Bid Strategy Do Not Exceed | ||||
Bid Strategy Unit | ||||
Insertion Order Optimization | ||||
Inventory Source Targeting - Authorized Seller Options | ||||
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 | ||||
Added | Inventory Source | Commitment Type | ||
Delivery Method | ||||
Rate Type | ||||
Added | Line Item | Apply Floor Price For Deals | ||
Geography Regional Location List Targeting - Exclude | ||||
Geography Regional Location List Targeting - Include | ||||
Inventory Source Targeting - Authorized Seller Options | ||||
Position Targeting - Audio Position In Content | ||||
Position Targeting - Display Position In Content | ||||
Position Targeting - On Screen | ||||
Position Targeting - Video Position In Content | ||||
TrueView Bid Strategy Type | ||||
TrueView Bid Strategy Value | ||||
TrueView Third-Party Brand Safety Vendor | ||||
TrueView Third-Party Viewability Vendor | ||||
Added | TrueView Ad Group | Bid Cost | ||
Added | TrueView Ad | Action Button Label | ||
Action Headline | ||||
Changed | Campaign | Environment Targeting | Options |
|
Required | No | |||
Changed | Insertion Order | Environment Targeting | Options |
|
Required | No | |||
Changed | Line Item | Conversion Counting Pct | Required | Required when "Type" is "Display" or "Video" or "Audio" or "TrueView" |
Conversion Counting Type | Required | Required when "Type" is "Display" or "Video" or "Audio" or "TrueView" | ||
Environment Targeting | Options |
| ||
Required | No | |||
Subtype | Options |
| ||
TrueView Connected TV Bid Adjustment Percentage | Required | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | ||
TrueView Desktop Bid Adjustment Percentage | Required | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | ||
TrueView Mobile Bid Adjustment Percentage | Required | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | ||
TrueView Tablet Bid Adjustment Percentage | Required | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | ||
Removed | Campaign | Inventory Source Targeting - Authorized Seller Only | ||
Viewability Targeting Ad Position - Exclude | ||||
Viewability Targeting Ad Position - Include | ||||
Removed | Insertion Order | Inventory Source Targeting - Authorized Seller Only | ||
Video Ad Position Targeting | ||||
Viewability Targeting Ad Position - Exclude | ||||
Viewability Targeting Ad Position - Include | ||||
Removed | Inventory Source | Type | ||
Removed | Line Item | Inventory Source Targeting - Authorized Seller Only | ||
Video Ad Position Targeting | ||||
Viewability Targeting Ad Position - Exclude | ||||
Viewability Targeting Ad Position - Include | ||||
Removed | TrueView Ad Group | Max Cost |
Version 4.2
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | Digital Content Labels - Exclude | ||
Added | Insertion Order | Digital Content Labels - Exclude | ||
Added | Line Item | Conversion Floodlight Activity Ids | ||
Digital Content Labels - Exclude | ||||
TrueView Connected TV Bid Adjustment Option | ||||
TrueView Connected TV Bid Adjustment Percentage | ||||
Added | Media Product | |||
Changed | Campaign | Brand Safety Sensitivity Setting | Options |
|
Inventory Source Targeting - Authorized Seller Only | Description | New value "Authorized Direct" added to SDF v4.1 and v4.2. This value is used to indicate that only authorized sellers will be targeted. | ||
Changed | Insertion Order | Brand Safety Sensitivity Setting | Options |
|
Fees | Description | "Bid Manager Fee" type is replaced by "Display & Video 360 Fee" type. | ||
Inventory Source Targeting - Authorized Seller Only | Description | New value "Authorized Direct" added to SDF v4.1 and v4.2. This value is used to indicate that only authorized sellers will be targeted. | ||
Changed | Line Item | Brand Safety Sensitivity Setting | Options |
|
Creative Assignments | Description | On upload, creatives can now be specified using their Campaign Manager placement ID using the "CM" prefix. | ||
End Date | Description | Field now displays "Same as Insertion Order" for line items inheriting their parent insertion order"s flight. | ||
Fees | Description | "Bid Manager Fee" type is replaced by "Display & Video 360 Fee" type. | ||
Inventory Source Targeting - Authorized Seller Only | Description | New value "Authorized Direct" added to SDF v4.1 and v4.2. This value is used to indicate that only authorized sellers will be targeted. | ||
Start Date | Description | Field now displays "Same as Insertion Order" for line items inheriting their parent insertion order"s flight. | ||
TrueView Content Filter | Options |
| ||
TrueView Video Ad Formats | Options |
| ||
Changed | TrueView Ad Group | Video Ad Format | Options |
|
Removed | Campaign | Brand Safety Labels | ||
Removed | Insertion Order | Brand Safety Labels | ||
Removed | Line Item | Brand Safety Labels | ||
Conversion Pixel Ids |
Version 4.1
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | Inventory Source Targeting - Authorized Seller Only | ||
Added | Insertion Order | Inventory Source Targeting - Authorized Seller Only | ||
Added | Line Item | Inventory Source Targeting - Authorized Seller Only | ||
Changed | Insertion Order | Custom Affinity Targeting | Name | Custom List Targeting |
Changed | Line Item | Custom Affinity Targeting | Name | Custom List Targeting |
Changed | TrueView Ad Group | Custom Affinity Targeting | Name | Custom List Targeting |
Removed | TrueView Ad | Mobile App Id |
Version 4
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | Demographic Targeting Household Income | ||
Demographic Targeting Parental Status | ||||
Inventory Source Targeting - Target New Exchanges | ||||
Added | Insertion Order | App Collection Targeting - Exclude | ||
App Collection Targeting - Include | ||||
Daypart Targeting Time Zone | ||||
Demographic Targeting Household Income | ||||
Demographic Targeting Parental Status | ||||
Inventory Source Targeting - Target New Exchanges | ||||
Keyword List Targeting - Exclude | ||||
Added | Line Item | App Collection Targeting - Exclude | ||
App Collection Targeting - Include | ||||
Bid Multipliers | ||||
Daypart Targeting Time Zone | ||||
Demographic Targeting Household Income | ||||
Demographic Targeting Parental Status | ||||
Inventory Source Targeting - Target New Exchanges | ||||
Keyword List Targeting - Exclude | ||||
TrueView Content Filter | ||||
TrueView Desktop Bid Adjustment Option | ||||
TrueView Desktop Bid Adjustment Percentage | ||||
TrueView Tablet Bid Adjustment Option | ||||
TrueView Tablet Bid Adjustment Percentage | ||||
TrueView Video Ad Formats | ||||
Added | TrueView Ad Group | Demographic Targeting Household Income | ||
Placement Targeting - App Collections - Exclude | ||||
Placement Targeting - App Collections - Include | ||||
Added | TrueView Ad | DCM Tracking - Ad Id | ||
DCM Tracking - Creative Id | ||||
DCM Tracking - Placement Id | ||||
Changed | Line Item | Budget Type | Options |
|
Changed | TrueView Ad Group | Max Cost Per View | Name | Max Cost |
Video Ad Format | Options |
| ||
Changed | TrueView Ad | In-stream Click Tracker URL | Name | Click Tracker URL |
In-stream Display URL | Name | Display URL | ||
Required | Yes for In-stream and Bumper | |||
In-stream Landing Page URL | Name | Landing Page URL | ||
Required | Yes for In-stream and Bumper |
Version 3.1
Status | Entity | Field | Property | Value(s) |
---|---|---|---|---|
Added | Campaign | |||
Added | Insertion Order | Campaign Id | ||
Third Party Verification Labels | ||||
Third Party Verification Services | ||||
Added | Line Item | Third Party Verification Labels | ||
Third Party Verification Services |