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: 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
    • unknown
    • music streaming service
    • live fm/am broadcast
    • podcasts
    • catch up radio
    • web radio
    • video game
    • text to speech
    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
    • unknown
    • music streaming service
    • live fm/am broadcast
    • podcasts
    • catch up radio
    • web radio
    • video game
    • text to speech
    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
    • 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: