Migrate to Structured Data Files v10

Last update: 2026-06-02

This guide leads you through these processes:

• Configure your version settings.Update your Partner and Advertiser resources to use v10 as the default version for downloading and uploading files using the Display & Video 360 interface or API.
• Update your technical integration.Adjust your data processing logic to accommodate schema changes detailed in the comparison sections for v9 , v9.1 and v9.2 .

Configure your Structured Data Files version settings

Update your resources and SDF generation actions to use v10 when downloading and uploading Structured Data Files.

To use a new Structured Data Files version, update the assigned version in your parent Partner and Advertiser resources and use the new version when creating individual download tasks in the Display & Video 360 API .

Update parent resource settings

You set the default Structured Data Files version at the partner and advertiser resource level. This version is used as the default when downloading Structured Data Files through the interface or API.

Set in the interface

At the partner level:

1. Navigate to the intended partner.
2. Go to the Basic Detailspage under the Partner Settingsmenu in the left-hand navigation.
3. Update the SDF versionconfiguration in the Structured Data Files section to v10.

At the advertiser level:

1. Navigate to the intended advertiser.
2. Go to the Basic Detailspage under the Advertiser Settingsmenu in the left-hand navigation.
3. Update the SDF versionconfiguration in the Structured Data Filessection to v10. If the default version is set at the Partner level, this setting may not be editable.

Set in the API

At the partner level:You cannot set the default SDF version at the Partner level in the API.

At the advertiser level:Make an advertisers.patch request to update the dataAccessConfig.sdfConfig.sdfConfig.version to SDF_VERSION_10 and, if needed, dataAccessConfig.sdfConfig.overridePartnerSdfConfig to True.

Update sdfdownloadtasks.create requests in the API

When making a sdfdownloadtasks.create request using the Display & Video 360 API, set the version field of the request body to SDF_VERSION_10 .

Update your technical integration

The following sections provide a comprehensive list of all changes between live versions and v10.

Update your integration to take into account these changes. Consider the following when updating specific statuses:

• Added. This column has been added to the file format. It will be included in all downloaded files of this type and must be included when uploading files of this type unless you are using Partial SDF Upload .
• Removed. This column has been removed from the file format. It must be removed from your integration to parse downloaded files and successfully upload files.
• Changed. The behavior of this column has been updated. Examples of possible changes include the column being required in the new version or updates to accepted values. Read the change description as well as the column description in the v10 reference documentation to understand if and how you need to update your integration to align with the new column behavior.

v9 to v10

v9.1 to v10

v9.2 to v10