Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Последнее обновление: 21.08.2025
Это руководство проведет вас через следующие процессы:
Обновите выбранную версию структурированных файлов данных до версии 9 с помощью пользовательского интерфейса или API Display & Video 360.
Перенесите интеграцию с устаревших версий структурированных файлов данных (v7, v7.1, v8 или v8.1) на v9. Это позволит вам перейти на страницы с подробным описанием изменений между текущей версией и v9, которые могут повлиять на вашу интеграцию. В некоторых случаях вам потребуется использовать v9 для загрузки SDF-файлов, начиная с 8 сентября 2025 года.
Чтобы использовать v9, необходимо обновить ресурсы и действия по созданию SDF-файлов для использования v9 при загрузке и выгрузке структурированных файлов данных.
Обновление версии структурированных файлов данных
Чтобы использовать новую версию структурированных файлов данных, обновите назначенную версию в ресурсах родительского партнера и рекламодателя и используйте новую версию при создании отдельных задач загрузки в API Display & Video 360 .
Обновить настройки родительского ресурса
Версию структурированных файлов данных по умолчанию вы устанавливаете на уровне ресурсов партнёра и рекламодателя. Эта версия будет использоваться по умолчанию при загрузке структурированных файлов данных через интерфейс или API.
Установить в интерфейсе
На уровне партнёра:
Перейдите к предполагаемому партнеру.
Перейдите на страницу «Основные сведения» в меню «Настройки партнера» в левой навигационной панели.
Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v9 .
На уровне рекламодателя:
Перейдите к предполагаемому рекламодателю.
Перейдите на страницу «Основные сведения» в меню «Настройки рекламодателя» в левой навигационной панели.
Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до версии 9. Если версия по умолчанию установлена на уровне партнёра, этот параметр может быть недоступен для редактирования.
Установить в API
На уровне партнера: Вы не можете установить версию SDF по умолчанию на уровне партнера в API.
При выполнении запроса sdfdownloadtasks.create с использованием API Display & Video 360 установите поле version тела запроса на SDF_VERSION_9 .
Перенести из текущей версии SDF
На следующих страницах вы найдете пошаговую инструкцию по необходимым обновлениям интеграции при переходе с текущей версии на v9, а также полный список всех изменений между версиями:
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-21 UTC."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level:**\n\n1. Navigate to the intended partner.\n2. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto True.\n\n### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]
