Migrate to Structured Data Files v10

Last update: 2026-06-02

This guide leads you through these processes:

  • Configure your version settings. Update your Partner and Advertiser resources to use v10 as the default version for downloading and uploading files using the Display & Video 360 interface or API.
  • Update your technical integration. Adjust your data processing logic to accommodate schema changes detailed in the comparison sections for v9, v9.1 and v9.2.

Configure your Structured Data Files version settings

Update your resources and SDF generation actions to use v10 when downloading and uploading Structured Data Files.

To use a new Structured Data Files version, update the assigned version in your parent Partner and Advertiser resources.

Update parent resource settings

You set the default Structured Data Files version at the partner and advertiser resource level. This version is used as the default when downloading Structured Data Files through the interface.

Set in the interface

At the partner level:

  1. Navigate to the intended partner.
  2. Go to the Basic Details page under the Partner Settings menu in the left-hand navigation.
  3. Update the SDF version configuration in the Structured Data Files section to v10.

At the advertiser level:

  1. Navigate to the intended advertiser.
  2. Go to the Basic Details page under the Advertiser Settings menu in the left-hand navigation.
  3. Update the SDF version configuration in the Structured Data Files section to v10. If the default version is set at the Partner level, this setting may not be editable.

Update your technical integration

The following sections provide a comprehensive list of all changes between live versions and v10.

Update your integration to take into account these changes. Consider the following when updating specific statuses:

  • Added. This column has been added to the file format. It will be included in all downloaded files of this type and must be included when uploading files of this type unless you are using Partial SDF Upload.
  • Removed. This column has been removed from the file format. It must be removed from your integration to parse downloaded files and successfully upload files.
  • Changed. The behavior of this column has been updated. Examples of possible changes include the column being required in the new version or updates to accepted values. Read the change description as well as the column description in the v10 reference documentation to understand if and how you need to update your integration to align with the new column behavior.

v9 to v10

StatusEntityFieldPropertyValue(s)
AddedLine Item QACurated Ctv Packages Targeting - Include
Demand Gen Geography And Language Targeting Level
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 - Popular Content - 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
AddedLine ItemCurated Ctv Packages Targeting - Include
Demand Gen Geography And Language Targeting Level
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 - Popular Content - 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
AddedAd Group QACombined Audience Targeting Qa
Detailed Demo Targeting - Exclude Qa
Detailed Demo Targeting - Include Qa
Geography Regional Location List Targeting - Exclude Qa
Geography Regional Location List 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
AddedAd GroupCombined Audience Targeting
Detailed Demo Targeting - Exclude
Detailed Demo Targeting - Include
Geography Regional Location List Targeting - Exclude
Geography Regional Location List 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
ChangedInsertion OrderIo ObjectiveRequiredYes
ChangedLine Item QAAudio Content Type TargetingDescriptionUpdated '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
Bid Strategy UnitOptions
  • CPA
  • CPC
  • custom impr. value/cost
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • REACH
SubtypeOptions
  • Simple
  • Non Skippable
  • 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 Video Ad FormatsOptions
  • Skippable
  • Skippable / In-feed Video
  • Non Skippable
  • Skippable / Bumper / Non-skippable
  • Responsive
ChangedLine ItemAudio Content Type TargetingDescriptionUpdated '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
Bid Strategy UnitOptions
  • CPA
  • CPC
  • custom impr. value/cost
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • REACH
SubtypeOptions
  • Simple
  • Non Skippable
  • 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 Video Ad FormatsOptions
  • Skippable
  • Skippable / In-feed Video
  • Non Skippable
  • Skippable / Bumper / Non-skippable
  • Responsive
RemovedCampaignBrand 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
RemovedInsertion OrderAffinity & 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
Measure DAR Channel
Measure DAR
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
RemovedLine Item QABid Multipliers
RemovedLine ItemBid Multipliers

v9.1 to v10

StatusEntityFieldPropertyValue(s)
AddedLine Item QACurated Ctv Packages Targeting - Include
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 - Popular Content - 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
AddedLine ItemCurated Ctv Packages Targeting - Include
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 - Popular Content - 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
AddedAd Group QADetailed Demo Targeting - Exclude Qa
Detailed Demo Targeting - Include Qa
Geography Regional Location List Targeting - Exclude Qa
Geography Regional Location List 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
AddedAd GroupDetailed Demo Targeting - Exclude
Detailed Demo Targeting - Include
Geography Regional Location List Targeting - Exclude
Geography Regional Location List 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
ChangedLine Item QAAudio Content Type TargetingDescriptionUpdated '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
SubtypeOptions
  • Simple
  • Non Skippable
  • 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
ChangedLine ItemAudio Content Type TargetingDescriptionUpdated '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
SubtypeOptions
  • Simple
  • Non Skippable
  • 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
RemovedCampaignBrand 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
RemovedInsertion OrderAffinity & 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

v9.2 to v10

StatusEntityFieldPropertyValue(s)
AddedLine Item QACurated Ctv Packages Targeting - Include
AddedLine ItemCurated Ctv Packages Targeting - Include
AddedAd Group QAGeography Regional Location List Targeting - Exclude Qa
Geography Regional Location List Targeting - Include Qa
AddedAd GroupGeography Regional Location List Targeting - Exclude
Geography Regional Location List Targeting - Include
ChangedLine Item QAAudio Content Type TargetingDescriptionUpdated '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
ChangedLine ItemAudio Content Type TargetingDescriptionUpdated '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
RemovedCampaignBrand 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
RemovedInsertion OrderAffinity & 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
RemovedLine Item QAPlacement Targeting - App Collections - Exclude Qa
Placement Targeting - Apps - Exclude
Placement Targeting - URLs - Exclude
RemovedLine ItemPlacement Targeting - App Collections - Exclude
Placement Targeting - Apps - Exclude
Placement Targeting - URLs - Exclude