Структурированные данные – v7 – Медиа-продукт

Объяснение формата см. в обзоре .

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

Список географических регионов для включения в таргетинг.

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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

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

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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

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

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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

Список каналов для включения в таргетинг.

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

Формат списка = (Канал.channelId; Канал.channelId; и т. д.).

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

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

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

Формат списка = (Канал.channelId; Канал.channelId; и т. д.).

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

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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

Список списков аудитории для включения в таргетинг.

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

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

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

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

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

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

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

Формат списка = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; давность необязательно;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; давность необязательно;);)
Пример: "(1;1d;);(2;);".

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

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

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

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров.

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