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](https://developers.google.com/display-video/api/structured-data-file/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](https://developers.google.com/display-video/api/structured-data-file/v9/LineItem) 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](https://developers.google.com/display-video/api/structured-data-file/v9/LineItem) 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](https://developers.google.com/display-video/api/structured-data-file/v9/LineItem),
[Ad Group](https://developers.google.com/display-video/api/structured-data-file/v9/AdGroup), and [Ad](https://developers.google.com/display-video/api/structured-data-file/v9/AdGroupAd) files.

To support Demand Gen resources:

- New columns have been added to [Ad Group](https://developers.google.com/display-video/api/structured-data-file/v9/AdGroup) and [Ad](https://developers.google.com/display-video/api/structured-data-file/v9/AdGroupAd) 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](https://developers.google.com/display-video/api/structured-data-file/v9/AdGroupAd) 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](https://developers.google.com/display-video/api/structured-data-file/v9/InsertionOrder) 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](https://developers.google.com/display-video/api/structured-data-file/v9/LineItem) 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](https://developers.google.com/display-video/api/structured-data-file/v9/LineItem) file type.

## Comprehensive list of changes

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