This page details the necessary updates to make to your Structured Data Files integration when migrating from v7.1 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.
Comprehensive list of changes
Status
Entity
Field
Property
Value(s)
Added
Line Item QA
Contains EU Political Ads
TrueView Video Ad Inventory Control
Added
Line Item
Contains EU Political Ads
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 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
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 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
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
