Структурированные данные — v9.2 — Позиции

Для ознакомления с форматом см. общий обзор .

Поле Необходимый Тип Записываемый Описание
Идентификатор позиции Требуется только при редактировании существующих позиций заказа. целое число Нет Числовое значение идентификатора позиции заказа. Если оставить поле пустым, будет создана новая позиция заказа и ей будет присвоен уникальный идентификатор. При создании новых позиций заказа можно использовать пользовательский идентификатор для назначения групп объявлений TrueView новой позиции заказа. Формат пользовательского идентификатора: "ext[пользовательский идентификатор]", например, ext123. После загрузки и обработки файла все пользовательские идентификаторы будут заменены идентификаторами, присвоенными DBM, и объекты будут связаны (например, группа объявлений с позицией заказа) на основе пользовательских идентификаторов.
Ио Ид Да целое число Нет Числовой идентификатор заказа на вставку. Вы можете указать пользовательский идентификатор (например, "ext[пользовательский идентификатор ввода-вывода]") для заказа на вставку, который вы создаете одновременно с этой позицией.
Имя ввода-вывода Нет нить Нет Название заказа на размещение
Тип Да нить Да Тип записи.

Запись возможна только при создании, редактирование — нет.

Выберите одно из следующих значений:
  • Отображать
  • Видео
  • TrueView
  • Аудио
  • Генерация спроса
Подтип Да нить Да Поле обязательно для указания позиций в списке, чтобы различать разные форматы.

Выберите одно из следующих значений:
  • Простой
  • Непропускаемый
  • Действие
  • Достигать
  • Вид
  • Аудио
  • Чрезмерно
  • Установка мобильного приложения
  • Покупка через мобильное приложение
  • Простой, но превосходный
  • Непропускаемый верхний
  • Перешагните через верх
  • Целевая частота
  • Генерация спроса
  • Видеопоследовательность

Функция «Действие» несовместима с позициями заказа TrueView.
Функция «Видеопоследовательность» доступна только для ограниченного списка клиентов Display & Video 360.
Имя Да нить Да Название записи.
Отметка времени Обязательно при редактировании существующих записей. целое число Нет Отметка времени для записи.
  • Для позиций, не относящихся к генерации спроса, это метка времени «последнего изменения», используемая системой для проверки того, что запись не изменилась в период между загрузкой и выгрузкой.
  • Для позиций, созданных с помощью Demand Gen, это метка времени генерации файла, используемая для проверки того, что позиция была загружена недавно, но не гарантирует, что позиция не была обновлена ​​с момента первоначальной загрузки.
Статус Да нить Да Статус записи.
  • Активный
  • Приостановлено
  • Черновик
  • Архив
Дата начала Да нить Да Отметка времени начала полета для записи в формате ММ/ДД/ГГГГ или "Совпадает с заказом на размещение", чтобы использовать ту же дату начала, что и в родительском заказе на размещение.
Дата окончания Да нить Да Отметка времени окончания полета для записи в формате ММ/ДД/ГГГГ или "То же, что и в заказе на размещение", чтобы использовать ту же дату окончания, что и в родительском заказе на размещение.
Тип бюджета Да нить Да Указывает, основан ли бюджет на денежных средствах или на показах. Если для этой записи включено автоматическое распределение бюджета, вы можете установить значение «Автоматический», чтобы DBM автоматически распределял бюджет для этой записи.
  • Количество
  • Впечатления
  • Без ограничений
  • Автоматический
  • Бюджетный вариант TrueView
Сумма бюджета Обязательно, если в поле "Тип" указано "Дисплей", "Видео" или "Аудио". плавать Да Положительная сумма бюджета для данного типа бюджета. Это может быть простое целое число, обозначающее количество показов, или число с плавающей запятой, указывающее сумму в валюте. Валюты будут отображаться в валюте рекламодателя в стандартных единицах (а не в 1/1 000 000 единиц валюты). Если для записи установлено автоматическое распределение бюджета, вы можете указать минимальную сумму расходов (например, «потратить не менее» этой суммы).
Темп Да нить Да

Период времени, затраченный на определение темпа выполнения задачи.

В функциях TrueView и Demand Gen можно использовать только позиции с пометками «Ежедневно» или «Авиабилет».

Темп Да нить Да Темп повествования в этой записи.

Выберите одно из следующих значений:
  • как можно скорее
  • Даже
  • Предстоящий

В функциях TrueView и Demand Gen позиции могут иметь только значения «Как можно скорее» или «Равно».

Темп Количество Обязательно, если в поле «Тип» указано «Дисплей», «Видео» или «Аудио». Обязательно, если в поле «Тип» указано «TrueView» или «Генерация спроса», а в поле «Режим работы» — «Ежедневно». плавать Да Сумма, которую необходимо потратить за определенный период времени, определяется типом темпа.
Включена частота Обязательно, если 'Подтип' не 'Генерация спроса'. нить Да Включает/отключает ограничение частоты показов для позиции заказа.

Выберите одно из следующих значений:
  • истинный
  • ЛОЖЬ
Воздействие частот Обязательно, если параметр "Frequency Enabled" имеет значение "TRUE". целое число Да Положительное целое число, обозначающее количество показов в заданном диапазоне частоты показов, то есть x в выражении «Показать x показов за период y».
Период частоты Обязательно, если параметр "Frequency Enabled" имеет значение "TRUE". нить Да Указывает единицу измерения периода времени для ограничения частоты.

Выберите одно из следующих значений:
  • Протокол
  • Часы
  • Дни
  • Недели
  • Месяцы

Для позиций TrueView и Demand Gen поддерживаются следующие периоды: дни, недели, месяцы.

Частота Количество Обязательно, если параметр "Frequency Enabled" имеет значение "TRUE". целое число Да Положительное целое число, обозначающее продолжительность периода частоты показов, то есть значение y в параметре «Показать x показов за период y». Это значение не поддерживается для позиций TrueView или Demand Gen.

Периоды ограничения частоты показов должны составлять не более 30 дней.
Частота просмотра TrueView включена Обязательно, если "Type" имеет значение "TrueView". нить Да Включает/отключает ограничение частоты показов на основе представлений для позиции TrueView.
  • истинный
  • ЛОЖЬ
Частота экспозиции TrueView View Обязательно, если параметр "TrueView View Frequency Enabled" имеет значение "TRUE". целое число Да Положительное целое число, обозначающее количество просмотров TrueView, то есть x в выражении «Показать x просмотров за период».
Период частоты просмотра TrueView Обязательно, если параметр "TrueView View Frequency Enabled" имеет значение "TRUE". нить Да Указывает единицу измерения временного периода для ограничения частоты отображения TrueView.
  • Дни
  • Недели
  • Месяцы
Партнерская модель получения дохода Нет нить Да Модель дохода от партнеров — это механизм, определяющий порядок расчета дохода в Bid Manager. Используйте модель дохода от партнеров для отслеживания наценки на ваши сервисные сборы. При включении столбца «Модель дохода от партнеров» необходимо указать значение в столбце «Сумма дохода от партнеров».
  • TMCM - Наценка на общую стоимость медиарекламы
  • MCM - Наценка на стоимость медиарекламы
  • CPM — Стоимость за тысячу показов
Сумма дохода от партнеров Требуется только при указании столбца «Модель получения дохода от партнеров». плавать Да Положительное значение с плавающей запятой, соответствующее модели получения дохода от партнеров. Применимо только при указании столбца «Модель получения дохода от партнеров».
Тип подсчета конверсий Да нить Да Выберите типы конверсий, которые будут учитываться.
  • Подсчитайте все
  • Подсчет кликов после публикации
  • Считать %
Процент конверсии Да плавать Да Укажите процентное значение для типа подсчета «Процентное значение количества». Форматируйте процент как число с плавающей запятой (3,123% = 3,123), с точностью до тысяч (3 знака после запятой).
Идентификаторы активности прожектора преобразования Нет строка, список списков Да

Действия, связанные с подсветкой, используемые для преобразований и соответствующих настроек.

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

Формат списка = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);).

Это поле нельзя обновить, если в столбце «Идентификатор алгоритма» задан соответствующий параметр. Попытки обновления приведут к ошибке.

Идентификатор основной модели атрибуции Нет целое число Да Идентификатор модели атрибуции, используемый для соответствующей позиции заказа.
Сборы Нет строка, список списков Да Все сборы по данной записи. Формат списка = (Категория сбора; Сумма сбора; Тип сбора; Выставлен счет;).
  • Категория платы
    • CPM
    • СМИ
  • Сумма сбора
    • Плавать
    • Процент в плавающем состоянии
  • Тип платы
    • (строка, см. таблицу в разделе "Стоимость услуг")
  • Выставлен счет
    • Истинный
    • ЛОЖЬ
    • пустой

Пример: '(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
Допустимые значения приведены в следующей таблице:

Категория платы Тип оплаты Вариант с выставлением счета
CPM/Медиа По умолчанию Не разрешено (оставьте поле пустым)
CPM/Медиа Сторонний рекламный сервер Не разрешено (оставьте поле пустым)
CPM/Медиа DoubleVerify Разрешено (Верно/Неверно)
CPM/Медиа Adsafe Не разрешено (оставьте поле пустым)
CPM/Медиа Adxpose Не разрешено (оставьте поле пустым)
CPM/Медиа Визу Не разрешено (оставьте поле пустым)
CPM/Медиа Совокупные знания Не разрешено (оставьте поле пустым)
CPM/Медиа Терацент Не разрешено (оставьте поле пустым)
CPM/Медиа Доказательство Не разрешено (оставьте поле пустым)
CPM/Медиа Комиссия агентства за услуги торгового отдела Не разрешено (оставьте поле пустым)
CPM/Медиа Адлукс Разрешено (Верно/Неверно)
CPM Поддерживайте местных производителей Обязательно (Верно)
CPM TrustMetrics Не разрешено (оставьте поле пустым)
CPM Видео Integral Ad Science Разрешено (Верно/Неверно)
CPM Видео MOAT Не разрешено (оставьте поле пустым)
СМИ Плата за отображение и видео 360° Обязательно (Верно)
СМИ Данные о стоимости медиа Не разрешено (оставьте поле пустым)
СМИ Плата Scibids Обязательно (Верно)
Интеграционный код Нет нить Да Дополнительный код для отслеживания.
Подробности Нет нить Да Данные записи представлены в строковом формате.
Тип стратегии подачи заявок Обязательно, если в поле "Тип" указано "Дисплей", "Видео" или "Аудио". нить Да Выберите одну из подходящих стратегий подачи заявок:
  • Минимизация: при расходовании всего бюджета минимизируйте затраты на оплату труда бухгалтеров и профессиональных консультантов.
  • Максимизация: Используя весь бюджет, максимизируйте ценность или качество впечатления.
  • Превзойти: Достичь или превзойти целевой показатель X CPA/CPC
  • Оптимизация vCPM: Оптимизация для видимой ставки CPM в размере X.
  • Фиксированная ставка: укажите фиксированную ставку в размере X.
Ценность стратегии подачи заявок Обязательно, если для параметра «Тип стратегии ставок» не выбрано значение «Минимизировать», «Максимизировать» или для параметра «Тип» не выбрано значение «TrueView». плавать Да Для параметра Beat выберите Optimize VCPM, Fixed strategy types и значение целевой ставки.
Обратите внимание, что для типов стратегий ставок «Минимизация» или «Максимизация» значение стратегии назначения ставок не требуется.
Отдел стратегии участия в тендерах Требуется, если "Тип стратегии ставок" - "Превзойти", "Минимизировать" или "Максимизировать". нить Да Для типов стратегий «Превзойти», «Минимизировать» или «Максимизировать» выберите соответствующую единицу измерения:
  • Сертифицированный бухгалтер (CPA)
  • КПК
  • Индивидуальная улучшенная ценность/стоимость
  • ЦИВА
  • IVO_TEN
  • AV_VIEWED
  • ДОСТИГАТЬ
Стратегия подачи заявок: Не превышайте Обязательно, если в поле "Тип" указано "Дисплей", "Видео" или "Аудио". плавать Да Установите значение CPM, которое нельзя превышать. Если значение равно 0, функция «не превышать» отключена. Эта функция доступна только в том случае, если стратегия назначения ставок — «Минимизировать», «Максимизировать» или «Превысить».
Применяйте минимальную цену для выгодных предложений. Требуется, если "Тип стратегии торгов" - "Минимизация" или "Максимизация". нить Да Стоит ли отдавать приоритет сделкам перед товарами, выставленными на открытый аукцион?
  • истинный
  • ЛОЖЬ
Идентификатор алгоритма Требуется при настройке стоимости/затрат подразделения «Стратегия подачи заявок». целое число Да

Этот идентификатор алгоритма необходимо использовать, если для параметра «Благотворительная стратегия» установлено пользовательское значение/стоимость улучшения.

Все действия с прожекторами, используемые в алгоритме, назначенном этому столбцу, должны быть включены в столбец «Идентификаторы действий с прожекторами при конвертации». Попытки назначить алгоритм без надлежащего обновления столбца «Идентификаторы действий с прожекторами при конвертации» приведут к ошибке.

Творческие задания Нет строка, список Да

Список идентификаторов креативов, которые будут присвоены данной записи.

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

Формат списка = (Creative.creativeId; Creative.creativeId; и т. д.). Этот список генерируется в порядке возрастания номера.

При загрузке пользователи также могут указать идентификаторы размещения Campaign Manager 360. Идентификаторы размещения должны предшествовать буквам «CM», например, «CM789».

Пример (123;CM789;).

Содержит политическую рекламу ЕС. Да нить Да

Используется ли эта статья расходов для размещения политической рекламы Европейского союза.

Если вы указали, что данный рекламодатель не размещает политическую рекламу в ЕС, новым позициям будет присвоено значение «Нет», если соответствующий столбец не задан.

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

  • Да
  • Нет
  • Не задано
Основной статус Нет нить Нет

Основной статус записи.

Возможны следующие статусы:

  • Имеющий право
  • Не подходит
  • Приостановлено
  • Удаленный
  • Завершено
  • Ограниченный
  • В ожидании
  • Неправильная настройка
Основная причина статуса Нет нить Нет

Причина текущего первичного статуса.

  • Группа активистов приостановила свою деятельность.
  • Бюджеты всех групп предвыборной кампании были завершены.
  • Кампания завершилась.
  • Кампания приостановлена
  • Кампания находится в процессе завершения.
  • Кампания удалена
  • Нет групп объявлений
  • Отклонены ли объявления?
  • Реклама ограничена в соответствии с политикой.
  • Нет групповых объявлений
  • Большинство объявлений находятся на рассмотрении.
  • Нет критериев для групп объявлений мобильных приложений
  • Изучение стратегии торгов
  • Отсутствует таргетинг по местоположению
Уровень таргетинга по географическому признаку и языку для генерации спроса Обязательно, если в поле «Тип» указано «Генерация спроса». нить Да Уровень, на котором задаются параметры таргетинга по местоположению и языку для кампаний по генерации спроса. Этот столбец не следует задавать для позиций, не относящихся к генерации спроса. Этот столбец является неизменяемым после создания.
  • Позиция
  • Группа объявлений
Географический таргетинг - Включает в себя Нет строка, список Да

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

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

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

Если в столбце «Тип» установлено значение «Генерация спроса», этот столбец доступен только в том случае, если для позиции заказа в пользовательском интерфейсе задан уровень таргетинга по географическому признаку и языку.

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

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

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

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

Если в столбце «Тип» установлено значение «Генерация спроса», этот столбец доступен только в том случае, если для позиции заказа в пользовательском интерфейсе задан уровень таргетинга по географическому признаку и языку.

Целевой географический региональный список местоположений - Включает Нет строка, список Да Список идентификаторов географических местоположений для включения. Формат списка = (11; 22; 33;).
Целевой поиск по географическому региону - исключение Нет строка, список Да Список идентификаторов географических местоположений для исключения. Формат списка = (11; 22; 33;).
Целенаправленное наведение на расстоянии Нет строка, список списков Да

Список ближайших объектов в формате "(Широта; Долгота; Радиус; Единица измерения; Полный адрес;);". Широта — от -90 до 90 градусов (включительно); Долгота — от -180 до 180 градусов (включительно); Радиус — расстояние от 1 до 500 (включительно) в единицах измерения; Единица измерения может быть "миля" или "км"; Полный адрес необязателен. Например: "(38.907192; -77.03687; 1.0; миля; Вашингтон, округ Колумбия, США;); (40.712775; -74.005972; 20.5; км; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; миля; ;);".

Если в столбце «Тип» установлено значение «Генерация спроса», этот столбец доступен только в том случае, если для позиции заказа в пользовательском интерфейсе задан уровень таргетинга по географическому признаку и языку.

Таргетинг по спискам местоположений по близости Нет строка, список списков Да Список целевых объектов по близости для заказов на размещение рекламы или позиций, не относящихся к категории TrueView, каждый в формате "(ProximityListId; Radius; Unit; );". ProximityListId — это идентификатор списка местоположений в ресурсах рекламодателя. Radius — это расстояние от 1 до 500 (включительно) в единицах измерения; Unit может быть "миля" или "км"; существует ограничение на таргетирование двух списков местоположений на один объект, а также региональных списков местоположений. Например: "(10041691678; 20.0; mi;); (10038858567; 20.5; km;);".
Целевая языковая настройка - Включить Нет строка, список Да

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

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

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

Если в столбце «Тип» установлено значение «Генерация спроса», этот столбец доступен только в том случае, если для позиции заказа в пользовательском интерфейсе задан уровень таргетинга по географическому признаку и языку.

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

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

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

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

Недоступно, если параметр 'Type' имеет значение 'TrueView' или 'Demand Gen'.

Целевое назначение устройств - Включает в себя Нет строка, список Да

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

Целевая аудитория по устройствам - Исключить Нет строка, список Да

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

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

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

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

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

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

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

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

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

Метки цифрового контента - Исключить Нет строка, список Да Список меток цифрового контента, которые следует исключить. Формат списка = (G;PG; и т. д.).
  • Г
  • PG
  • Т
  • МА
  • ?
Настройка чувствительности к безопасности бренда Нет нить Да Выберите параметр чувствительности, чтобы блокировать рекламные места в зависимости от тематики окружающего контента.
  • Не блокировать
  • Используйте проверку Campaign Manager 360.
  • Использовать пользовательские
Пользовательские настройки безопасности бренда Обязательно, если в разделе «Пользовательские настройки безопасности бренда» установлено значение «Использовать пользовательские настройки». строка, список Да Если в настройках конфиденциальности информации о бренде установлено значение «Использовать пользовательские настройки», укажите список стандартных классификаторов контента. Например, (Сексуальная тематика; Алкоголь; Табак; и т. д.).
  • Сексуальный
  • уничижительный
  • Загрузки и обмен
  • Оружие
  • Играть в азартные игры
  • Насилие
  • намекающий
  • Нецензурная лексика
  • Алкоголь
  • Наркотики
  • Табак
  • Политика
  • Религия
  • Трагедия
  • Транспортные аварии
  • деликатные социальные вопросы
  • Шокирующий
Услуги сторонней проверки Нет нить Да Сторонний поставщик услуг по проверке.
  • Никто
  • Интегральная рекламная наука
  • DoubleVerify
  • Адлукс
Маркировка сторонней проверки Нет строка, список Да Если параметр «Службы проверки сторонних поставщиков» не равен «Нет», укажите список меток , поддерживаемых выбранным поставщиком.
Таргетинг по каналам — Включить Нет строка, список Да

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

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

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

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

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

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

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

Таргетинг по сайту - Включает в себя Нет строка, список Да

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

Формат списка = (someurl.com; someurltwo.com; и т. д.). Этот список генерируется в алфавитном порядке по возрастанию.

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

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

Формат списка = (someurl.com; someurltwo.com; и т. д.). Этот список генерируется в алфавитном порядке по возрастанию.

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

Список приложений для включения в таргетинг. Список представляет собой объединенные строки, содержащие название платформы приложения и идентификатор платформы приложения.

Для определения платформы приложения используются следующие значения:

  • APP (Это включает в себя как магазин приложений Android Play, так и магазин приложений Apple App Store)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
Идентификатор предоставляется соответствующей платформой, например, идентификатор пакета из магазина Play для Android (например: com.google.android.gm) или идентификатор приложения из магазина App Store для Apple (например: 422689480).

Объединенная строка, состоящая из платформы приложения и его идентификатора, разделяется двоеточием, например: APP:com.google.android.gm .

Формат списка = (APP:com.google.android.gm; APP:422689480; и т. д.). Этот список генерируется в алфавитном порядке по возрастанию.

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

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

Для определения платформы приложения используются следующие значения:

  • APP (Это включает в себя как магазин приложений Android Play, так и магазин приложений Apple App Store)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
Идентификатор предоставляется соответствующей платформой, например, идентификатор пакета из магазина Play для Android (например: com.google.android.gm) или идентификатор приложения из магазина App Store для Apple (например: 422689480).

Объединенная строка, состоящая из платформы приложения и его идентификатора, разделяется двоеточием, например: APP:com.google.android.gm .

Формат списка = (APP:com.google.android.gm; APP:422689480; и т. д.). Этот список генерируется в алфавитном порядке по возрастанию.

Таргетирование коллекции приложений - Включая Нет строка, список Да

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

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.).

Целевая настройка коллекции приложений - исключение Нет строка, список Да

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

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

Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.).

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

Список категорий для включения в таргетинг. В этом столбце используются идентификаторы ресурсов 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 TargetingOption для типа таргетинга TARGETING_TYPE_CONTENT_GENRE

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

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

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

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

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

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

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

Этот список составлен в алфавитном порядке по возрастанию.

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

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

Этот список составлен в алфавитном порядке по возрастанию.

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

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

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

Формат списка = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; и т. д.). Этот список генерируется в порядке возрастания номеров.

Оптимизация фиксированных ставок Обязательно, если для параметра «Тип стратегии подачи заявок» установлено значение «Фиксированный». нить Да

Позволяет установить цену за позицию в вашем заказе ниже фиксированной ставки.

В этом столбце необходимо либо не задавать значение, либо установить значение «TRUE», если только для параметра «Тип стратегии торгов» не установлено значение «Фиксированный».

  • истинный
  • ЛОЖЬ
Оптимизированное наведение на цель Нет нить Да Включите оптимизированный таргетинг.
  • истинный
  • ЛОЖЬ

Оптимизированный таргетинг несовместим со всеми стратегиями назначения ставок. В этом столбце должно быть значение «FALSE», если:
  • «Тип стратегии подачи заявок» — «Фиксированный».
  • «Тип стратегии ставок» — «Оптимизированный vCPM».
  • В поле «Тип стратегии торгов» указано «Максимальный», а в поле «Единица стратегии торгов» — «CIVA», «IVO_TEN» или «AV_VIEWED».
Таргетинг аудитории - Включить Нет строка, список списков пар Да

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

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

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

Формат списка = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)

Пример: "(1;1d;);(2;);".

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

  • все
  • 5 м
  • 10 м
  • 15 м
  • 30 м
  • 1 ч
  • 2 ч
  • 3 ч
  • 6 ч
  • 12 ч
  • 2d
  • 3d
  • 5d
  • 7d
  • 10д
  • 14д
  • 15д
  • 21д
  • 28д
  • 30д
  • 45д
  • 60д
  • 90д
  • 120д
  • 180д
  • 270д
  • 365д

Если в поле «Подтип» указано «Видеопоследовательность», список будет содержать только идентификаторы аудитории в формате списка (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; и т. д.).

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

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

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

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

Формат списка = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)

Пример: "(1;1d;);(2;);".

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

  • все
  • 5 м
  • 10 м
  • 15 м
  • 30 м
  • 1 ч
  • 2 ч
  • 3 ч
  • 6 ч
  • 12 ч
  • 2d
  • 3d
  • 5d
  • 7d
  • 10д
  • 14д
  • 15д
  • 21д
  • 28д
  • 30д
  • 45д
  • 60д
  • 90д
  • 120д
  • 180д
  • 270д
  • 365д

Если в поле «Подтип» указано «Видеопоследовательность», список будет содержать только идентификаторы аудитории в формате списка (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; и т. д.).

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

Список целевых аудиторий и/или аудиторий, находящихся на рынке, которые следует включить.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

Таргетинг по интересам и на рынке (исключая) Нет строка, список Да

Список целевых аудиторий и/или аудиторий, находящихся на рынке, которые следует исключить.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

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

Список лиц, присутствующих на важных событиях в жизни, которые следует включить.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

Действительно только в том случае, если параметр 'Type' равен 'TrueView' или 'Demand Gen'.

Целевой маркетинг по жизненным событиям — исключение Нет строка, список Да

Список списков аудитории, относящихся к важным событиям в жизни, которые следует исключить.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

Действительно только в том случае, если параметр 'Type' равен 'TrueView' или 'Demand Gen'.

Детальный таргетинг по демографическим данным - Включает в себя Нет строка, список Да

Список подробных списков целевой аудитории для включения в демонстрационный материал.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

Действительно только в том случае, если параметр 'Type' равен 'TrueView' или 'Demand Gen'.

Детальный таргетинг по демографическим данным - Исключить Нет строка, список Да

Список подробных данных целевой аудитории для исключения из выборки.

Идентификаторы списков аудитории можно получить в интерфейсе Display & Video 360.

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

Действительно только в том случае, если параметр 'Type' равен 'TrueView' или 'Demand Gen'.

Комбинированный таргетинг аудитории Нет строка, список Да

Список объединенных целевых аудиторий.

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

Формат списка = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; и т. д.). Этот список генерируется в порядке возрастания номера.

Таргетинг по пользовательским спискам Нет строка, список Да

Список пользовательских списков для целевого воздействия.

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

Формат списка = (CustomList.customListId; CustomList.customListId; и т. д.). Этот список генерируется в порядке возрастания номера.

Целевой поиск поставщиков товаров — варианты для авторизованных продавцов Обязательно, если в поле "Тип" указано "Дисплей", "Видео" или "Аудио". нить Да Настройка таргетинга: авторизованные прямые продавцы, авторизованные прямые продавцы и реселлеры, или авторизованный продавец + неизвестный. "Авторизованные прямые продавцы" означает, что таргетинг будет осуществляться только на авторизованных продавцов. "Авторизованные прямые продавцы и реселлеры" означает таргетинг на авторизованных продавцов и реселлеров. "Авторизованный и не участвующий издатель" означает таргетинг на авторизованных продавцов, реселлеров и неизвестных продавцов.
  • Авторизованные прямые продавцы
  • Авторизованные прямые продавцы и реселлеры
  • Авторизованный и не участвующий издатель
Целевое позиционирование источников запасов - Включает в себя Обязательно, если в поле "Тип" указано "Дисплей", "Видео" или "Аудио". строка, список Да

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

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

Формат списка = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; и т. д.)

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

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

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

Формат списка = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; и т. д.)

Целевой поиск поставщиков товаров — работа с новыми биржами Нет нить Да Настройка для целевого поиска новых бирж.
  • Истинный
  • ЛОЖЬ
Целевая аудитория частных инвестиционных групп включает в себя: Нет строка, список Да

Список идентификаторов групп сделок для включения в таргетинг. Идентификаторы групп сделок можно найти в разделе «Группы сделок» в разделе «Мой инвентарь» и в разделе «Группы» в настройках источника инвентаря в позициях заказа, заказах на размещение и кампаниях.

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

Таргетинг по времени суток Нет строка, список Да

Список идентификаторов, где каждый идентификатор части дня формируется в следующем формате:

daypart_id = base_dayparting_id + (days_since_monday * 10000) + (start * 100) + end

Пределы переменных:

  • base_dayparting_id = 300000
  • количество дней с понедельника: 0 = понедельник, 1 = вторник, ..., 6 = воскресенье
  • start: 0..95 (00:00--23:45) — целое число от 0 до 95, обозначающее 15-минутные интервалы.
  • end: 1..96 (00:15--24:00); целое число от 0 до 95, обозначающее 15-минутные интервалы.
  • начало < конец

Для новых сущностей время будет установлено в часовом поясе ваших пользователей (т.е., "Локальный"). Для существующих сущностей часовой пояс изменяться не будет.

Этот список составлен в порядке возрастания номера.

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

Выберите одно из следующих значений:
  • Местный
  • Рекламодатель

В позициях TrueView и Demand Gen может быть указан только статус «Рекламодатель».

Целевое воздействие на окружающую среду Нет строка, список Да Список целевых сред. Выберите одно или несколько допустимых значений. Обратите внимание, что вариант «Веб не оптимизирован» нельзя выбрать, не выбрав вариант «Веб».
  • Веб
  • Веб-сайт не оптимизирован.
  • Приложение
Включено таргетинговое наведение Omid для повышения видимости Нет нить Да Позволяет нацеливать рекламу только на те показы, которые можно измерить с помощью открытого стандарта Measurement. Если объект не поддерживает таргетинг по OMID, оставьте этот столбец пустым.
  • истинный
  • ЛОЖЬ

Если таргетинг OMID включен на уровне рекламодателя и поддерживается для сущности, этому столбцу нельзя присвоить значение «FALSE». Если это значение не задано при создании ресурса для поддерживаемой сущности, по умолчанию будет использоваться значение, заданное на уровне рекламодателя.
Таргетинг видимости Активный просмотр Нет нить Да Целевые прогнозируемые проценты видимости. Проценты представлены в виде чисел с плавающей запятой. Один из значений: {0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9}
Позиционное наведение — на экране Нет строка, список Да Таргетинг по позициям экранной рекламы. Выберите одно или несколько допустимых значений:
  • Над линией сгиба
  • Ниже, под сгибом
  • Неизвестный
Таргетинг по позиции — позиция отображения в контенте Нет строка, список Да Позиции рекламного контента для таргетинга. Выберите одно или несколько допустимых значений:
  • В статье
  • Входящий поток
  • Встроенный баннер
  • Интерстициальный
  • Неизвестный
Таргетинг по позиции — Позиция видео в контенте Нет строка, список Да Позиции видеорекламы для таргетирования. Выберите одно или несколько допустимых значений:
  • В статье
  • Входящий поток
  • Встроенный баннер
  • Интерстициальный
  • Неизвестный исходящий поток
  • Предварительно скрученный джойнт
  • Средний рулон
  • Пост-ролл
  • Неизвестный поток
Целевое позиционирование — позиционирование звука в контенте Нет строка, список Да Позиции размещения аудиорекламы для таргетирования. Выберите одно или несколько допустимых значений:
  • Предварительно скрученный джойнт
  • Средний рулон
  • Пост-ролл
  • Неизвестный
Целевой размер видеоплеера Нет строка, список Да Список размеров видеоплееров для таргетирования. Выберите одно или несколько допустимых значений:
  • неизвестный
  • маленький
  • большой
  • HD
Таргетинг по продолжительности контента Нет строка, список Да Список целевых значений продолжительности контента. Единица измерения — минуты. Выберите одно или несколько допустимых значений:
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • неизвестный
Таргетинг по типу потока контента Нет строка, список Да Список типов потоков контента для выбора целевой аудитории. Выберите одно или несколько допустимых значений:
  • прямая трансляция
  • по требованию
Таргетинг по типам аудиоконтента Нет строка, список Да List of audio content type to target. Select one or more of the acceptable values:
  • неизвестный
  • online radio
  • streaming music
  • подкасты
Demographic Targeting Gender Нет string, list Да List of genders to target. Select one or more of the acceptable values:
  • Женский
  • Мужской
  • Неизвестный
Demographic Targeting Age Нет string, list Да Target to a user age range. Specify a from/to range by selecting a single From age and a single To age and whether to include unknown ages true/false. See the list of acceptable From/To ages.
Example 1: to target 18-55 and include unknown ages, specify the format {From; To ; Include unknown True/False} = 18;55;true;
Example 2: to target only users >35 years old and exclude unknown ages, specify the following = 35;+;false;.
Acceptable values for From:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

Acceptable values for To:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +

If 'Subtype' is 'Video Sequence', the column will contain a list of the following age range values:

  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55-64
  • 65+
  • Неизвестный

List format = (18-24; 25-34; etc.).

Demographic Targeting Household Income Нет string, list Да Target a household income range. Specify a from/to range by selecting a single Top_of_Range income range and a single Bottom_of_Range income range and whether to include households with unknown income true/false. See the list of acceptable Top_of_Range/Bottom_of_Range ranges.
Example 1: to target the top 10% to 50% of households and include households with unknown income, specify the format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
Example 2: to target only the lower 50% of households and exclude households with unknown income, specify the format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Acceptable values for Top_of_Range/Bottom_of_Range:
  • 10% лучших
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • Lower 50%

If 'Subtype' is 'Video Sequence', the column will contain a list of the following household income range values:

  • 10% лучших
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • Lower 50%
  • Неизвестный

List format = (Top 10%; 11-20%; etc.).

Demographic Targeting Parental Status Да string, list Да List of parental status to target. Select one or more of the acceptable values.
  • Родитель
  • Not a parent
  • Неизвестный
Connection Speed Targeting Нет нить Да Target to a specific connection speed. Select one of the acceptable values:
  • Все
  • 2G
  • 3G
  • ДСЛ
  • 4G
Carrier Targeting - Include Нет string, list Да

List of ISPs or Carriers to target.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CARRIER_AND_ISP .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Carrier Targeting - Exclude Нет string, list Да

List of ISPs or Carriers to exclude.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CARRIER_AND_ISP .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Placement Targeting - YouTube Channels - Exclude Нет string, list Да

List of YouTube channels to exclude.

List format = (YouTube Channel ID; YouTube Channel ID; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - YouTube Videos - Exclude Нет string, list Да

List of YouTube videos to exclude.

List format = (YouTube Video ID; YouTube Video ID; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - Popular Content - Exclude Нет string, list Да

List of popular content across YouTube and Google video partners to exclude. Individual content groupings should have the structured 'video_content:: Content Grouping ID '.

List format = (video_content:: Content Grouping ID ; video_content:: Content Grouping ID ; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - URLs - Exclude Нет string, list Да

List of URLs to exclude in targeting. The list consists of URL strings.

List format = (someurl.com; someurltwo.com; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - Apps - Exclude Нет string, list Да

List of mobile apps to exclude in targeting. The list consists of app platform IDs.

The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480).

List format = (com.google.android.gm; 422689480; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - App Collections - Exclude Нет string, list Да

List of app collections to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

TrueView Video Ad Formats Yes for TrueView Line Items нить Да The video ad format of the line item.

Skippable / In-feed Video are TrueView video ad types sold on a CPV basis. Non skippable video ads are in-stream ads between 6 and 15 seconds sold on a CPM basis. Skippable / Bumper / Non-skippable video ads are acceptable TrueView video ad types for line items with a 'Target Frequency' or 'Video Sequence' subtype sold on a CPM basis. Responsive video ads are ad types that serve as multiple formats.
  • Skippable
  • Skippable / In-feed Video
  • Non Skippable
  • Skippable / Bumper / Non-skippable
  • Адаптивный
TrueView Bid Strategy Type Required for TrueView and Demand Gen line items нить Да The bid strategy used by a TrueView or Demand Gen line item.

Select one of the following values:
  • Manual CPV: Manual view-based bidding where you pay per view.
  • Manual CPM: Manual impression-based bidding where you pay per thousand impressions. This value is not supported for new Trueview or Demand Gen line items.
  • Target CPM: Automated bid strategy that optimizes bids to help get as many impressions as possible using a target amount for how much you're willing to pay every thousand times your ad is shown.
  • Maximize Conversions: Automated bid strategy that optimizes bids to help get as many conversions as possible.
  • Target CPA: Automated bid strategy that optimizes bids to help get as many conversions as possible using a target amount for how much you're willing to pay per conversion.
  • Maximize Conversion Value: Automated value-based bidding strategy that optimizes for the higher value conversions.
  • Target ROAS: A value-based bidding strategy that optimizes for higher value of a conversion.
  • Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget
TrueView Bid Strategy Value Required for TrueView and Demand Gen line items плавать Да For the Target CPA or Target ROAS bid strategy type, choose a value for the target bid. For the other "TrueView Bid Strategy Type" values or other line item types, this column should be 0 when uploading. For Target ROAS, this column should be the percentage as a fraction, eg, if you want Target ROAS to be 150%, put 1.5 to this column.
TrueView Mobile Bid Adjustment Option Нет нить Да The direction in which to adjust bids for display on mobile devices.
  • Увеличивать
  • Снижаться
TrueView Mobile Bid Adjustment Percentage Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions' целое число Да

Bid adjustment to increase chances of showing ads on mobile. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%.

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Desktop Bid Adjustment Option Нет нить Да The direction in which to adjust bids for display on desktop devices.
  • Увеличивать
  • Снижаться
TrueView Desktop Bid Adjustment Percentage Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions' целое число Да

Bid adjustment to increase chances of showing ads on desktop. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%.

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Tablet Bid Adjustment Option Нет нить Да The direction in which to adjust bids for display on tablets.
  • Увеличивать
  • Снижаться
TrueView Tablet Bid Adjustment Percentage Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions' целое число Да

Bid adjustment to increase chances of showing ads on tablet. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%.

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Connected TV Bid Adjustment Option Нет нить Да The direction in which to adjust bids for display on connected TVs.
  • Увеличивать
  • Снижаться
TrueView Connected TV Bid Adjustment Percentage Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions' целое число Да

Bid adjustment to increase chances of showing ads on connected TVs. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%.

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Category Exclusions Targeting Нет string, list Нет List of categories to exclude. List format = Embedded Videos; Families; etc.
  • Embedded Videos
  • Прямая трансляция
  • Игры
  • Семьи
Inventory Mode Нет нить Нет TrueView or Demand Gen content filter.

Select one of the following values:
  • Ограниченный
  • Стандарт
  • Расширенный
TrueView Inventory Source Targeting Нет string, list Да

Lists of TrueView inventory sources to include

  • YouTube
  • Google ТВ
  • Video Partners

'Video Partners' must be included for Demand Gen line items.

TrueView Third-Party Viewability Vendor Required only when updating existing 'TrueView' or 'Demand Gen' line items string, list of lists Да Third-party vendor measuring viewability for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen line item creation and there is a default viewability vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.

Select one of the following values:
  • Никто
  • Ров
  • DoubleVerify
  • Integral Ad Science
TrueView Third-Party Viewability Reporting ID Yes when third-party viewability vendor is not 'None' нить Да ID used by your third-party viewability vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty.
TrueView Third-Party Brand Safety Vendor Required only when updating existing TrueView or Demand Gen line items string, list of lists Да Third-party vendor measuring brand safety for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen line item creation and there is a default brand safety vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.

Select one of the following values:
  • Никто
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView Third-Party Brand Safety Reporting ID Yes when third-party brand safety vendor is not 'None' нить Да ID used by your third-party brand safety vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty.
TrueView Third-Party Reach Vendor Required only when updating existing TrueView or Demand Gen line items string, list of lists Да Third-party vendor measuring reach for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen line item creation and there is a default reach vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.

Select one of the following values:
  • Никто
  • Нильсен
  • Comscore
  • Kantar
  • Гемиус
  • Видеоисследование
  • Media Scope
  • Audience Project
  • iSpot TV
  • VideoAmp
TrueView Third-Party Reach Reporting ID Yes when third-party reach vendor is not 'None' нить Да ID used by your third-party reach vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty.
TrueView Third-Party Brand Lift Vendor Required only when updating existing 'TrueView' or 'Demand Gen' line items string, list of lists Да Third-party vendor measuring brand lift for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen line item creation and there is a default brand lift vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.

Select one of the following values:
  • Никто
  • Kantar
  • Dynata
  • Intage
  • Нильсен
  • Macromill
TrueView Third-Party Brand Lift Reporting ID Yes when third-party brand lift vendor is not 'None' нить Да ID used by your third-party brand lift vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty.
TrueView Target Frequency Count Yes when the line item subtype is Target Frequency целое число Да The target frequency count set for a Target Frequency type YouTube line item. This field can only be set with different set of values based on the time window. For YouTube line items that are not of type Target Frequency, this field should be empty.
TrueView Target Frequency Time Window Yes when the line item subtype is Target Frequency нить Да The target frequency time window for a Target Frequency type YouTube line item. This field can be set to Weekly or Monthly for now. For YouTube line items that are not of type Target Frequency, this field should be empty.
  • Еженедельно
  • Ежемесячно
TrueView Video Ad Inventory Control Yes when the line item subtype is Reach string, list Да The video ad inventory control for Reach or View line items.

Select one or more of the acceptable ad format values:
  • In-stream
  • Ввод
  • Шорты
Merchant Center Account Id Нет целое число Да

Merchant Center Account Id. Immutable once set.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Похожие видео Нет string, list Да

List of related YouTube videos. If set, the list must contain 2 to 5 YouTube video IDs.

List format = (YouTube Video ID; YouTube Video ID; etc.).

Only valid if 'Type' is 'TrueView'.

Video Sequence Steps Нет string, list of lists Да

A list of values representing the sequence of steps that constitutes a video sequence line item. Each item in the list represents a 'step' in the sequence.

Each step, formatted as "(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;)", uses the following fields:

  • step_id: the unique ID of the step. If this is a new step, you must use a negative number as a temporary ID, such as -1, -2, etc. Once saved, the system will assign a new ID to this step.
  • previous_step_id: the step ID of the previous step in the sequence. Steps connected by 'Skip' and 'Paid View' interactions may have the same previous step, creating a branching sequence.
  • interaction_type: the type of interaction that connects the previous step to this step. Accepted values are 'Impression', 'Skip', and 'Paid View'.
  • ad_group_type: the ad group type of the step. Accepted values are 'In-stream', 'Bumper', and 'Non skippable'.
  • video_asset_id: the asset ID of the step's ad video.

Sequences must follow the following rules:

  • The first step of a sequence must have empty 'previous_step_id' and 'interaction_type' values.
  • The previous step has to be in front of its next step in the list.
  • Leaving the column empty will remove any existing video sequence for the line item on upload.

List format = ((step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);)

This column is only available if 'Subtype' is 'Video Sequence'.

Video Sequence Minimum Duration Required when the line item subtype is 'Video Sequence' нить Да

The minimum amount of time required for a user to repeat an ad sequence.

  • Неделя
  • Месяц

Only available for 'Video Sequence' line items.