Последнее обновление: 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 Инструкции по переносу столбцов | |
|---|---|
Таргетинг на приложения – исключить Таргетинг на приложения – включить | Эти столбцы были обновлены и теперь используют идентификаторы приложений в формате « Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставляемые соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple. |
Таргетинг на браузер – исключить Таргетинг на браузер – включить | Этот столбец был обновлен и теперь использует значения Извлекайте ресурсы |
Таргетинг на операторов связи – исключить Таргетинг на операторов мобильной связи – включить | Этот столбец был обновлен для использования значений Извлекайте ресурсы |
Таргетинг на каналы – исключить Таргетинг на каналы – включить | Этот столбец был обновлен и теперь использует значение Получайте ресурсы |
Таргетинг на устройства – исключить Таргетинг на устройства – включить | Этот столбец был обновлен и теперь использует значения
Извлекайте ресурсы |
| Измерить канал DAR | Этот столбец был обновлен и теперь использует значение Получайте ресурсы |
Таргетинг на сайты – исключить Таргетинг на сайты – включить | Этот столбец был обновлен, чтобы идентифицировать сайты по строкам URL. |
Позиция
| v7 Инструкции по переносу столбцов | |
|---|---|
Таргетинг на приложения – исключить Таргетинг на приложения – включить | Эти столбцы были обновлены и теперь используют идентификаторы приложений в формате « Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставляемые соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple. |
| Мультипликаторы ставок | Этот столбец был обновлен и теперь использует новые идентификаторы критериев для типов строк приложений и сайтов . Тип строки приложения был обновлен и теперь в качестве идентификаторов критериев используется объединенные строковые значения платформы приложения и идентификатора платформы приложения, разделенные двоеточием. Платформы приложений идентифицируются строковым значением. Идентификаторы приложений — это идентификаторы, предоставляемые соответствующей платформой, например идентификатор пакета из магазина приложений Android или идентификатор приложения из магазина приложений Apple. Тип строки сайта был обновлен для использования строк URL-адресов в качестве идентификаторов критериев. |
Таргетинг на браузер – исключить Таргетинг на браузер – включить | Этот столбец был обновлен для использования значений Извлекайте ресурсы |
Таргетинг на операторов связи – исключить Таргетинг на операторов мобильной связи – включить | Этот столбец был обновлен для использования значений Извлекайте ресурсы |
Таргетинг на каналы – исключить Таргетинг на каналы – включить | Этот столбец был обновлен и теперь использует значение Получайте ресурсы |
Таргетинг на устройства – исключить Таргетинг на устройства – включить | Этот столбец был обновлен и теперь использует значения
Извлекайте ресурсы |
Таргетинг на сайты – исключить Таргетинг на сайты – включить | Этот столбец был обновлен, чтобы идентифицировать сайты по строкам URL. |
Медиа-продукт
| v7 Инструкции по переносу столбцов | |
|---|---|
Таргетинг на каналы – исключить Таргетинг на каналы – включить | Этот столбец был обновлен и теперь использует значение Получайте ресурсы |
| Таргетинг на устройства – включить | Этот столбец был обновлен и теперь использует значения
Извлекайте ресурсы |
Добавить интеграцию со столбцами, добавленными начиная с версии 6.
При переходе с версии 6 на версию 7 вам необходимо добавить в соответствующие файлы следующие столбцы:
| Тип файла | Столбец |
|---|---|
| Позиция | Целевой показатель частоты показов TrueView |
| Позиция | Временное окно целевой частоты TrueView |
| Группа объявлений YouTube | Оптимизированный таргетинг |
Если вы переходите с предыдущей версии файлов структурированных данных, обратитесь к примечаниям к выпуску файлов структурированных данных для получения информации о дополнительных столбцах, добавленных между вашей текущей версией и SDF v6.
Дополнительные изменения
В версии 7 мы также внесли некоторые поверхностные изменения, которые должны помочь вам упростить интеграцию и отказаться от использования устаревших файлов чтения сущностей для справки.
Новый порядок списка для подмножества столбцов.
SDF v7 гарантирует стабильный порядок определенных столбцов списка при создании файла. Это приводит к более последовательному поведению и упрощению проверки. Этот порядок не применяется при загрузке файла, но применяется впоследствии при создании обновленного файла.
Ознакомьтесь с примечаниями к выпуску v7 , чтобы получить полный список столбцов, которые теперь создаются в возрастающем числовом или алфавитном порядке.
Рекомендации по новому идентификатору
Мы обновили определения ряда столбцов, убрав ссылки на устаревшие файлы чтения сущностей и вместо этого порекомендовав другие способы поиска идентификаторов.
Значения, возвращаемые следующими столбцами, ничем не отличаются от значений в SDF версии 6, но мы предлагаем вам обновить интеграцию, чтобы получать идентификаторы с использованием нового рекомендуемого метода, который можно найти в описаниях столбцов версии 7.
| Типы файлов и их столбцы | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Кампания |
| |||||||||||||||||||||
| Заказ на размещение |
| |||||||||||||||||||||
| Позиция |
| |||||||||||||||||||||
| Медиа-продукт |
| |||||||||||||||||||||
| Группа объявлений YouTube |
| |||||||||||||||||||||