Migrate from v7 to v9

This page details the necessary updates to make to your Structured Data Files integration when migrating from v7 to v9 and provides a comprehensive list of all changes between the two versions.

For details on how to update your selected SDF version, see our general v9 migration guide.

Updates

Make these updates to your integration to use v9.

Declare whether line items will serve EU political ads

You must declare whether a new line item will serve EU political ads using a new Contains EU Political Ads column in the Line Item file type.

This field is required when creating new line items or updating any of the following columns for an existing line item:

• Geography Targeting - Include
• Geography Targeting - Exclude
• Geography Regional Location List Targeting - Include
• Geography Regional Location List Targeting - Exclude
• Proximity Targeting
• Proximity Location List Targeting

If you have declared that the parent advertiser does not serve EU political ads, new line items will be assigned the No value if the column is not set.

Update name of Line Item "TrueView Content Filter" column

The TrueView Content Filter column in the Line Item file type has been renamed Inventory Mode. No other changes need to be made to the column content.

Add columns for Demand Gen resources support

Demand Gen resources are now supported and are included in Line Item, Ad Group, and Ad files.

To support Demand Gen resources:

• New columns have been added to Ad Group and Ad files.
• Additional enum values have been added to existing columns.
• New restrictions have been added to columns specific to Demand Gen resources.

See the comprehensive list of changes to address new columns. If you don't want to create or update Demand Gen resources, no other action is required.

Specify type in Ad resources

An Ad Type column has been added to Ad files. This surfaces the type of Ad represented by each row.

This new column is required. It will be populated for existing resources when downloading Ad files.

Don't update this column for existing Ads, the value of this column shouldn't be changed.

Update Insertion Order columns

Make the following changes your integration's handling of the Insertion Order file type:

• Replace the Performance Goal Type column with the Kpi Type column.
• Replace the Performance Goal Value column with the Kpi Value column.
• Replace the Performance Goal Algorithm Id column with the Kpi Algorithm Id column.
• Add the Io Objective column.
• Remove the Billable Outcome column.

Add support for new TrueView Line Item types

TrueView line items that use a "Responsive" video ad format are now supported in Line Item files, along with Line Items that use "Google TV" inventory source targeting.

These changes are accounted for in new enum options available for the TrueView Video Ad Formats and TrueView Inventory Source Targeting columns in the Line Item file type.

Comprehensive list of changes

Status	Entity	Field	Property	Value(s)
Added	Insertion Order	Io Objective
		Kpi Algorithm Id
		Kpi Type
		Kpi Value
Added	Line Item QA	Contains EU Political Ads
		TrueView Video Ad Inventory Control
Added	Line Item	Contains EU Political Ads
		TrueView Video Ad Inventory Control
Added	Ad Group QA	Demand Gen Enabled Inventory Sources
		Demand Gen Inventory Source Strategy
		Geography Targeting - Exclude Qa
		Geography Targeting - Include Qa
		Language Targeting - Include Qa
		Lookalike Audience Targeting - Exclude Qa
		Lookalike Audience Targeting - Include Qa
Added	Ad Group	Demand Gen Enabled Inventory Sources
		Demand Gen Inventory Source Strategy
		Geography Targeting - Exclude
		Geography Targeting - Include
		Language Targeting - Include
		Lookalike Audience Targeting - Exclude
		Lookalike Audience Targeting - Include
Added	Ad	Ad Type
		Business Name
		Companion Banner Asset IDs
		Demand Gen Cards
		Landing Page URL Suffix
		Logo Asset IDs
		Marketing Image Asset IDs
		Mobile Landing Page URL
Changed	Line Item QA	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
		TrueView Bid Strategy Type	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. Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget
			Required	Required for TrueView and Demand Gen line items
		TrueView Bid Strategy Value	Required	Required for TrueView and Demand Gen line items
		TrueView Connected TV Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Content Filter	Name	Inventory Mode
		TrueView Desktop Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Inventory Source Targeting	Options	YouTube Google TV Video Partners
		TrueView Mobile Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Tablet Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Third-Party Brand Lift Vendor	Required	Required only when updating existing 'TrueView' or 'Demand Gen' line items
		TrueView Third-Party Brand Safety Vendor	Required	Required only when updating existing TrueView or Demand Gen line items
		TrueView Third-Party Reach Vendor	Required	Required only when updating existing TrueView or Demand Gen line items
		TrueView Third-Party Viewability Vendor	Required	Required only when updating existing 'TrueView' or 'Demand Gen' line items
		TrueView Video Ad Formats	Options	In-stream In-stream / In-feed Video In-stream / Bumper Bumper Non Skippable In-stream / Bumper / Non-skippable Responsive
		Type	Options	Display Video TrueView Audio Demand Gen
Changed	Line Item	Frequency Enabled	Required	Required when 'Subtype' is not 'Demand Gen'
		Pacing Amount	Required	Required when 'Type' is 'Display' or 'Video' or 'Audio'. Required when 'Type' is 'TrueView' or 'Demand Gen' and 'Pacing' is 'Daily'.
		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
		TrueView Bid Strategy Type	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. Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget
			Required	Required for TrueView and Demand Gen line items
		TrueView Bid Strategy Value	Required	Required for TrueView and Demand Gen line items
		TrueView Connected TV Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Content Filter	Name	Inventory Mode
		TrueView Desktop Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Inventory Source Targeting	Options	YouTube Google TV Video Partners
		TrueView Mobile Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Tablet Bid Adjustment Percentage	Required	Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'
		TrueView Third-Party Brand Lift Vendor	Required	Required only when updating existing 'TrueView' or 'Demand Gen' line items
		TrueView Third-Party Brand Safety Vendor	Required	Required only when updating existing TrueView or Demand Gen line items
		TrueView Third-Party Reach Vendor	Required	Required only when updating existing TrueView or Demand Gen line items
		TrueView Third-Party Viewability Vendor	Required	Required only when updating existing 'TrueView' or 'Demand Gen' line items
		TrueView Video Ad Formats	Options	In-stream In-stream / In-feed Video In-stream / Bumper Bumper Non Skippable In-stream / Bumper / Non-skippable Responsive
		Type	Options	Display Video TrueView Audio Demand Gen
Changed	Ad Group QA	Video Ad Format	Options	In-stream In-feed video Bumper Non skippable Responsive Efficient reach YouTube audio Demand Gen
Changed	Ad Group	Video Ad Format	Options	In-stream In-feed video Bumper Non skippable Responsive Efficient reach YouTube audio Demand Gen
Changed	Ad	Action Button Label	Name	Call to Action
			Required	Required when the parent line item is a YouTube video action line item, 'Headline' is not empty, or 'Ad Type' is 'Demand Gen Video', 'Demand Gen Image', 'Demand Gen Carousel'
		Action Headline	Name	Headline
			Required	Required for Demand Gen Ads
		In-feed Video Description 1	Name	Description 1
			Required	Required for In-feed Video and Demand Gen ads
		In-feed Video Description 2	Name	Description 2
			Required	Required for In-feed Video
		In-feed Video Headline	Required	Required for In-feed Video and Demand Gen ads
		In-stream Custom Parameters	Name	Click Tracker URL Parameters
		Landing Page URL	Required	Required for In-stream, Bumper, and Demand Gen ads
		Responsive Ad Display Url Path 1	Name	Display URL Path 1
		Responsive Ad Display Url Path 2	Name	Display URL Path 2
		Video Id	Required	Required for YouTube and Demand Gen Video Ads
Removed	Insertion Order	Billable Outcome
		Performance Goal Algorithm Id
		Performance Goal Type
		Performance Goal Value