Переход на файлы структурированных данных 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 гарантирует стабильный порядок определенных столбцов списка при создании файла. Это приводит к более последовательному поведению и упрощению проверки. Этот порядок не применяется при загрузке файла, но применяется впоследствии при создании обновленного файла.

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

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

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

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

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