You may need use v9 or later to upload Structured Data Files. See the deprecations page for more details and the v9 migration guide for step-by-step instructions.

Release Notes

Page Summary

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.
		Subtype	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.
		Subtype	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.
Changed	Insertion Order	Io Objective	Required	Yes
Changed	Line Item QA	Bid Strategy Unit	Description	Added the 'REACH' option.
		Bid Strategy Unit	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.
		TrueView Video Ad Formats	Options	Skippable Skippable / In-feed Video Non Skippable Skippable / Bumper / Non-skippable Responsive
Changed	Line Item	Bid Strategy Unit	Description	Added the 'REACH' option.
		Bid Strategy Unit	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.
		TrueView Video Ad Formats	Options	Skippable Skippable / In-feed Video Non Skippable Skippable / Bumper / Non-skippable Responsive
Removed	Insertion Order	Measure DAR Channel
Removed	Insertion Order	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.

Release Notes Stay organized with collections Save and categorize content based on your preferences.