Эта страница переведена с помощью Cloud Translation API.

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

См. обзор для объяснения формата.

Поле

Необходимый

Тип

записываемый

Описание

Ио идентификатор

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

целое число

Нет

Числовое значение идентификатора заказа на размещение. Если оставить это поле пустым, будет создан новый идентификатор заказа на размещение и ему будет присвоен уникальный идентификатор. При необходимости при создании нового заказа на размещение вы можете использовать собственный идентификатор, чтобы назначить позиции новому заказу на размещение. Формат пользовательского идентификатора — «ext[пользовательский идентификатор]», например ext123. Когда файл будет загружен и обработан, все пользовательские идентификаторы будут заменены идентификаторами, назначенными DBM, а объекты будут связаны (например, позиция с заказом на размещение) на основе специальных идентификаторов.

Идентификатор кампании

Нет

целое число

Нет

Числовое значение идентификатора кампании. Вы можете указать собственный идентификатор (например, «ext[пользовательский идентификатор кампании]») для кампании, которую вы создаете одновременно с этим заказом на размещение.

Имя

Да

нить

Да

Имя записи.

Временная метка

Требуется при редактировании существующих записей

целое число

Нет

Временная метка записи. Она используется системой для проверки того, что запись не изменилась между загрузкой и выгрузкой.

Положение дел

Да

нить

Да

Настройка статуса записи.

Активный
Приостановлено
Черновик
В архиве
Удалено

Тип ввода-вывода

Да

нить

Да

Тип заказа на размещение. Устанавливается только при создании.

стандартный

Сборы

Нет

строка, список списков

Да

Все сборы за эту запись. Формат списка = (Категория комиссии; Сумма комиссии; Тип комиссии; Выставлен счет;).

Категория комиссии
- цена за тысячу показов
- СМИ
Величина платежа
- Плавать
- Процент с плавающей запятой
Тип комиссии
- (строка, см. таблицу комиссий)
выставлен счет
- Истинный
- ЛОЖЬ
- пустой

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

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

Категория комиссии	Тип комиссии	Вариант с выставлением счета
Цена за тысячу показов/Медиа	По умолчанию	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Сторонний рекламный сервер	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	DoubleVerify	Разрешено (верно/неверно)
Цена за тысячу показов/Медиа	Adsafe	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Adxpose	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Визу	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Совокупные знания	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Терацент	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Эвидон	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Комиссия агентства по торговле	Не разрешено (оставьте пустым)
Цена за тысячу показов/Медиа	Адлукс	Разрешено (верно/неверно)
цена за тысячу показов	МагазинМестный	Обязательно (Истина)
цена за тысячу показов	ТрастМетрикс	Не разрешено (оставьте пустым)
цена за тысячу показов	Видео об интегральной рекламе	Разрешено (верно/неверно)
цена за тысячу показов	МОАТ Видео	Не разрешено (оставьте пустым)
СМИ	Комиссия Bid Manager	Обязательно (Истина)
СМИ	Данные о стоимости рекламы	Не разрешено (оставьте пустым)
цена за тысячу показов	Премиальные сборы	Не разрешено (оставьте пустым)

Код интеграции

Нет

нить

Да

Дополнительный код для отслеживания.

Подробности

Нет

нить

Да

Детали записи в строковом формате.

темп

Да

нить

Да

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

Ежедневно
Ежемесячно
Полет

Скорость темпа

Да

нить

Да

Скорость темпа для этой записи.

как можно скорее
Даже
Предстоящий

Величина темпа

Да

плавать

Да

Сумма расходов за период времени, заданный типом регулирования.

Частота включена

Да

нить

Да

Включает или отключает ограничение частоты показов в заказе на размещение.

истинный
ЛОЖЬ

Частотные воздействия

Требуется, если для параметра «Частота включена» установлено значение «ИСТИНА».

целое число

Да

Положительное целое число для количества показов в заданной частоте, то есть x в параметре «Показать x показов за период y».

Частота Период

Требуется, если для параметра «Частота включена» установлено значение «ИСТИНА».

нить

Да

Указывает единицу периода времени для ограничения частоты показов.

Минуты
Часы
Дни
Недели
Месяцы
Продолжительность жизни

Частота Сумма

Требуется, если для параметра «Частота включена» установлено значение «ИСТИНА».

целое число

Да

Положительное целое число за период времени типа «Период частоты», то есть y в «Показать x показов за период y».

Тип цели по эффективности

Да

нить

Да

Целевая единица заказа на размещение

цена за тысячу показов
цена за конверсию
КТК
Цена за просмотр
CPIAVC
CTR
% видимости
Никто
Другой

Целевое значение производительности

Да

нить

Да

Значение цели в валюте (CPM, CPA, CPC, CPV, CPIAVC), процентах (% видимости, CTR) или в виде строки (Другое).

Измерьте DAR

Да

нить

Да

Включает/отключает измерение аудитории с помощью Nielsen Digital Ad Ratings.

истинный
ЛОЖЬ

Измерить канал DAR

Требуется, когда параметр «Измерить DAR» имеет значение «ИСТИНА».

целое число

Да

Канал , который можно измерить с помощью Nielsen Digital Ad Ratings. Формат = UniversalChannel.id

Тип бюджета

Да

нить

Да

Указывает тип бюджета в виде суммы «дохода», который нужно потратить (сумма) или количества показов (показов), которые нужно приобрести.

Количество
Впечатления

Бюджетные сегменты

Да

строка, список списков

Да

Указывает конкретные сегменты бюджета. Формат списка = (Бюджет, Дата начала, Дата окончания). Бюджет указан в плавающем формате валюты. Даты указываются в формате ММ/ДД/ГГГГ. Пример: "(100.50;01.01.2016;31.03.2016;);(200.00;01.04.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 и т. д.).

г
PG
Т
МА
?

Настройка чувствительности безопасности бренда

Нет

нить

Да

Выберите настройку чувствительности, чтобы блокировать инвентарь на основе тематики окружающего его контента.

Не блокируй
Используйте проверку DoubleClick
Использовать пользовательские

Пользовательские настройки безопасности бренда

Требуется, если для параметра «Пользовательская настройка безопасности бренда» установлено значение «Использовать пользовательские».

строка, список

Да

Если для параметра «Чувствительность к безопасности бренда» установлено значение «Использовать собственный», укажите список стандартных классификаторов контента. Например, (Взрослый;Алкоголь;Табак;и т. д.).

Взрослый
уничижительный
Загрузки и обмен
Оружие
Играть в азартные игры
Насилие
наводящий на размышления
Ненормативная лексика
Алкоголь
Наркотики
Табак
Политика
Религия
Трагедия
Транспортные происшествия
Чувствительные социальные проблемы
Шокирующий

Сторонние службы проверки

Нет

нить

Да

Сторонний поставщик услуг проверки.

Никто
Интегральная рекламная наука
DoubleVerify
Адлукс

Этикетки сторонней проверки

Нет

строка, список

Да

Если для сторонних служб проверки не установлено значение «Нет», укажите список меток , поддерживаемых выбранным поставщиком.

Таргетинг на каналы – включить

Нет

строка, список

Да

Список каналов для включения в таргетинг. Формат списка = (UniversalChannel.id;UniversalChannel.id; и т. д.).

Таргетинг на каналы – исключить

Нет

строка, список

Да

Список каналов для включения в таргетинг. Формат списка = (UniversalChannel.id;UniversalChannel.id; и т. д.).

Таргетинг на сайты – включить

Нет

строка, список

Да

Список сайтов для включения в таргетинг. Список может включать набор идентификаторов сайтов или строки URL-адресов, если они не найдены в таблице универсальных сайтов. Формат списка = (UniversalSite.Id;'http://someurl.com';и т.д.).

Таргетинг на сайты – исключить

Нет

строка, список

Да

Список сайтов , которые следует исключить из таргетинга. Список может включать набор идентификаторов сайтов или строки URL-адресов, если они не найдены в таблице универсальных сайтов. Формат списка = (UniversalSite.Id;'http://someurl.com';и т.д.).

Таргетинг на приложения – включить

Нет

строка, список

Да

Список приложений для включения в таргетинг. Список может включать набор идентификаторов UniversalSite или строки пакетов приложений, если они не найдены в таблице Universal Site. Формат списка = (UniversalSite.Id; 'some.app.package'; и т. д.).

Таргетинг на приложения – исключить

Нет

строка, список

Да

Список приложений, которые следует исключить из таргетинга. Список может включать набор идентификаторов UniversalSite или строки пакетов приложений, если они не найдены в таблице Universal Site. Формат списка = (UniversalSite.Id; 'some.app.package'; и т. д.).

Таргетинг на коллекцию приложений – включить

Нет

строка, список

Да

Список коллекций приложений для включения в таргетинг. Формат списка = идентификатор коллекции приложений; Идентификатор коллекции приложений;

Таргетинг на коллекцию приложений – исключить

Нет

строка, список

Да

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

Таргетинг на категории – включить

Нет

строка, список

Да

Список категорий для включения в таргетинг на основе идентификаторов отраслей AdX . Формат списка = (Verticals.Id;Verticals.Id;и т.д.).

Таргетинг на категории – исключить

Нет

строка, список

Да

Список категорий, которые следует исключить из таргетинга, из идентификаторов отраслей AdX . Формат списка = (Verticals.Id;Verticals.Id;и т.д.).

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

Нет

строка, список

Да

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

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

Нет

строка, список

Да

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

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

Нет

строка, список

Да

Список списков минус-слов , которые следует исключить из таргетинга. Формат списка = идентификатор списка отрицательных ключевых слов; Идентификатор списка минус-слов;

Таргетинг на аудиторию – похожие аудитории

Требуется, если «Тип» — «Дисплей», «Видео» или «Аудио».

нить

Да

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

истинный
ЛОЖЬ

Таргетинг на аудиторию – включить

Нет

строка, список списка пар

Да

Список списков аудитории для включения в таргетинг. Для собственных списков аудитории каждая аудитория указана как пара идентификатора UserList и настройки давности. Пара — (1;1d;), где 1d — это выборочная новизна, представляющая новизну за 1 день. Давность недоступна для сторонних аудиторий, поэтому формат списка — (3;);(4;);. Для групп аудиторий «И» и «ИЛИ» следуйте следующему примеру: Чтобы объединить пары с давностью и без: ' ((1;1d;);(2;365d;));((3;);(4; 5m;);(5;все;));'. Это означает (список 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д

Таргетинг по интересам и рынку – включить

Нет

строка, список

Да

Список списков аудитории по интересам и/или заинтересованных покупателей, которые следует включить. Формат списка = идентификатор UserList; идентификатор списка пользователей;

Таргетинг по интересам и рынку — исключить

Нет

строка, список

Да

Список списков аудитории по интересам и/или аудитории заинтересованных покупателей, которые следует исключить. Формат списка = идентификатор UserList; идентификатор списка пользователей;

Пользовательский таргетинг по интересам

Нет

строка, список

Да

Список пользовательских списков для таргетинга. Формат списка = идентификатор UserList; идентификатор списка пользователей;

Таргетинг на источник инвентаря – включить

Нет

строка, список

Да

Список инвентаря для включения в таргетинг. Формат списка = (InventorySource.id; InventorySource.id;).

Таргетинг на источник инвентаря – исключить

Нет

строка, список

Да

Список инвентаря , который нужно исключить из таргетинга. Формат списка = (InventorySource.id; InventorySource.id;).

Таргетинг на источник инвентаря: таргетинг на новые биржи

Нет

нить

Да

Настройка таргетинга на новые биржи.

Истинный
ЛОЖЬ

Таргетинг на часть дня

Нет

строка, список

Да

Список идентификаторов, где каждый идентификатор части дня создается в следующем формате:
daypart_id = base_dayparting_id
+days_since_monday * 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-минутные интервалы
начало < конец
Для новых объектов время будет установлено в часовом поясе ваших пользователей (т. е. «Местное»). Для существующих объектов часовой пояс не будет изменен.

Часовой пояс таргетинга на часть дня

Требуется, если включен «Таргетинг на часть дня».

нить

Да

Часовой пояс, который будет использоваться для таргетинга на время суток.

Местный
Рекламодатель

Экологический таргетинг

Требуется, если «Тип» — «Дисплей», «Видео» или «Аудио».

строка, список

Да

Список целевых сред. Формат списка = (Настольный Интернет; Мобильное приложение и т. д.).
Для среды отображения:

Настольный Интернет
Мобильный Интернет
Мобильное приложение
Межстраничное объявление для мобильных приложений
Десктопный Интернет на мобильных устройствах

Для видео:

Веб-видео для ПК
Настольная веб-игра
Desktop Web In-Read
Интернет-канал для настольных компьютеров
Мобильное веб-видео
Видео о мобильном приложении
Межстраничное видео для мобильных приложений

Для аудио:

Настольное веб-аудио
Мобильное веб-аудио
Аудио в мобильном приложении

Таргетинг на видимость Active View

Нет

нить

Да

Целевой прогнозируемый процент видимости. Проценты представлены в виде чисел с плавающей запятой. Один из {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}

Позиция объявления с таргетингом на видимость – включить

Нет

нить

Да

Целевые позиции объявлений. Выберите одно или ни одно из приемлемых значений:

Все
АТФ
БТФ
Неизвестный

Позиция объявления с таргетингом на видимость – исключить

Нет

нить

Да

Исключить позиции объявлений в таргетинге. Выберите одно или ни одно из приемлемых значений:

АТФ
БТФ
Неизвестный

Таргетинг на позицию видеообъявления

Нет

строка, список

Да

Список позиций видеообъявлений для таргетинга. Выберите одно или несколько приемлемых значений:

неизвестный
Преролл
В середине ролика
Пост-ролл

Таргетинг на размер видеопроигрывателя

Нет

строка, список

Да

Список размеров проигрывателя видеообъявлений для таргетинга. Выберите одно или несколько приемлемых значений:

неизвестный
маленький
большой
HD

Демографический таргетинг

Нет

строка, список

Да

Список полов для таргетинга. Выберите одно или несколько приемлемых значений:

Женский
Мужской
Неизвестный

Демографический таргетинг Возраст

Нет

строка, список

Да

Таргетинг на возрастной диапазон пользователей. Укажите диапазон от/до, выбрав один возраст От и один возраст До, а также укажите, включать ли неизвестный возраст (истина/ложь). См. список допустимого возраста «От/До».
Пример 1. Чтобы настроить таргетинг на 18–55 лет и включить неизвестный возраст, укажите формат {From; К ; Включить неизвестное True/False} = 18;55;true;
Пример 2: чтобы настроить таргетинг только на пользователей старше 35 лет и исключить неизвестный возраст, укажите следующее = 35;+;false;.
Допустимые значения для параметра «От»:

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

Демографический таргетинг на доходы домохозяйств

Нет

строка, список

Да

Ориентируйтесь на диапазон доходов семьи. Укажите диапазон от/до, выбрав один диапазон доходов Top_of_Range и один диапазон доходов Bottom_of_Range, а также укажите, включать ли домохозяйства с неизвестным доходом (истина/ложь). См. список допустимых диапазонов Top_of_Range и Bottom_of_Range.
Пример 1: чтобы настроить таргетинг на верхние 10–50 % домохозяйств и включить домохозяйства с неизвестным доходом, укажите формат {Top_of_Range; Нижнее_диапазона; Включить неизвестное Верно/Неверно} = Лучшие 10%;41–50%;верно;
Пример 2: чтобы настроить таргетинг только на нижние 50% домохозяйств и исключить домохозяйства с неизвестным доходом, укажите формат {Top_of_Range; Нижнее_диапазона; Включить неизвестное Истина/Ложь} = Нижние 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;}