Последнее обновление: 12 ноября 2024 г.
Это руководство проведет вас через процесс перехода с использования файлов структурированных данных версии 7.1 на версию 8 и объяснит изменения между двумя версиями, которые могут повлиять на вашу интеграцию.
См. примечания к выпуску для получения исчерпывающего списка различий между v7.1 и v8.
Перенесите версию файлов структурированных данных
Чтобы перейти на файлы структурированных данных (SDF) v8 из предыдущей версии:
- Обновите свои ресурсы и действия по созданию SDF, чтобы использовать версию 8.
- Обновите логику рекламного ресурса, чтобы определить тип при создании.
- Добавьте новую логику для чтения, создания и обновления ресурсов Demand Generation.
Обновить версию файлов структурированных данных
Чтобы использовать новую версию файлов структурированных данных, обновите назначенную версию в родительских ресурсах партнера и рекламодателя и используйте новую версию при создании отдельных задач загрузки в Display & Video 360 API .
Обновить настройки родительского ресурса
Версия файлов структурированных данных по умолчанию устанавливается на уровне ресурсов партнера и рекламодателя. Эта версия используется по умолчанию при загрузке файлов структурированных данных через интерфейс или API.
Установить в интерфейсе
На партнерском уровне
- Перейдите к предполагаемому партнеру.
- Разверните меню настроек партнера на панели навигации слева и перейдите на страницу «Основные сведения» .
- Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v8 .
На уровне рекламодателя
- Перейдите к нужному рекламодателю.
- Разверните меню настроек рекламодателя на панели навигации слева и перейдите на страницу основных сведений .
- Обновите конфигурацию версии SDF в разделе «Файлы структурированных данных» до v8 . Если версия по умолчанию установлена на уровне партнера, этот параметр нельзя изменить.
Установить в API
- На партнерском уровне
- Вы не можете установить версию SDF по умолчанию на уровне партнера в API.
- На уровне рекламодателя
- Отправьте запрос
advertisers.patch, чтобы обновитьdataAccessConfig.sdfConfig.sdfConfig.versionдоSDF_VERSION_8и, при необходимости,dataAccessConfig.sdfConfig.overridePartnerSdfConfigдоTrue.
Обновите запросы sdfdownloadtasks.create в API.
При создании запроса sdfdownloadtasks.create с помощью API Display & Video 360 установите для поля version тела запроса значение SDF_VERSION_8 .
Укажите тип в Рекламных ресурсах
Версия 8 добавляет в файлы объявлений столбец Ad Type , в котором указывается тип объявления, представленный в каждой строке. Этот новый столбец является обязательным и будет заполнен для существующих ресурсов при загрузке файлов объявлений v8.
При обновлении существующих объявлений значение этого столбца не должно меняться.
При создании новых объявлений вы должны заполнить этот столбец одним из значений, перечисленных в описании столбца.
Логика обновления для ресурсов формирования спроса
Версия 8 поддерживает создание, извлечение и обновление кампаний по формированию спроса с использованием позиций , групп объявлений и файлов объявлений . Ресурсы Demand Gen используют другую логику для проверки временных меток, требуют заполнения дополнительных столбцов и ограничены новыми ограничениями для трех типов файлов.
Проверка временной метки
Для всех позиций, не связанных с формированием спроса, столбец Timestamp файла позиции позиции заполняется при загрузке с указанием времени последнего изменения позиции. Это значение используется при обновлении позиции с помощью SDF, чтобы убедиться, что позиция не обновлялась с момента загрузки исходного файла. Если это так, обновление не удастся.
Для позиций формирования спроса столбец Timestamp и соответствующая проверка работают по-другому. Для записей позиций формирования спроса столбец заполняется текущим временем загрузки. При загрузке Дисплей и Видео 360 проверяет, прошло ли более 24 часов с момента указанной временной метки. Если прошло более 24 часов, исходная запись файла считается устаревшей и обновление не выполняется. Если это произойдет, загрузите файл еще раз и выполните обновления на основе более последней версии. Этот новый метод проверки не мешает вам перезаписывать изменения, внесенные за последние 24 часа. Чтобы избежать случайной перезаписи, включайте в загружаемые файлы только те позиции формирования спроса, которые вы хотите обновить.
Обязательные столбцы
Следующие типы файлов имеют столбцы, которые теперь необходимы для определенных ресурсов формирования спроса, в дополнение к столбцам, которые необходимы для всех объектов этого типа файлов.
Позиция
Обязательные столбцы для следующих значений столбца « Type статьи затрат» | ||||
| Спрос |
| |||
Объявление
Обязательные столбцы для следующих значений столбца Ad Type . | |||||||||
| Карусель формирования спроса |
| ||||||||
| Изображение спроса |
| ||||||||
| Спрос на продукт |
| ||||||||
| Видео по запросу |
| ||||||||
Обновленные ограничения
В дополнение к новым обязательным столбцам для определенных позиций и объявлений формирования спроса, несколько столбцов в типах файлов "Позиция " , "Группа объявлений" и "Объявление" имеют новые ограничения на использование, применимые к ресурсам формирования спроса.
Эти ограничения многочисленны и специфичны для рассматриваемых столбцов, поэтому в этом руководстве не представлен исчерпывающий список ограничений. Мы рекомендуем внимательно прочитать справочную документацию версии 8 для типов файлов «Позиция» , «Группа объявлений» и «Объявление» , прежде чем создавать или обновлять ресурсы формирования спроса с помощью загрузки SDF.