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: v11

Version 11

Release of v11.

Status	Entity	Field	Property	Value(s)
Added	Line Item QA	Line Item Deal Type
		Proximity Business Chain Targeting Qa
		TrueView Instant Deal Ad Format
		TrueView Instant Deal Lift Study Enablement
		TrueView Instant Deal Policy Restrictions
Added	Line Item	Line Item Deal Type
		Proximity Business Chain Targeting
		TrueView Instant Deal Ad Format
		TrueView Instant Deal Lift Study Enablement
		TrueView Instant Deal Policy Restrictions
Added	Ad Group QA	First Position Targeting
Added	Ad Group	First Position Targeting
Added	Ad	Pause Ad Image Asset IDs
Changed	Line Item QA	TrueView Bid Strategy Type	Description	Added 'Fixed CPM' option. Required for YouTube Instant Deal line items.
			Options	Manual CPV: Manual view-based bidding where you pay per view. Manual CPM: Manual impression-based bidding where you pay per thousand impressions. This value is not supported for new Trueview or Demand Gen line items. Target CPM: Automated bid strategy that optimizes bids to help get as many impressions as possible using a target amount for how much you're willing to pay every thousand times your ad is shown. Maximize Conversions: Automated bid strategy that optimizes bids to help get as many conversions as possible. Target CPA: Automated bid strategy that optimizes bids to help get as many conversions as possible using a target amount for how much you're willing to pay per conversion. Maximize Conversion Value: Automated value-based bidding strategy that optimizes for the higher value conversions. Target ROAS: A value-based bidding strategy that optimizes for higher value of a conversion. Target CPV: Automated bid strategy that allows the system to bid higher on select formats when necessary (e.g. in-stream) while blending down the average across others (e.g. in-feed) to achieve the overall target requirement. Target CPC: Automated bidding strategy that sets bids to target the advertiser-specified average CPC. Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget Fixed CPM: Bidding strategy type for YouTube Instant Deals.
		TrueView Bid Strategy Value	Description	Specified that the column value must be 0 for YouTube Instant Deal Line Items with a fixed CPM bidding strategy.
		TrueView Third-Party Brand Lift Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Brand Lift Reporting ID' column.
		TrueView Third-Party Brand Safety Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Brand Safety Reporting ID' column.
		TrueView Third-Party Reach Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Reach Reporting ID' column.
		TrueView Third-Party Viewability Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Viewability Reporting ID' column.
Changed	Line Item	TrueView Bid Strategy Type	Description	Added 'Fixed CPM' option. Required for YouTube Instant Deal line items.
			Options	Manual CPV: Manual view-based bidding where you pay per view. Manual CPM: Manual impression-based bidding where you pay per thousand impressions. This value is not supported for new Trueview or Demand Gen line items. Target CPM: Automated bid strategy that optimizes bids to help get as many impressions as possible using a target amount for how much you're willing to pay every thousand times your ad is shown. Maximize Conversions: Automated bid strategy that optimizes bids to help get as many conversions as possible. Target CPA: Automated bid strategy that optimizes bids to help get as many conversions as possible using a target amount for how much you're willing to pay per conversion. Maximize Conversion Value: Automated value-based bidding strategy that optimizes for the higher value conversions. Target ROAS: A value-based bidding strategy that optimizes for higher value of a conversion. Target CPV: Automated bid strategy that allows the system to bid higher on select formats when necessary (e.g. in-stream) while blending down the average across others (e.g. in-feed) to achieve the overall target requirement. Target CPC: Automated bidding strategy that sets bids to target the advertiser-specified average CPC. Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget Fixed CPM: Bidding strategy type for YouTube Instant Deals.
		TrueView Bid Strategy Value	Description	Specified that the column value must be 0 for YouTube Instant Deal Line Items with a fixed CPM bidding strategy.
		TrueView Third-Party Brand Lift Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Brand Lift Reporting ID' column.
		TrueView Third-Party Brand Safety Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Brand Safety Reporting ID' column.
		TrueView Third-Party Reach Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Reach Reporting ID' column.
		TrueView Third-Party Viewability Vendor	Description	Updated the data format of the column to include the relevant reporting ID and support the assignment of multiple vendors. This removes the need for the 'TrueView Third-Party Viewability Reporting ID' column.
Changed	Ad Group QA	Bid Cost	Description	Added restriction for YouTube Instant Deal guaranteed deal.
Changed	Ad Group	Bid Cost	Description	Added restriction for YouTube Instant Deal guaranteed deal.
		Lookalike Audience Targeting - Exclude	Description	Enabled for use by all ad groups not under a 'Video Sequence' line item.
		Lookalike Audience Targeting - Include	Description	Enabled for use by all ad groups not under a 'Video Sequence' line item.
Removed	Line Item QA	TrueView Third-Party Brand Lift Reporting ID
		TrueView Third-Party Brand Safety Reporting ID
		TrueView Third-Party Reach Reporting ID
		TrueView Third-Party Viewability Reporting ID
Removed	Line Item	TrueView Third-Party Brand Lift Reporting ID
		TrueView Third-Party Brand Safety Reporting ID
		TrueView Third-Party Reach Reporting ID
		TrueView Third-Party Viewability Reporting ID

Version 10.1

Release of v10.1.

Status	Entity	Field	Property	Value(s)
Added	Ad Group QA	Trueview Ad Source
		Trueview Creative Assignments
Added	Ad Group	Trueview Ad Source
		Trueview Creative Assignments
Added	Ad	Parent Creative ID
Changed	Insertion Order	Io Subtype	Description	Added 'Out Of Home' subtype.
			Options	Default Regular Over The Top Out Of Home
Changed	Line Item QA	Inventory Mode	Description	Renamed content filter options.
			Options	Limited Moderate Maximum
		Related Videos	Description	Added support for setting and retrieving the synthetic content attestation status of each YouTube video.
		Subtype	Description	Added 'Out Of Home' subtype.
			Options	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 Out Of Home
		TrueView Third-Party Reach Vendor	Description	Added support for the vendor 'Aquila'.
			Options	None Nielsen Comscore Kantar Gemius Video Research Media Scope Audience Project iSpot TV VideoAmp Aquila
		TrueView Third-Party Viewability Vendor	Description	Added support for the vendor 'Zefr'.
			Options	None Moat DoubleVerify Integral Ad Science Zefr
Changed	Line Item	Inventory Mode	Description	Renamed content filter options.
			Options	Limited Moderate Maximum
		Related Videos	Description	Added support for setting and retrieving the synthetic content attestation status of each YouTube video.
		Subtype	Description	Added 'Out Of Home' subtype.
			Options	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 Out Of Home
		TrueView Third-Party Reach Vendor	Description	Added support for the vendor 'Aquila'.
			Options	None Nielsen Comscore Kantar Gemius Video Research Media Scope Audience Project iSpot TV VideoAmp Aquila
		TrueView Third-Party Viewability Vendor	Description	Added support for the vendor 'Zefr'.
			Options	None Moat DoubleVerify Integral Ad Science Zefr
Changed	Ad	Video Id	Description	Added support for setting and retrieving the synthetic content attestation status of each YouTube video.

Version 10

Release of v10.

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.