Переход на файлы структурированных данных v7

Последнее обновление: 18 октября 2023 г.

В этом руководстве описывается процесс перехода на файлы структурированных данных (SDF) v7 с предыдущей версии, а также изменения, как необходимые, так и предлагаемые, которые вы можете внести для лучшей оптимизации интеграции.

См. примечания к выпуску для получения исчерпывающего списка различий между v6 и v7.

Перенесите версию файлов структурированных данных

Для перехода к файлам структурированных данных v7 из предыдущей версии необходимо указать новую версию, обновить пространства идентификаторов для подмножества существующих столбцов и добавить интеграцию с новыми столбцами.

Обновить версию файлов структурированных данных

Чтобы перейти на новую версию файлов структурированных данных, вам необходимо обновить версию, которую вы назначаете родительским ресурсам партнера и рекламодателя, а также отдельные задачи загрузки в Display & Video 360 API .

Обновить настройки родительского ресурса

Версия файлов структурированных данных по умолчанию устанавливается на уровне ресурсов партнера и рекламодателя. Эта версия используется по умолчанию при загрузке файлов структурированных данных через интерфейс или API.

Установить в интерфейсе

На партнерском уровне

Перейдите к предполагаемому партнеру. Перейдите на страницу «Основные сведения» в меню «Настройки партнера» на панели навигации слева. Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v7 .

На уровне рекламодателя

Перейдите к нужному рекламодателю. Перейдите на страницу «Основные сведения» в меню «Настройки рекламодателя» на панели навигации слева. Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v7 . Если версия по умолчанию установлена ​​на уровне партнера, этот параметр нельзя изменить.

Установить в API

На уровне рекламодателя

Отправьте запрос advertisers.patch , чтобы обновить dataAccessConfig.sdfConfig.sdfConfig.version до SDF_VERSION_7 и, при необходимости, dataAccessConfig.sdfConfig.overridePartnerSdfConfig до True .

Обновите запросы sdfdownloadtasks.create в API.

При создании запроса sdfdownloadtasks.create с помощью API Display & Video 360 установите для поля version тела запроса значение SDF_VERSION_7 .

Обновить идентификаторы в обязательных столбцах

В версии 7 были обновлены пространства идентификаторов, используемые подмножеством столбцов, чтобы отделить файлы структурированных данных от устаревшего продукта Entity Read Files и обеспечить дальнейшее согласование с поддерживаемыми инструментами, такими как Display & Video 360 API .

Внимание! Обновленные идентификаторы могут быть несовместимы со сценариями специальных ставок . Мы рекомендуем просмотреть справочную документацию по сигналам сценариев специального назначения ставок , чтобы получить самую свежую информацию об идентификаторах, которые следует использовать перед переносом.

В этом разделе перечислены все столбцы, использующие идентификаторы, отличные от идентификаторов версии 6, а также инструкции по получению справочной информации о новых значениях.

Заказ на размещение

v7 Инструкции по переносу столбцов
Таргетинг на приложения – исключить Таргетинг на приложения – включить	Эти столбцы были обновлены и теперь используют идентификаторы приложений в формате « App Platform:App ID ». Примеры: " APP:com.google.android.gm ", " APP:422689480 ", " ANDROID_TV_APP:com.google.android.youtube.tvunplugged " Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставленные соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple.
Таргетинг на браузер – исключить Таргетинг на браузер – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 с типом таргетинга TARGETING_TYPE_BROWSER . Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Таргетинг на операторов связи – исключить Таргетинг на операторов мобильной связи – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 с типом таргетинга TARGETING_TYPE_CARRIER_AND_ISP . Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Таргетинг на каналы – исключить Таргетинг на каналы – включить	Этот столбец был обновлен и теперь использует значение channelId ресурса Channel API Display & Video 360. Получайте ресурсы Channel по отдельности или в виде постраничных списков, используя службы advertisers.channels и partners.channels .
Таргетинг на устройства – исключить Таргетинг на устройства – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 для следующих типов таргетинга : TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Измерить канал DAR	Этот столбец был обновлен и теперь использует значение channelId ресурса Channel API Display & Video 360. Получайте ресурсы Channel по отдельности или в виде постраничных списков, используя службы advertisers.channels и partners.channels .
Таргетинг на сайты – исключить Таргетинг на сайты – включить	Этот столбец был обновлен, чтобы идентифицировать сайты по строкам URL.

Позиция

v7 Инструкции по переносу столбцов
Таргетинг на приложения – исключить Таргетинг на приложения – включить	Эти столбцы были обновлены и теперь используют идентификаторы приложений в формате « App Platform:App ID ». Примеры: " APP:com.google.android.gm ", " APP:422689480 ", " ANDROID_TV_APP:com.google.android.youtube.tvunplugged " Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставленные соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple.
Мультипликаторы ставок	Этот столбец был обновлен и теперь использует новые идентификаторы критериев для типов строк приложений и сайтов . Тип строки приложения был обновлен и теперь использует объединенные строковые значения платформы приложения и идентификатора платформы приложения, разделенные двоеточием, для идентификаторов критериев. Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставленные соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple. Тип строки сайта был обновлен для использования строк URL-адресов в качестве идентификаторов критериев.
Таргетинг на браузер – исключить Таргетинг на браузер – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 с типом таргетинга TARGETING_TYPE_BROWSER . Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Таргетинг на операторов связи – исключить Таргетинг на операторов мобильной связи – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 с типом таргетинга TARGETING_TYPE_CARRIER_AND_ISP . Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Таргетинг на каналы – исключить Таргетинг на каналы – включить	Этот столбец был обновлен и теперь использует значение channelId ресурса Channel API Display & Video 360. Получайте ресурсы Channel по отдельности или в виде постраничных списков, используя службы advertisers.channels и partners.channels .
Таргетинг на устройства – исключить Таргетинг на устройства – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 для следующих типов таргетинга : TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .
Таргетинг на сайты – исключить Таргетинг на сайты – включить	Этот столбец был обновлен, чтобы идентифицировать сайты по строкам URL.

Медиа-продукт

v7 Инструкции по переносу столбцов
Таргетинг на каналы – исключить Таргетинг на каналы – включить	Этот столбец был обновлен и теперь использует значение channelId ресурса Channel API Display & Video 360. Получайте ресурсы Channel по отдельности или в виде постраничных списков, используя службы advertisers.channels и partners.channels .
Таргетинг на устройства – включить	Этот столбец был обновлен для использования значений targetingOptionId ресурсов TargetingOption API Display & Video 360 для следующих типов таргетинга : TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Извлекайте ресурсы TargetingOption по отдельности или в виде списков с разбивкой на страницы с помощью службы targetingTypes.targetingOptions .

Добавить интеграцию со столбцами, добавленными начиная с версии 6.

При переходе с версии 6 на версию 7 вам необходимо добавить в соответствующие файлы следующие столбцы:

Тип файла	Столбец
Позиция	Целевой показатель частоты показов TrueView
Позиция	Временное окно целевой частоты TrueView
Группа объявлений YouTube	Оптимизированный таргетинг

Если вы переходите с предыдущей версии файлов структурированных данных, обратитесь к примечаниям к выпуску файлов структурированных данных , чтобы получить информацию о дополнительных столбцах, добавленных между вашей текущей версией и SDF v6.

Дополнительные изменения

В версии 7 мы также внесли некоторые поверхностные изменения, которые должны помочь вам упростить интеграцию и отказаться от использования устаревших файлов чтения сущностей для справки.

Новый порядок списка для некоторых столбцов.

SDF v7 гарантирует стабильный порядок определенных столбцов списка при создании файла. Это приводит к более последовательному поведению и упрощению проверки. Этот порядок не применяется при загрузке файла, но применяется впоследствии при создании обновленного файла.

Ознакомьтесь с примечаниями к выпуску версии 7, чтобы получить полный список столбцов, которые теперь создаются в возрастающем числовом или алфавитном порядке.

Рекомендации по новому идентификатору

Мы обновили определения ряда столбцов, убрав ссылки на устаревшие файлы чтения сущностей и вместо этого порекомендовав другие способы поиска идентификаторов.

Значения, возвращаемые следующими столбцами, ничем не отличаются от значений в SDF версии 6, но мы предлагаем вам обновить интеграцию, чтобы получать идентификаторы с использованием нового рекомендуемого метода, который можно найти в описаниях столбцов версии 7.

Типы файлов и их столбцы
Кампания	Географический таргетинг – исключить Географический таргетинг – включить Таргетинг на источник инвентаря – исключить Таргетинг на источник инвентаря – включить Языковой таргетинг – исключить Языковой таргетинг – включить
Заказ на размещение	Таргетинг по интересам и рынку — исключить Таргетинг по интересам и рынку – включить Таргетинг на коллекцию приложений – исключить Таргетинг на коллекцию приложений – включить Таргетинг на аудиторию – исключить Таргетинг на аудиторию – включить Таргетинг на категории – исключить Таргетинг на категории – включить Таргетинг на жанр контента – исключить Таргетинг на жанр контента – включить Пользовательский таргетинг на списки Географический таргетинг – исключить Географический таргетинг – включить Таргетинг на источник инвентаря – исключить Таргетинг на источник инвентаря – включить Таргетинг на список ключевых слов – исключить Языковой таргетинг – исключить Языковой таргетинг – включить
Позиция	Таргетинг по интересам и рынку — исключить Таргетинг по интересам и рынку – включить Таргетинг на коллекцию приложений – исключить Таргетинг на коллекцию приложений – включить Таргетинг на аудиторию – исключить Таргетинг на аудиторию – включить Таргетинг на категории – исключить Таргетинг на категории – включить Комбинированный таргетинг на аудиторию Таргетинг на жанр контента – исключить Таргетинг на жанр контента – включить Идентификаторы действий Floodlight-конверсий Творческие задания Пользовательский таргетинг на списки Географический таргетинг – исключить Географический таргетинг – включить Таргетинг на источник инвентаря – исключить Таргетинг на источник инвентаря – включить Таргетинг на список ключевых слов – исключить Языковой таргетинг – исключить Языковой таргетинг – включить
Медиа-продукт	Таргетинг на аудиторию – исключить Таргетинг на аудиторию – включить Таргетинг на категории – исключить Таргетинг на категории – включить Географический таргетинг – включить Языковой таргетинг – исключить Языковой таргетинг – включить
Группа объявлений YouTube	Таргетинг по интересам и рынку — исключить Таргетинг по интересам и рынку – включить Таргетинг на аудиторию – исключить Таргетинг на аудиторию – включить Таргетинг на категории – исключить Таргетинг на категории – включить Пользовательский таргетинг на списки