This page provides release notes for the Structured Data File format.
| 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 | - Simple
- Non Skippable
- Action
- Reach
- Audio
- Over The Top
- Mobile App Install
- Mobile App Buying
- Simple Over The Top
- Non Skippable Over The Top
- Reach Over The Top
|
| TrueView Inventory Source Targeting | Description | Consolidated YouTube Search and YouTube Videos values |
| Options | |
| TrueView Video Ad Formats | Description | Added In-stream ad format. |
| Options | - In-stream
- In-stream / In-feed Video
- In-stream / Bumper
- Bumper
- Non Skippable
|
| Removed | Insertion Order | Audience Targeting - Similar Audiences | | |
| Removed | Line Item | Audience Targeting - Similar Audiences | | |
| Removed | TrueView Ad Group | Popular Videos Bid Adjustment | | |
| 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 | - In-stream / In-feed Video
- In-stream / Bumper
- Bumper
- Non Skippable
|
| Changed | TrueView Ad Group | Video Ad Format | Description | Renamed 'Video discovery' to 'In-feed video'. |
| Options | - In-stream
- In-feed video
- Bumper
- Non skippable
- Responsive
- Efficient reach
|
| 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 |
| 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 | - Sexual
- Derogatory
- Downloads & Sharing
- Weapons
- Gambling
- Violence
- Suggestive
- Profanity
- Alcohol
- Drugs
- Tobacco
- Politics
- Religion
- Tragedy
- Transportation Accidents
- Sensitive social issues
- Shocking
|
| Changed | Insertion Order | Brand Safety Custom Settings | Description | Changed BRAND_SAFETY_CUSTOM_TRANSLATIONS enum value to "Sexual" from "Adult" |
| Options | - Sexual
- Derogatory
- Downloads & Sharing
- Weapons
- Gambling
- Violence
- Suggestive
- Profanity
- Alcohol
- Drugs
- Tobacco
- Politics
- Religion
- Tragedy
- Transportation Accidents
- Sensitive social issues
- Shocking
|
| 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 | - Sexual
- Derogatory
- Downloads & Sharing
- Weapons
- Gambling
- Violence
- Suggestive
- Profanity
- Alcohol
- Drugs
- Tobacco
- Politics
- Religion
- Tragedy
- Transportation Accidents
- Sensitive social issues
- Shocking
|
| TrueView Video Ad Formats | Description | Added In-stream / Bumper ad format. |
| Options | - In-stream / Video Discovery
- In-stream / Bumper
- Bumper
- Non Skippable
|
| Changed | TrueView Ad Group | Video Ad Format | Description | Added efficient reach to video ad format. |
| Options | - In-stream
- Video discovery
- Bumper
- Non skippable
- Responsive
- Efficient reach
|
| 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 | - Do not block
- Use Campaign Manager 360 Verification
- Use custom
|
| 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 | - Do not block
- Use Campaign Manager 360 Verification
- Use custom
|
| 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 | - Do not block
- Use Campaign Manager 360 Verification
- Use custom
|
| 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. |
| 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 | - Simple
- Non Skippable
- Action
- Reach
|
| 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 | | |
| 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 | - Do not block
- Use Campaign Manager Verification
- Use custom
|
| 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 | - Do not block
- Use Campaign Manager Verification
- Use custom
|
| 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 | - Do not block
- Use Campaign Manager Verification
- Use custom
|
| 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 | - In-stream / Video Discovery
- Bumper
- Non Skippable
|
| Changed | TrueView Ad Group | Video Ad Format | Options | - In-stream
- Video discovery
- Bumper
- Non Skippable
|
| Removed | Campaign | Brand Safety Labels | | |
| Removed | Insertion Order | Brand Safety Labels | | |
| Removed | Line Item | Brand Safety Labels | | |
| Conversion Pixel Ids | | |
| 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 | - Amount
- Impressions
- Unlimited
- Automatic
- TrueView Budget
|
| Changed | TrueView Ad Group | Max Cost Per View | Name | Max Cost |
| Video Ad Format | Options | - In-stream
- Video discovery
- Bumper
|
| 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 |
