Структурированные данные – версия 11 – медиапродукт

Подробнее о формате…

ПолеОбязательноТипМожно редактироватьОписание
Идентификатор продуктаНетЦелое числоНетЧисловое значение идентификатора медиапродукта.
Идентификатор планаНетЦелое числоНетЧисловое значение идентификатора медиаплана.
Идентификатор кампанииНетЦелое числоНет
НазваниеДаstringДаНазвание записи.
ТипНетstringНетТип медиапродукта.
  • Медийная реклама на открытом аукционе
  • Аудиообъявления на открытом аукционе
  • Видеообъявление (открытый аукцион)
  • Кампания с просмотрами видео
  • Эффективный охват
  • Объявления TrueView In-Stream на YouTube
  • Объявления TrueView Discovery на YouTube
  • Заставки TrueView на YouTube
  • Кампании TrueView – охват на YouTube
  • Аудио YouTube
  • Заставки с возможностью пропуска и целевой частотой показа
  • Объявления без возможности пропуска с целевой частотой показа
  • С возможностью пропуска и целевой частотой показа
  • Заставки с целевой частотой показа
  • Заставки Google Preferred
  • Google Preferred Shorts
  • Google Preferred Long
  • Google Preferred: In-Stream без возможности пропуска (30 сек.)
  • Google Preferred YouTube Shorts
  • Короткие видео со стандартным резервированием
  • Стандартный длинный формат с резервированием
  • Объявление In-Stream без возможности пропуска
  • Частное (издатель)
  • Частный (источник инвентаря)
  • Частная (переговоры)
  • Создание спроса
Дата началаНетstringНетДата начала использования медиапродукта в формате ММ/ДД/ГГГГ ЧЧ:мм.
Дата окончанияНетstringНетДата окончания действия медиапродукта в формате ММ/ДД/ГГГГ ЧЧ:мм.
БюджетНетчисло с плавающей запятойНетПоложительное значение бюджета для медиапродукта. Это всегда число с плавающей запятой, поскольку бюджет всегда выражается в денежных единицах. Валюта будет показываться в валюте рекламодателя в стандартных единицах (не в миллионных долях единицы валюты).
Частота включенаДаstringДа
Показы с ограничением частотыОбязательно, если для параметра "Частота включена" задано значение TRUE.Целое числоДаПоложительное целое число, обозначающее количество показов за определенный период времени, то есть x в выражении "Показывать x объявлений за период y".
Период частотыОбязательно, если для параметра "Частота включена" задано значение TRUE.stringДа
  • минут
  • Часы
  • дней
  • Недели
  • Месяцы
  • За весь период
ЧастотаОбязательно, если для параметра "Частота включена" задано значение TRUE.Целое числоДа
Геотаргетинг – включениеНетстрока, списокДа

Список географических местоположений, которые нужно включить в таргетинг.

В этом столбце используются идентификаторы ресурсов TargetingOption API Дисплея и Видео 360 для типа таргетинга TARGETING_TYPE_GEO_REGION.

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в возрастающем числовом порядке.

Языковой таргетинг – включениеНетстрока, списокДа

Список языков, которые нужно включить в таргетинг.

В этом столбце используются идентификаторы ресурсов TargetingOption API Дисплея и Видео 360 для типа таргетинга TARGETING_TYPE_LANGUAGE.

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в порядке возрастания номеров.

Языковой таргетинг – исключениеНетстрока, списокДа

Список языков, исключенных из таргетинга.

В этом столбце используются идентификаторы ресурсов TargetingOption API Дисплея и Видео 360 для типа таргетинга TARGETING_TYPE_LANGUAGE.

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в возрастающем числовом порядке.

Таргетинг на каналы – включитьНетстрока, списокДа

Список каналов, которые нужно включить в таргетинг.

В этом столбце используются идентификаторы ресурсов Channel из Display & Video 360 API.

Формат списка: (Channel.channelId; Channel.channelId; и т. д.).

Таргетинг на каналы – исключениеНетстрока, списокДа

Список каналов, которые нужно исключить из таргетинга.

В этом столбце используются идентификаторы ресурсов Channel из Display & Video 360 API.

Формат списка: (Channel.channelId; Channel.channelId; и т. д.).

Тематический таргетинг – включениеНетстрока, списокДа

Список категорий, которые нужно включить в таргетинг. В этом столбце используются идентификаторы ресурсов TargetingOption API Дисплея и Видео 360 для типа таргетинга TARGETING_TYPE_CATEGORY.

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в порядке возрастания номеров.

Тематический таргетинг – исключениеНетстрока, списокДаСписок категорий, которые нужно исключить из таргетинга. В этом столбце используются идентификаторы ресурсов TargetingOption API Дисплея и Видео 360 для типа таргетинга TARGETING_TYPE_CATEGORY.

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в возрастающем числовом порядке.

Таргетинг на аудиторию – включениеНетстрока, список списков парДа

Список списков аудиторий, которые нужно включить в таргетинг.

В этом столбце используются идентификаторы ресурсов FirstPartyAndPartnerAudience из Display & Video 360 API.

В собственных списках аудиторий каждая аудитория представлена парой FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId и настройкой давности. Пара имеет вид (1;1d;), где 1d – это пример давности, представляющий давность в один день. Поскольку для сторонних аудиторий не поддерживается актуальность, формат списка будет следующим: (3;);(4;);. Чтобы объединить группы аудиторий с помощью операторов "И" и "ИЛИ", следуйте примеру: чтобы объединить пары с учетом и без учета давности, используйте следующий код: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. Это означает (список 1 с давностью 1 день ИЛИ список 2 с давностью 365 дней) И (список 3 без указанной давности ИЛИ список 4 с давностью 5 минут ИЛИ список 5 со всеми пользователями).

Допустимые значения давности:

  • все
  • 1 мин.
  • 5 мин.
  • 10 мин.
  • 15 мин.
  • 30 м
  • 1 ч.
  • 2 ч.
  • 3h
  • 6 часов
  • 12 ч.
  • 1 д.
  • 2 д.
  • 3D
  • 5 дн.
  • 7 дн.
  • 10 дн.
  • 14 дн.
  • 15 дн.
  • 21 дн.
  • 28 дн.
  • 30 дн.
  • 45 дн.
  • 60 дней
  • 90 дней
  • 120d
  • 180 дн.
  • 270 дн.
  • 365 дн.
Исключение целевой аудиторииНетстрока, список списков парДа

Список списков аудиторий, которые нужно исключить из таргетинга.

В этом столбце используются идентификаторы ресурсов FirstPartyAndPartnerAudience из Display & Video 360 API.

Каждая аудитория указана как пара FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId и настройка давности, если список аудитории является собственным. Пара имеет вид (1;1d;), где 1d – это пример давности, представляющий давность в один день. Однако для сторонних аудиторий дата последнего посещения недоступна, поэтому формат списка будет следующим: (3;);(4;);.

Формат списка: ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
Пример: "(1;1d;);(2;);".

Допустимые значения давности:

  • все
  • 1 мин.
  • 5 мин.
  • 10 мин.
  • 15 мин.
  • 30 м
  • 1 ч.
  • 2 ч.
  • 3h
  • 6 часов
  • 12 ч.
  • 1 д.
  • 2 д.
  • 3D
  • 5 дн.
  • 7 дн.
  • 10 дн.
  • 14 дн.
  • 15 дн.
  • 21 дн.
  • 28 дн.
  • 30 дн.
  • 45 дн.
  • 60 дней
  • 90 дней
  • 120d
  • 180 дн.
  • 270 дн.
  • 365 дн.
Таргетинг на аудитории по интересам и заинтересованных покупателей – включитьНетстрока, списокДа
Исключение аудиторий по интересам и заинтересованных покупателейНетстрока, списокДа
Демографический таргетинг: полНетстрока, списокДаСписок полов, на которые можно настроить таргетинг. Выберите одно или несколько допустимых значений:
  • Женский
  • Мужской
  • Неизвестно
Демографический таргетинг по возрастуНетстрока, списокДаТаргетинг на возрастной диапазон. Укажите диапазон, выбрав возраст "От" и "До", а также включите или отключите неизвестный возраст. Ознакомьтесь со списком допустимых значений возраста "От" и "До".
Пример 1. Чтобы настроить таргетинг на пользователей в возрасте от 18 до 55 лет и включить неизвестный возраст, укажите следующий формат: {От; До; Включить неизвестный возраст (истина/ложь)} = 18;55;истина;.
Пример 2. Чтобы настроить таргетинг только на пользователей старше 35 лет и исключить неизвестный возраст, укажите следующее: = 35;+;ложь;.
Допустимые значения для параметра "От":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

Допустимые значения для поля "Кому"
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
Демографический таргетинг: наличие детейДастрока, списокДаСписок родительских статусов, на которые нужно настроить таргетинг. Выберите одно или несколько допустимых значений.
  • Родитель
  • Без детей
  • Неизвестно
Таргетинг на устройства – включениеНетстрока, списокДа

Список устройств, на которые нужно настроить таргетинг.

В этом столбце используются идентификаторы ресурсов API Дисплея и Видео 360 TargetingOption для следующих типов таргетинга:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Формат списка: (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). Список генерируется в возрастающем числовом порядке.

Таргетинг на размер видеопроигрывателяНетстрока, списокДаСписок размеров проигрывателя видеообъявления, на который настроен таргетинг. Выберите одно или несколько допустимых значений:
  • неизвестно
  • маленький
  • большой
  • HD
Частный – название продавцаНетstringНетНазвание издателя в сделке. Это поле применяется только к частным медиапродуктам.
Частный – идентификатор заказаНетstringНетИдентификатор заказа гарантированной сделки. Это поле применяется только к частным медиапродуктам.
Частный – идентификатор источника инвентаряНетstringНетИдентификатор источника инвентаря в DBM. Это поле применяется только к частным медиапродуктам.