Последнее обновление: 21.08.2025
Это руководство проведет вас через следующие процессы:
- Обновите выбранную версию структурированных файлов данных до версии 9 с помощью пользовательского интерфейса или API Display & Video 360.
- Перенесите интеграцию с устаревших версий структурированных файлов данных (v7, v7.1, v8 или v8.1) на v9. Это позволит вам перейти на страницы с подробным описанием изменений между текущей версией и v9, которые могут повлиять на вашу интеграцию. В некоторых случаях вам потребуется использовать v9 для загрузки SDF-файлов, начиная с 8 сентября 2025 года.
Полный список различий между вашей версией и v9 смотрите на страницах миграции, относящихся к каждой версии .
Обновите версию структурированных файлов данных
Чтобы использовать v9, необходимо обновить ресурсы и действия по созданию SDF-файлов для использования v9 при загрузке и выгрузке структурированных файлов данных.
Обновление версии структурированных файлов данных
Чтобы использовать новую версию структурированных файлов данных, обновите назначенную версию в ресурсах родительского партнера и рекламодателя и используйте новую версию при создании отдельных задач загрузки в API Display & Video 360 .
Обновить настройки родительского ресурса
Версию структурированных файлов данных по умолчанию вы устанавливаете на уровне ресурсов партнёра и рекламодателя. Эта версия будет использоваться по умолчанию при загрузке структурированных файлов данных через интерфейс или API.
Установить в интерфейсе
На уровне партнёра:
- Перейдите к предполагаемому партнеру.
- Перейдите на страницу «Основные сведения» в меню «Настройки партнера» в левой навигационной панели.
- Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v9 .
На уровне рекламодателя:
- Перейдите к предполагаемому рекламодателю.
- Перейдите на страницу «Основные сведения» в меню «Настройки рекламодателя» в левой навигационной панели.
- Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до версии 9. Если версия по умолчанию установлена на уровне партнёра, этот параметр может быть недоступен для редактирования.
Установить в API
На уровне партнера: Вы не можете установить версию SDF по умолчанию на уровне партнера в API.
На уровне рекламодателя: выполните запрос advertisers.patch , чтобы обновить dataAccessConfig.sdfConfig.sdfConfig.version до SDF_VERSION_9 и, при необходимости, dataAccessConfig.sdfConfig.overridePartnerSdfConfig до True.
Обновление запросов sdfdownloadtasks.create в API
При выполнении запроса sdfdownloadtasks.create с использованием API Display & Video 360 установите поле version тела запроса на SDF_VERSION_9 .
Перенести из текущей версии SDF
На следующих страницах вы найдете пошаговую инструкцию по необходимым обновлениям интеграции при переходе с текущей версии на v9, а также полный список всех изменений между версиями: