Структурированные данные – версия 4 – Порядок вставки

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

Поле Необходимый Тип Записываемый Описание
Идентификатор Io Требуется только при редактировании существующих заказов на размещение. целое число Нет Числовое значение идентификатора заказа на размещение. Если оставить это поле пустым, будет создан новый идентификатор заказа на размещение и назначен уникальный идентификатор. При необходимости, при создании нового заказа на размещение можно использовать настраиваемый идентификатор для назначения позиций в новый заказ на размещение. Формат настраиваемого идентификатора: «ext[настраиваемый идентификатор]», например, ext123. При загрузке и обработке файла все настраиваемые идентификаторы будут заменены идентификаторами, назначенными DBM, а объекты будут связаны (например, позиция с заказом на размещение) на основе настраиваемых идентификаторов.
Идентификатор кампании Нет целое число Нет Числовой идентификатор кампании. Вы можете указать собственный идентификатор (например, «ext[пользовательский идентификатор кампании]») для кампании, создаваемой одновременно с этим заказом на размещение.
Имя Да нить Да Название записи.
Метка времени Требуется при редактировании существующих записей целое число Нет Метка времени записи. Она используется системой для проверки того, что запись не изменилась между загрузкой и выгрузкой.
Статус Да нить Да Настройка статуса для записи.
  • Активный
  • Приостановлено
  • Черновик
  • Архивировано
  • Удалено
Тип Ио Да нить Да Тип заказа на вставку. Устанавливается только при создании.
  • стандартный
Сборы Нет строка, список списков Да Все сборы для этой записи. Формат списка = (Категория сбора; Сумма сбора; Тип сбора; Выставлен счёт;).
  • Категория платы
    • СРМ
    • СМИ
  • Сумма комиссии
    • Плавать
    • Pct как плавающий
  • Тип платы
    • (строка, см. таблицу сборов)
  • Выставлен счет
    • Истинный
    • ЛОЖЬ
    • пустой

Пример '(CPM; 2; Комиссия менеджера ставок; Ложь); (Медиа; 13; По умолчанию; Истина);'
Допустимые значения приведены в следующей таблице:

Примечание: Комиссия за премиум-статус (CPM) резервируется системой и не может быть изменена. Мощность комиссии за премиум-статус сохраняется при мутациях, при необходимости добавляя комиссию за CPM по умолчанию.

Категория платы Тип платы Вариант с выставленным счетом
CPM/Медиа По умолчанию Не разрешено (оставьте пустым)
CPM/Медиа Сторонний рекламный сервер Не разрешено (оставьте пустым)
CPM/Медиа DoubleVerify Разрешено (Верно/Неверно)
CPM/Медиа Adsafe Не разрешено (оставьте пустым)
CPM/Медиа Adxpose Не разрешено (оставьте пустым)
CPM/Медиа Визу Не разрешено (оставьте пустым)
CPM/Медиа Совокупные знания Не разрешено (оставьте пустым)
CPM/Медиа Терацент Не разрешено (оставьте пустым)
CPM/Медиа Эвидон Не разрешено (оставьте пустым)
CPM/Медиа Комиссия за торговую стойку агентства Не разрешено (оставьте пустым)
CPM/Медиа Adloox Разрешено (Верно/Неверно)
СРМ ShopLocal Обязательно (Верно)
СРМ TrustMetrics Не разрешено (оставьте пустым)
СРМ Видео о интегральной рекламе Разрешено (Верно/Неверно)
СРМ Видео МОАТ Не разрешено (оставьте пустым)
СМИ Комиссия менеджера по ставкам Обязательно (Верно)
СМИ Данные о стоимости рекламы Не разрешено (оставьте пустым)
СРМ Премиальные сборы Не разрешено (оставьте пустым)
Интеграционный код Нет нить Да Дополнительный код для отслеживания.
Подробности Нет нить Да Данные записи в строковом формате.
Шаги Да нить Да Период времени, используемый для расходования суммы по темпу.
  • Ежедневно
  • Ежемесячно
  • Полет
Скорость стимуляции Да нить Да Скорость шага для этой записи.
  • как можно скорее
  • Даже
  • Предстоящий
Сумма темпа Да плавать Да Сумма, которую нужно потратить за период времени, заданный типом темпа.
Частота включена Да нить Да Включает/отключает ограничение частоты показов на основе показов в заказе на размещение.
  • истинный
  • ЛОЖЬ
Частота воздействия Требуется, если «Частота включена» имеет значение «ИСТИНА» целое число Да Положительное целое число для количества показов за заданную частоту, то есть x в «Показать x показов за период y».
Период частоты Требуется, если «Частота включена» имеет значение «ИСТИНА» нить Да Указывает единицу периода времени для ограничения частоты.
  • Минуты
  • Часы
  • Дни
  • Недели
  • Месяцы
  • Продолжительность жизни
Частота Количество Требуется, если «Частота включена» имеет значение «ИСТИНА» целое число Да Положительное целое число, указывающее продолжительность периода времени, то есть y в «Показать x показов за период y».
Тип цели производительности Да нить Да Целевая единица для заказа на вставку
  • СРМ
  • CPA
  • КПК
  • КПВ
  • CPIAVC
  • CTR
  • % просматриваемости
  • Никто
  • Другой
Значение цели производительности Да нить Да Значение цели в валюте (CPM, CPA, CPC, CPV, CPIAVC), процентах (% Viewability, CTR) или в виде строки (Другое).
Измерение DAR Да нить Да Включает/отключает измерение аудитории с помощью Nielsen Digital Ad Ratings
  • истинный
  • ЛОЖЬ
Измерение канала DAR Требуется, если «Measure DAR» имеет значение «TRUE» целое число Да Канал для измерения с помощью Nielsen Digital Ad Ratings. Формат = UniversalChannel.id
Тип бюджета Да нить Да Указывает тип бюджета с точки зрения суммы «дохода», которую необходимо потратить (сумма), или количества показов, которые необходимо приобрести.
  • Количество
  • Впечатления
Бюджетные сегменты Да строка, список списков Да Указывает конкретные сегменты бюджета. Формат списка = (Бюджет, Дата начала, Дата окончания). Бюджет представлен в формате с плавающей валютой. Даты указаны в формате ММ/ДД/ГГГГ. Пример: "(100.50;01.01.2016;31.03.2016;);(200.00;04.01.2016;30.06.2016;);"
Автоматическое распределение бюджета Да нить Да Включает/отключает автоматическое распределение бюджета
  • истинный
  • ЛОЖЬ
Географический таргетинг — включить Нет строка, список Да Список географических регионов для включения в таргетинг. Формат списка = (GeoLocation.id; GeoLocation.id; и т. д.).
Географический таргетинг — Исключить Нет строка, список Да Список географических регионов для исключения из таргетинга. Формат списка = (GeoLocation.id;GeoLocation.id; и т. д.).
Языковой таргетинг — включить Нет строка, список Да Список языков для включения в таргетинг. Формат списка = (Language.id;Language.id;и т.д.).
Языковой таргетинг — исключить Нет строка, список Да Список языков для исключения из таргетинга. Формат списка = (Language.id;Language.id;и т.д.).
Нацеливание на устройство — включить Нет строка, список Да Список устройств для включения в таргетинг. Формат списка = (DeviceCriteria.id;DeviceCriteria.id;и т.д.).
Таргетинг на устройство — Исключить Нет строка, список Да Список устройств , которые следует исключить из таргетинга. Формат списка = (DeviceCriteria.id;DeviceCriteria.id;и т.д.).
Ориентация на браузер — включить Нет строка, список Да Список браузеров для включения в таргетинг. Формат списка = (Browser.id;Browser.id;и т.д.).
Таргетинг на браузер — Исключить Нет строка, список Да Список браузеров для исключения из таргетинга. Формат списка = (Browser.id;Browser.id;и т.д.).
Этикетки безопасности бренда Нет строка, список Да Список меток цифрового контента для таргетинга. Формат списка = (G;PG; и т.д.).
  • Г
  • ПГ
  • Т
  • МА
  • ?
Настройка чувствительности безопасности бренда Нет нить Да Выберите настройку чувствительности, чтобы блокировать инвентарь в зависимости от тематики окружающего его контента.
  • Не блокировать
  • Используйте проверку DoubleClick
  • Использовать пользовательский
Пользовательские настройки безопасности бренда Обязательно, если для параметра «Пользовательская настройка безопасности бренда» установлено значение «Использовать пользовательскую настройку». строка, список Да Если настройка чувствительности безопасности бренда установлена ​​на «Использовать пользовательский», укажите список стандартных классификаторов контента. Например, (Для взрослых; Алкоголь; Табак и т. д.).
  • Взрослый
  • Уничижительный
  • Загрузки и обмен
  • Оружие
  • Играть в азартные игры
  • Насилие
  • Наводящий на размышления
  • Ненормативная лексика
  • Алкоголь
  • Наркотики
  • Табак
  • Политика
  • Религия
  • Трагедия
  • Транспортные аварии
  • Деликатные социальные вопросы
  • Шокирующий
Сторонние службы проверки Нет нить Да Поставщик услуг стороннего подтверждения подлинности.
  • Никто
  • Интегральная рекламная наука
  • DoubleVerify
  • Adloox
Сторонние этикетки проверки Нет строка, список Да Если для параметра «Службы стороннего верифицирования» не задано значение «Нет», укажите список меток , поддерживаемых выбранным поставщиком.
Таргетинг каналов — включить Нет строка, список Да Список каналов для включения в таргетинг. Формат списка = (UniversalChannel.id;UniversalChannel.id; и т. д.).
Таргетинг каналов - Исключить Нет строка, список Да Список каналов для включения в таргетинг. Формат списка = (UniversalChannel.id;UniversalChannel.id; и т. д.).
Ориентация на сайт - Включить Нет строка, список Да Список сайтов для включения в таргетинг. Список может включать набор идентификаторов сайтов или строк URL-адресов, если они отсутствуют в таблице Universal Site. Формат списка = (UniversalSite.Id;'http://someurl.com';и т.д.).
Ориентация на сайт - Исключить Нет строка, список Да Список сайтов , которые следует исключить из таргетинга. Список может включать набор идентификаторов сайтов или строк URL-адресов, если они отсутствуют в таблице Universal Site. Формат списка = (UniversalSite.Id;'http://someurl.com';и т.д.).
Таргетинг приложений — включить Нет строка, список Да Список приложений для включения в таргетинг. Список может включать набор идентификаторов UniversalSite или строки пакетов приложений, если они отсутствуют в таблице Universal Site. Формат списка = (UniversalSite.Id; 'some.app.package'; и т. д.).
Таргетинг приложений — Исключить Нет строка, список Да Список приложений, которые следует исключить из таргетинга. Список может включать набор идентификаторов UniversalSite или строки пакетов приложений, если они отсутствуют в таблице Universal Site. Формат списка = (UniversalSite.Id; 'some.app.package'; и т. д.).
Таргетинг коллекции приложений — включить Нет строка, список Да Список коллекций приложений для включения в таргетинг. Формат списка = ID коллекции приложений; ID коллекции приложений;
Таргетинг коллекции приложений — Исключить Нет строка, список Да Список коллекций приложений для исключения из таргетинга. Формат списка = ID коллекции приложений; ID коллекции приложений;
Таргетинг по категориям — включить Нет строка, список Да Список категорий для включения в таргетинг из идентификаторов вертикалей AdX . Формат списка = (Id_вертикалей;Id_вертикалей; и т. д.).
Таргетинг по категориям — Исключить Нет строка, список Да Список категорий, которые следует исключить из таргетинга, из идентификаторов вертикалей AdX . Формат списка = (Verticals.Id;Verticals.Id;и т.д.).
Таргетинг по ключевым словам — включить Нет строка, список Да Список ключевых слов для включения в таргетинг.
Таргетинг по ключевым словам — Исключить Нет строка, список Да Список ключевых слов, которые следует исключить из таргетинга.
Таргетинг по списку ключевых слов — Исключить Нет строка, список Да Список минус-слов для исключения из таргетинга. Формат списка = Идентификатор списка минус-слов; Идентификатор списка минус-слов;
Таргетинг на аудиторию — похожие аудитории Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». нить Да Включите похожие аудитории для положительно настроенных собственных списков.
  • истинный
  • ЛОЖЬ
Таргетинг аудитории - Включить Нет строка, список списка пар Да Список списков аудиторий для включения в таргетинг. Для списков собственных аудиторий каждая аудитория указывается как пара идентификатора UserList и настройки давности. Пара имеет вид (1;1d;), где 1d — это пример давности, представляющий давность в 1 день. Давность недоступна для сторонних аудиторий, поэтому формат списка — (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ч, 3ч, 6ч, 12ч, 1д, 2д, 3д, 5д, 7д, 10д, 14д, 15д, 21д, 28д, 30д, 45д, 60д, 90д, 120д, 180д, 270д, 365д
Выбор целевой аудитории — Исключить Нет строка, список списка пар Да Список списков аудиторий для исключения из таргетинга. Каждая аудитория представлена ​​парой идентификатора UserList и настройки давности, если список аудитории — это список аудитории 1P. Пара имеет вид (1;1d;), где 1d — это выборка давности, соответствующая 1 дню. Однако для аудиторий 3P давность недоступна, поэтому формат списка — (3;);(4;);. Формат списка= (UserList.id; необязательно;); (UserList.id; необязательно;);
Пример: "(1;1d;);(2;);".
Допустимые значения новизны:
все, 1м, 5м, 10м, 15м, 30м, 1ч, 2ч, 3ч, 6ч, 12ч, 1д, 2д, 3д, 5д, 7д, 10д, 14д, 15д, 21д, 28д, 30д, 45д, 60д, 90д, 120д, 180д, 270д, 365д
Таргетинг по интересам и целевому рынку — включить Нет строка, список Да Список списков аудитории по интересам и/или аудитории заинтересованных покупателей для включения. Формат списка = ID списка пользователей; ID списка пользователей;
Таргетинг по интересам и целевому рынку — исключить Нет строка, список Да Список списков аудитории по интересам и/или заинтересованных покупателей для исключения. Формат списка = ID UserList; ID UserList;
Индивидуальный таргетинг по интересам Нет строка, список Да Список пользовательских списков для выбора. Формат списка = ID списка пользователей; ID списка пользователей;
Ориентация на источник инвентаря — включить Нет строка, список Да Список инвентаря для включения в таргетинг. Формат списка = (InventorySource.id; InventorySource.id;).
Ориентация на источник инвентаря — исключить Нет строка, список Да Список инвентаря для исключения из таргетинга. Формат списка = (InventorySource.id; InventorySource.id;).
Выбор источника инвентаря — нацельтесь на новые биржи Нет нить Да Настройка для выхода на новые биржи.
  • Истинный
  • ЛОЖЬ
Таргетинг на часть суток Нет строка, список Да Список идентификаторов, где каждый идентификатор части суток построен в следующем формате:
daypart_id = base_dayparting_id
+ дней_с_понедельника * 10000
+ старт * 100
+ конец

base_dayparting_id = 300000
days_since_monday: 0=понедельник, 1=вторник, ..., 6=воскресенье
начало: 0..95 (00:00--23:45) целое число от 0 до 95, представляющее 15-минутные интервалы
конец: 1..96 (00:15--24:00); целое число от 0 до 95, представляющее 15-минутные интервалы
начало < конец
Для новых сущностей время будет установлено в соответствии с часовым поясом ваших пользователей (т. е. «Местный»). Для существующих сущностей часовой пояс не изменится.
Часовой пояс таргетинга на часть суток Обязательно, если включен «Таргетинг по времени суток». нить Да Часовой пояс, используемый для таргетинга по времени суток.
  • Местный
  • Рекламодатель
Ориентация на окружающую среду Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». строка, список Да Список целевых сред. Формат списка = (настольный компьютер, веб-браузер, мобильное приложение и т. д.).
Для среды отображения:
  • Настольный веб
  • Мобильный Интернет
  • Мобильное приложение
  • Мобильное приложение Interstitial
  • Десктопный веб на мобильном устройстве
Для видео:
  • Веб-видео для рабочего стола
  • Веб-игра для настольных компьютеров
  • Веб-версия для чтения на рабочем столе
  • Веб-лента для настольных компьютеров
  • Мобильное веб-видео
  • Видео мобильного приложения
  • Видеоинтерстициальное мобильное приложение
Для аудио:
  • Веб-аудио для ПК
  • Мобильное веб-аудио
  • Аудио для мобильных приложений
Active View с таргетингом на видимость Нет нить Да Прогнозируемые проценты видимости. Проценты представлены в виде чисел с плавающей точкой. Один из вариантов: {0,1, 0,2, 0,3, 0,4, 0,5, 0,6, 0,7, 0,8, 0,9}.
Позиция объявления с таргетингом на видимость — включить Нет нить Да Выберите одно или ни одного из допустимых значений:
  • Все
  • АТФ
  • БТФ
  • Неизвестный
Позиция объявления с таргетингом на видимость — Исключить Нет нить Да Исключить позиции объявлений из таргетинга. Выберите одно или ни одного из допустимых значений:
  • АТФ
  • БТФ
  • Неизвестный
Таргетинг позиции видеорекламы Нет строка, список Да Список позиций видеорекламы для таргетинга. Выберите одно или несколько допустимых значений:
  • неизвестный
  • Преролл
  • Середина ролика
  • Пост-ролл
Ориентация на размер видеоплеера Нет строка, список Да Список размеров плеера для видеорекламы. Выберите одно или несколько допустимых значений:
  • неизвестный
  • маленький
  • большой
  • HD
Демографический таргетинг: пол Нет строка, список Да Список полов для таргетинга. Выберите одно или несколько приемлемых значений:
  • Женский
  • Мужской
  • Неизвестный
Возраст демографического таргетинга Нет строка, список Да Ориентируйтесь на возрастной диапазон пользователей. Укажите диапазон «от/до», выбрав один возраст «От» и один возраст «До», а также укажите, следует ли включать неизвестные возрасты (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
  • +
Демографический таргетинг: доход домохозяйства Нет строка, список Да Выберите диапазон доходов домохозяйства. Укажите диапазон «от» до «до», выбрав один верхний и один нижний диапазоны доходов, а также укажите, следует ли включать домохозяйства с неизвестным доходом (истина/ложь). См. список допустимых верхних и нижних диапазонов.
Пример 1: чтобы охватить от 10% до 50% верхних домохозяйств и включить домохозяйства с неизвестным доходом, укажите формат {Верхняя_часть_диапазона; Нижняя_часть_диапазона; Включить неизвестное True/False} = Верхние 10%;41–50%;true;
Пример 2: чтобы охватить только нижние 50% домохозяйств и исключить домохозяйства с неизвестным доходом, укажите формат {Верхняя_часть_диапазона; Нижняя_часть_диапазона; Включить неизвестное True/False} = Нижние 50%;Нижние 50%;истина;
Допустимые значения Top_of_Range/Bottom_of_Range:
  • Топ 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • Ниже 50%

Демографический таргетинг: родительский статус Да строка, список Да Список родительских статусов для поиска. Выберите одно или несколько приемлемых значений.
  • Родитель
  • Не родитель
  • Неизвестный
Таргетинг скорости соединения Нет нить Да Ориентируйтесь на определённую скорость соединения. Выберите одно из допустимых значений:
  • Все
  • 2G
  • 3G
  • DSL
  • 4G
Таргетинг на оператора связи - Включить Нет строка, список Да Список интернет-провайдеров или операторов связи для выбора. Формат списка = {ISP.id; ISP.id;}
Таргетинг на оператора связи — исключить Нет строка, список Да Список интернет-провайдеров и операторов, которые следует исключить. Формат списка: {ISP.id; ISP.id;}