Release Notes

  • 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: v9.2

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
  • Simple
  • Non Skippable
  • Action
  • Reach
  • View
  • Audio
  • Over The Top
  • Mobile App Install
  • Mobile App Buying
  • Simple Over The Top
  • Non Skippable Over The Top
  • Reach Over The Top
  • Target Frequency
  • Demand Gen
  • Video Sequence
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
  • Simple
  • Non Skippable
  • Action
  • Reach
  • View
  • Audio
  • Over The Top
  • Mobile App Install
  • Mobile App Buying
  • Simple Over The Top
  • Non Skippable Over The Top
  • Reach Over The Top
  • Target Frequency
  • Demand Gen
  • Video Sequence
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
  • CPA
  • CPC
  • custom impr. value/cost
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • REACH
TrueView Video Ad Formats
Description
Renamed 'In-stream' to 'Skippable'. Removed 'In-stream / Bumper' and 'Bumper' options.
Options
  • Skippable
  • Skippable / In-feed Video
  • Non Skippable
  • Skippable / Bumper / Non-skippable
  • Responsive
Changed
Line Item
Bid Strategy Unit
Description
Added the 'REACH' option.
Options
  • CPA
  • CPC
  • custom impr. value/cost
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • REACH
TrueView Video Ad Formats
Description
Renamed 'In-stream' to 'Skippable'. Removed 'In-stream / Bumper' and 'Bumper' options.
Options
  • Skippable
  • Skippable / In-feed Video
  • Non Skippable
  • Skippable / Bumper / Non-skippable
  • Responsive
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 .

Create a Mobile Website
View Site in Mobile | Classic
Share by: