Спецификация OpenRTB DV360

При просмотре этой страницы убедитесь, что у вас под рукой есть спецификация OpenRTB 2.6 .

Display and Video 360 не поддерживает все поля, указанные в спецификации OpenRTB, и могут существовать нюансы. Разделы этого документа содержат информацию и рекомендации, специфичные для реализации Display and Video 360. Вам также следует следовать рекомендациям, представленным в спецификации OpenRTB, если не указано иное.

Некоторые поля не поддерживаются, но всё равно обрабатываются. Эти поля должны быть отформатированы правильно, но это не повлияет на результат торгов.

Спецификация запроса предложений

Запрос на размещение ставки — это HTTP POST-запрос с телом, представляющим собой объект запроса на размещение ставки . Формат тела определяется в заголовке Content-Type .

В ответ на запрос, не делающий ставку, следует получить либо HTTP-код 204 без тела, либо HTTP-код 200 с телом, соответствующий запросу, делающему ставку .

Если запрос на размещение ставки имеет некорректный формат, может быть возвращен HTTP-код 200 с телом ответа , содержащим заполненное поле nbr .

Формат ответа определяется заголовком Accept .

Формат JSON

Формат по умолчанию используется, если не указан допустимый MIME-тип.

Запросы и ответы в формате JSON соответствуют спецификации IAB OpenRTB 2.6 . В приведенной ниже документации описаны расширения и поддержка полей.

Заголовок Content-Type : application/json указывает на запрос ставки в формате JSON, Accept : application/json указывает, что ответы на ставку должны быть в формате JSON.

Формат Protobuf

Примечание: Поддержка Protobuf находится в стадии бета-тестирования, пожалуйста, свяжитесь с DV360, если вас это интересует.

Запросы и ответы в формате JSON соответствуют спецификации IAB OpenRTB 2.6 Protobuf .

Поддержка расширений ограничена, если вас это интересует, свяжитесь с DV360.

Отправьте заголовок Content-Type : application/x-protobuf чтобы указать на запрос ставки Protobuf, и установите Accept : application/x-protobuf чтобы получать ответы на запросы ставки Protobuf.

Объект запроса предложения

Поле Тип Подробности
id Нить Необходимый.
Уникальный идентификатор запроса на участие в тендере. Он может использоваться для идентификации отдельных запросов в течение очень ограниченного времени после их обработки.
imp Массив Импа Требуется как минимум 1 объект imp .

Для аудиомодулей поддерживается более одного объекта imp .
В других случаях (например, при наличии нескольких независимых слотов на странице) используется первый объект imp , остальные отбрасываются.

site Сайт Обязательно для отправки запросов на сайт.
site и app взаимоисключающие понятия.
app Приложение Обязательно для отправки запросов в приложение.
app и site взаимоисключающие понятия.
device Устройство Необходимый.
user Пользователь Необходимый.
test Целое число Не поддерживается.
at Целое число 1 : Аукцион первой цены, на котором с рекламодателя взимается сумма его ставки.
2 (по умолчанию): Аукцион второй цены, где с рекламодателя взимается плата чуть выше, чем с участника, предложившего вторую по величине цену.
3 : Минимальная цена указана в запросе и не имеет никакого отношения к конкурирующим предложениям.
tmax Целое число Необязательно, значение по умолчанию устанавливается индивидуально для каждой интеграции.
wseat Массив строк Список разрешенных мест для покупателей.
Рекомендуется, если только всем рекламодателям не разрешено участвовать в торгах.
Значение "Не задано" означает отсутствие ограничений.
bseat Массив строк Список мест для покупателей, чьи ставки следует заблокировать. Указанным покупателям будет запрещено участвовать в торгах и открытых аукционах.
allimps Целое число Не поддерживается.
cur Массив строк

Необязательно, но настоятельно рекомендуется. По умолчанию — для каждой интеграции отдельно.

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

Настоятельно рекомендуется поддерживать единую валюту на каждой бирже.
wlang Массив строк Не поддерживается.
bcat Массив строк Заблокированы категории рекламодателей с использованием категорий контента IAB.
Если параметр "Не задан" недоступен, значит, заблокированных категорий нет.
badv Массив строк Укажите заблокированного рекламодателя на основе домена, предоставленного рекламодателем.
Если параметр не установлен, блокировка рекламодателей отсутствует.
bapp Массив строк Не поддерживается.
source Источник Частично необходим для schain .
regs Правила Необязательный.
ext Продление сроков подачи заявок на участие в тендере Необязательный.

объект расширения запроса на подачу заявки

Поле Тип Подробности
schain Цепочка поставок В новых интеграциях следует использовать поле BidRequest.source.schain в поле Source .
purch Целое число Параметр «Приобретенный трафик» обозначает трафик, перенаправленный с ресурсов, отличных от собственных, приобретенных или иным образом стимулированных.
Это соответствует новой спецификации MRC IVT 2.0 .

В отчетах для покупателей этот параметр будет называться «Источник трафика от издателя» и будет иметь одно из следующих значений:
0 (по умолчанию): Не определено — значение не отправляется в запросах на ставки. Невозможно получить значение;
1 : Приобретено - трафик перенаправляется с объектов, не находящихся в собственности (приобретенные или иным образом стимулированные действия).
2 : Органический трафик - прямой переход по URL-адресу, поиск по сайту или загрузка приложения.

gdemsignals Нить Сигнальный блок SCAR API из GMA SDK.
Рекомендуется использовать при работе с трафиком GMA SDK, в противном случае запрещено.
disable_gma_format инт Если указан gdemsignals , он необязателен, в противном случае его использование запрещено.
0 (по умолчанию): Когда gdemsignals заполнен, ответ bid response adm представляет собой JSON-объект.
1 : Вместо JSON-объекта будет предоставлен рекламный тег.

Исходный объект

Поле Тип Подробности
fd Целое число Организация, ответственная за принятие окончательного решения о продаже показа.
0 (По умолчанию): Решение принимает биржа.
1 : Решение принимается вышестоящим поставщиком.
tid Нить Не поддерживается.
pchain Нить Не поддерживается.
schain Цепочка поставок Требуется практически во всех случаях.

Это поле предпочтительнее, чем предоставление schain через расширения запроса предложения или расширения источника .

ext Расширения исходного кода Необязательный.

Объект расширений источника

Это расширение настоятельно рекомендуется, поскольку оно влияет на то, как результаты измерений видимости отображаются в DV3 для клиента. Если имя партнера OMID НЕ включено в список сертификации IAB , MRC требует от нас сообщать показатели видимости отдельно от показателей, сертифицированных MRC. Подробнее .

Поле Тип Подробности
omidpn Нить Идентификатор интеграции OM SDK. Он совпадает с параметром "name" объекта OMID Partner.
omidpv Нить Версия интеграции OM SDK. Это то же самое, что и параметр "versionString" объекта OMID Partner.
schain Цепочка поставок В новых интеграциях следует использовать schain полей из источника .

Рег. объект

Поле Тип Подробности
coppa Целое число 0 (по умолчанию): Закон COPPA не применяется к данному запросу.
1 : Данный запрос подпадает под действие закона COPPA.
ext Продление действия правил Необязательный.

объект расширений правил

Поле Тип Подробности
gdpr Целое число Укажите, является ли запрос на участие в тендере запросом от региона ЕЭЗ.
0 (по умолчанию): Регион, не входящий в ЕЭЗ.
1 : регион ЕЭЗ,
Более подробную информацию см. в разделе «Решение для поставщиков услуг, давших согласие на обработку персональных данных в соответствии с GDPR» .
us_privacy Нить Пожалуйста, следуйте техническим спецификациям, предоставленным IAB Tech Lab, для реализации строки us_privacy .

Когда мы получаем строку us_privacy в запросе на размещение рекламы, и когда строка IAB указывает, что пользователь не отказался от участия , Display & Video 360 размещает ставку на такие запросы. Мы не будем передавать сигнал IAB другим поставщикам. Когда строка IAB указывает, что пользователь отказался от участия , Google не будет размещать ставку на такие запросы.

Объект-невидимка

Поле Тип Подробности
id Нить Уникальный идентификатор для этого показа в контексте запроса на размещение рекламы (как правило, значение начинается с 1 и увеличивается до n для n показов).
metric Объект Не поддерживается.
banner Баннер Обязательно для размещения баннерной рекламы.
video Видео Обязательно для размещения видеорекламы.
audio Аудио Обязательно для размещения аудиорекламы.
native Родной Обязательно для размещения нативной рекламы.
pmp Пмп Для данного показа действуют сделки на частном рынке.
displaymanager Нить Название партнера по медиации рекламы, технологии SDK или проигрывателя, ответственного за показ рекламы (обычно видео или мобильного). Используется некоторыми рекламными серверами для настройки рекламного кода партнером. Рекомендуется для видео и/или приложений.
displaymanagerver Нить Версия партнера по медиации рекламы, технологии SDK или проигрывателя, ответственного за отображение рекламы (обычно видео или мобильного). Используется некоторыми рекламными серверами для настройки рекламного кода партнером. Рекомендуется для видео и/или приложений.
instl Целое число 0 (по умолчанию): не интерстициальный.
1 : реклама является межстраничной или полноэкранной.
tagid Нить Идентификатор конкретного места размещения объявления или тега объявления, использованного для инициирования аукциона. Это может быть полезно для отладки любых проблем или для оптимизации со стороны покупателя.
bidfloor Плавать Минимальная ставка за данное размещение выражена в CPM.
bidfloorcur Нить

Валюта указана с использованием буквенных кодов ISO-4217.

clickbrowser Целое число

Указывает тип браузера, открытого при нажатии на рекламный баннер в приложении.
0 (по умолчанию): встроенный
1 : родной

Обратите внимание, что в устройствах iOS 9.x компонент Safari View Controller считается нативным браузером для целей данного поля.

secure Целое число Если для этого требуется защищенный URL-адрес HTTPS или незащищенный URL-адрес HTTP.
0 (по умолчанию): небезопасно
1 : безопасный
iframebuster Массив строк
exp Целое число Срок действия заявки устанавливается системой DV 360 независимо от значения, отправленного партнером в этом поле. События показа, полученные после истечения срока давности показов (обычно 1 час), считаются устаревшими и не подлежат оплате системой DV360.
rwdd Целое число Указывает, получает ли пользователь вознаграждение за просмотр рекламы.
0 (по умолчанию): Награда не выдается
1 : Награжден

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

Объект расширения Imp

Поле Тип Подробности
bcrid Нить Список идентификаторов креативов, которые следует заблокировать.
Поле Тип Подробности
format Формат массива Список поддерживаемых форматов.
w Целое число

Буквы h и w объединены в поле format .

Рекомендуется использовать format вместо этого.
h Целое число

Буквы h и w объединены в поле format .

Рекомендуется использовать format вместо этого.
wmax Целое число Не поддерживается.
hmax Целое число Не поддерживается.
wmin Целое число Не поддерживается.
hmin Целое число Не поддерживается.
btype Целочисленный массив Список заблокированных типов баннерной рекламы:

1 : HTML-текстовые объявления
2 : HTML-баннерная реклама
3 : Реклама на JavaScript
4 : Реклама в IFrame

battr Целочисленный массив Поддерживаются следующие значения:

1 : Автоматическое воспроизведение аудио
2 : Инициировано пользователем аудио
3 : Расширяемый автоматический
4 : Инициируется расширяемым щелчком мыши
5 : Инициирован расширяемый перенос данных.
6 : Видео в баннере воспроизводится автоматически.
7 : Видео в баннере инициировано пользователем.
8 : Pop(over/under/on-exit)
9 : Провокационный или намекающий
10 : "Раздражающие", например: дрожание, мерцание, экстремальная анимация, смайлики.
11 : Опросы
12 : Только текст
13 : Интерактивные игры для пользователей
14 : Диалоговое окно или стиль предупреждения Windows
15 : Имеет кнопку включения/выключения звука.
16 : Рекламу можно пропустить
17 : Вспышка

pos Целое число Позиция рекламы:

0 (по умолчанию): Неизвестно
1 : Над линией сгиба
2 : Не поддерживается: Вероятно, находится ниже видимой части экрана.
3 : Ниже линии сгиба
4 : Заголовок
5 : Нижний колонтитул
6 : Боковая панель
7 : Полноэкранный режим

mimes Массив строк Не поддерживается.

Для всех баннеров DV360 будет использовать формат text/html.

topframe Целое число 0 (по умолчанию): Баннер отображается в iframe.
1 : Не поддерживается: баннер отображается в верхнем фрейме.
expdir Целочисленный массив 1 : Левая сторона
2 : Справа
3 : Вверх
4 : Вниз
5 : Расширяемый полноэкранный режим
api Целочисленный массив Поддерживаемые API-фреймворки

1 : Левая сторона
2 : Справа
3 : Вверх
4 : Вниз
5 : Расширяемый полноэкранный режим

id Нить Идентификатор для объекта баннера, который должен быть уникальным в рамках одного показа.

Рекомендуется использовать при работе с banner объектами и видеообъектами .

vcm Целое число

Это актуально только для banner используемого с видеообъектом .

0 : Баннер отображается одновременно с видеороликом.
1 : Баннер — это заключительная заставка после видео.

Форматировать объект

Поле Тип Подробности
w Целое число Ширина в пикселях, не зависящих от устройства (DIPS).
h Целое число Высота в пикселях, не зависящих от устройства (DIPS).
wratio Целое число Не поддерживается.
hratio Целое число Не поддерживается.
wmin Целое число Не поддерживается.

Видеообъект

Мы настоятельно рекомендуем указывать место размещения видео в запросе на размещение. Отсутствие поля с указанием места размещения классифицируется как неизвестное место размещения. Подробнее см. статью о таргетинге по позициям .

Поле Тип Подробности
mimes Массив строк Требуется как минимум один тип MIME.

video/flv или video/x-f4v
video/mp4 , video/x-mp4 или application/mp4
video/webm или video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg или application/ogg
application/javascript или application/x-javascript

minduration Целое число Минимальная продолжительность видео в секундах, по умолчанию минимальное значение отсутствует.
maxduration Целое число Максимальная продолжительность видео в секундах, по умолчанию ограничение отсутствует.
protocols Целочисленный массив Необходимо наличие как минимум одного поддерживаемого протокола.

1 : VAST 1.0
2 : VAST 2.0
3 : VAST 3.0
4 : VAST 1.0 Wrapper
5 : Оболочка VAST 2.0
6 : VAST 3.0 Wrapper
7 : VAST 4.0
8 : VAST 4.0 Wrapper
9 : DAAST 1.0
10 : Оболочка DAAST 1.0

w Целое число Ширина видеоплеера в пикселях, не зависящих от устройства (DIPS).
h Целое число Высота видеоплеера в пикселях, не зависящих от устройства (DIPS).
startdelay Целое число Задержка начала показа в секундах для размещения рекламы перед, во время или после ролика.
placement Целое число Настоятельно рекомендуется указывать место размещения (и/или) видео в заявке на участие в тендере. Отсутствие обоих полей будет классифицироваться как неизвестное размещение.

0 (по умолчанию): Неизвестно
1 : В потоке
2 : На баннере
3 : В статье
4 : В корме
5 : Плавающий

Примечание: Чтобы видео было отнесено к категории «Встроенное в поток» (размещение или тип размещения 1), оно должно быть настроено на воспроизведение со звуком и корректно отображаться в методе воспроизведения (подходят значения 1, 3, 4 и 5).
plcmt Целое число Настоятельно рекомендуется указывать место размещения (и/или) видео в заявке на участие в тендере. Отсутствие обоих полей будет классифицироваться как неизвестное размещение.

0 (по умолчанию): Неизвестно
1 : В потоке
2 : Сопутствующие материалы
3 : Интерстициальный
4 : Нет контента/Автономный

Примечание: Чтобы видео было отнесено к категории «Встроенное в поток» (размещение или тип размещения 1), оно должно быть настроено на воспроизведение со звуком и корректно отображаться в методе воспроизведения (подходят значения 1, 3, 4 и 5).

Примечание: Если указаны и plcmt , и placement , приоритет будет отдан plcmt . См. руководство IAB по миграции на plcmt.

Примечание: plcmt: Accompanying Content (2) считается placement: In Article (3)
plcmt: No Content/Standalone (4) считается placement: In feed (4)
placement: In Banner отсутствует сопоставление в plcmt
linearity Целое число Не поддерживается.
skip Целое число Если видеоплеер позволяет пропустить рекламу.

0 (по умолчанию): Не пропускается
1 : Можно пропустить

skipmin Целое число Не поддерживается.
skipafter Целое число Не поддерживается.
sequence Целое число Если в одном запросе на размещение рекламы предлагается несколько показов, порядковый номер позволит скоординированно показать несколько рекламных материалов.
battr Целочисленный массив Заблокированы творческое назначение.
maxextended Целое число Максимальная продолжительность рекламного видеоролика, если такое продление разрешено.

0 (по умолчанию): Расширение не разрешено
-1 : Продление разрешено, и никаких ограничений по времени не установлено.
>0 : количество секунд воспроизведения, поддерживаемых сверх значения maxduration.

minbitrate Целое число Минимальная скорость передачи данных в Кбит/с.
maxbitrate Целое число Максимальная скорость передачи данных в Кбит/с.
boxingallowed Целое число Указывает, разрешено ли размещение контента с соотношением сторон 4:3 в окне 16:9 с черными полосами сверху и снизу.

0 : запрещено
1 (по умолчанию): Разрешено

playbackmethod Целочисленный массив Возможные методы воспроизведения. Если ни один из них не указан, можно использовать любой метод.

0 (по умолчанию): Неизвестно
1 : Автоматическое воспроизведение, звук включен
2 : Автоматическое воспроизведение, звук отключен
3 : Нажмите, чтобы начать игру
4 : Наведите курсор мыши
5 : Запуск при входе в область просмотра, включение звука.
6 : Запуск при входе в окно просмотра, звуковой сигнал.

Примечание: Все оттиски с отключенным звуком по умолчанию (метод воспроизведения 2, 6 или 0) должны сигнализировать о размещении вне потока типа 2, 3, 4 или 5 (oRTB 2.5) или подтипе размещения 2, 3 или 4.
playbackend Целое число Событие, приводящее к завершению воспроизведения.

1 : Завершение видео или удаление пользователем
2 : Выход за пределы области просмотра или завершение работы пользователем.
3 : После выхода из области просмотра, продолжает работу в виде плавающего окна до завершения или закрытия пользователем.

delivery Целочисленный массив Поддерживаемые способы доставки. Если ни один из них не указан, предполагается, что поддерживаются все способы доставки.

1 : Потоковое вещание
2 : Прогрессивный

pos Целое число Размещение рекламы на экране.

0 (по умолчанию): Неизвестно
1 : Над линией сгиба
2 : Не поддерживается: Вероятно, находится ниже видимой части экрана.
3 : Ниже линии сгиба
4 : Заголовок
5 : Нижний колонтитул
6 : Боковая панель
7 : Полноэкранный режим

companionad массив баннеров Сопутствующая реклама, если таковая имеется.
api Целочисленный массив

0 (по умолчанию): Неизвестно
1 : VPAID 1
2 : VPAID 2
3 : MRAID 1
4 : ОРММА
5 : MRAID 2
6 : MRAID 3
7 : OMID 1 — необходим для включения измерения с использованием OMID для активного представления.
8 : SIMID 1

companiontype Целочисленный массив Не поддерживается.
maxseq Целое число Максимальное количество рекламных объявлений, отображаемых в динамическом видеоблоке.
poddur Целочисленный массив Максимальная продолжительность динамического видеоролика в секундах.

Поддерживаемое расширение для видеообъекта

Поле Тип Подробности
rewarded Целое число Это поле используется для указания того, были ли запросы вознаграждены или нет. Данные следует передавать в виде целого числа.

0 (по умолчанию): награда не присуждается
1 : вознагражден

Аудиообъект

Поле Тип Подробности
mimes Массив строк Требуется как минимум один тип MIME.

audio/m4a , audio/mp4 или audio/x-m4a
audio/mpeg или audio/mp3
audio/ogg или audio/x-ogg

minduration Целое число Минимальная продолжительность рекламного ролика в секундах.
maxduration Целое число Максимальная продолжительность показа рекламы в секундах.
protocols Целочисленный массив

3 : VAST 3.0
6 : VAST 3.0 Wrapper
7 : VAST 4.0
8 : VAST 4.0 Wrapper

startdelay Целое число Задержка начала показа рекламы в секундах для размещения рекламы перед началом, в середине или после начала ролика.

-2 : После ролика
-1 : Середина вращения
0 : Предварительно скрученный ролик
>0 : Середина ролика

sequence Целое число Не поддерживается.
battr Целочисленный массив Не поддерживается.
maxextended Целое число Не поддерживается.
minbitrate Целое число Минимальная скорость передачи данных в кбит/с.
maxbitrate Целое число Максимальная скорость передачи данных в кбит/с.
delivery Целочисленный массив Не поддерживается.
companionad Массив объектов баннера Любые дополнительные креативные слоты с баннерами.
api Целочисленный массив Список поддерживаемых API-фреймворков для этого показа.

7 : Омид V1

companiontype Целочисленный массив Не поддерживается.
maxseq Целочисленный массив Не поддерживается.
feed Целое число Тип аудиопотока.

1 : Музыкальная служба
2 : Трансляция
3 : Подкаст

stitched Целое число Не поддерживается.
nvol Целое число Не поддерживается.

Исходный объект

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

Поле Тип Подробности
request Нить Строковый закодированный собственный JSON-объект.
ver Нить 1.0 : Не поддерживается
1.1 : Не поддерживается
1.2
api Целочисленный массив Список поддерживаемых API-фреймворков для этого показа.

7 : Омид V1

battr Целочисленный массив Не поддерживается.

Объект PMP

Поле Тип Подробности
private_auction Целое число 0 (По умолчанию): Разрешены все ставки
1 : Только предложения
deals массив объектов Deal В список сделок следует включить следующее.

Объект сделки

Поле Тип Подробности
id Нить Объект PMP не может содержать более одного объекта сделки на один ID.
bidfloor Двойной Минимальная ставка для этого показа в CPM.

Требуется, если at=3 .

bidfloorcur Нить Валюта указана с использованием буквенных кодов ISO-4217.

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

at Целое число Если значение не указано, по умолчанию используется адрес bid_request.at .

1 : Первая цена
2 : Вторая цена
3 : Фиксированная цена

wseat Массив строк Идентификаторы партнеров, имеющих право на участие в сделке.

Отсутствие свободных мест означает отсутствие ограничений по количеству мест.

wadomain Массив строк Домены рекламодателей, которым разрешено участвовать в торгах по этой сделке.

Отсутствие мест означает отсутствие ограничений по домену.

guar Целое число Это поле предназначено для указания того, является ли сделка гарантированной. Значение следует передавать в виде целого числа.

Для того чтобы DV360 принимал гарантированные сделки, необходимо, чтобы биржа была внесена в список разрешенных. Свяжитесь с нами , чтобы запросить это.

Если ваша биржа в настоящее время использует другой механизм для сигнализации гарантированных сделок с DV360, свяжитесь с нами , чтобы обсудить переход на это предпочтительное расширение.

0 (по умолчанию): Не гарантируется
1 : Гарантировано

ext продление сделок Необязательный.

Поддерживаемое расширение для объекта сделки

Поле Тип Подробности
guaranteed Целое число Это поле предназначено для указания того, является ли сделка гарантированной. Значение следует передавать в виде целого числа.

Для того чтобы DV360 принимал гарантированные сделки, необходимо, чтобы биржа была внесена в список разрешенных. Свяжитесь с нами , чтобы запросить это.

Если ваша биржа в настоящее время использует другой механизм для сигнализации гарантированных сделок с DV360, свяжитесь с нами , чтобы обсудить переход на это предпочтительное расширение.

0 (по умолчанию): Не гарантируется
1 : Гарантировано

Рекомендуется использовать deal.guar вместо этого поля.

Объект сайта

Поле Тип Подробности
id Нить Идентификатор сайта на бирже.
name Нить Не поддерживается.
domain Нить Домен сайта.

Рекомендуется указывать полный URL-адрес в поле site.page, а не только в поле site.domain.

cat Массив строк Не поддерживается.
sectioncat Массив строк Не поддерживается.
pagecat Массив строк Не поддерживается.
page Нить Полный URL-адрес, по которому будет показано объявление.

Для целей таргетирования рекомендуется отправлять полный URL-адрес.

ref Нить URL-адрес источника перехода на текущую страницу.
search Нить Не поддерживается.
mobile Целое число Не поддерживается.
privacypolicy Целое число Не поддерживается.
publisher Объект издателя Подробная информация об издателе сайта.
content Объект содержимого Подробная информация о содержимом сайта.
keywords Строка (формат CSV) Не поддерживается.
ext Расширения сайта Расширения для объекта сайта.

Объект расширения сайта

Поле Тип Подробности
inventorypartnerdomain Нить Используется для обмена данными об инвентаре CTV, см. пояснение к добавлению новых функций в приложение IAB CTV .

Объект приложения

Поле Тип Подробности
id Нить Идентификатор приложения на бирже.
name Нить Названия приложений, которые могут быть изменены по запросу издателей.

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

bundle Нить Необходимый.

Для iOS требуется числовой идентификатор приложения из магазина приложений. Мы не принимаем идентификатор пакета в стиле обратного DNS.

Для приложений CTV мы рекомендуем передавать идентификатор приложения, определенный магазином. Пожалуйста, придерживайтесь недавно опубликованных рекомендаций IAB OTT/CTV Store Assigned ID .

domain Нить Домен, например, mygame.foo.com
storeurl Нить Требуется для проверки файла app-ads.txt и подтверждения подлинности в магазине приложений Connected TV.
cat Массив строк Не поддерживается.
sectioncat Массив строк Не поддерживается.
pagecat Массив строк Не поддерживается.
ver Нить Не поддерживается.
privacypolicy Целое число Не поддерживается.
paid Целое число Не поддерживается.
publisher Объект издателя Информация об издателе приложения.
content Объект содержимого Информация о содержании приложения.
keywords Строка (в формате CSV) Не поддерживается.
ext Расширения приложений Расширения для объекта приложения.

объект расширения приложения

Поле Тип Подробности
inventorypartnerdomain Нить Используется для обмена данными об инвентаре CTV, см. пояснение к добавлению новых функций в приложение IAB CTV .

Объект содержимого

Мы рекомендуем передавать эти атрибуты, если они доступны.

Поле Тип Подробности
id Нить Идентификатор, однозначно определяющий содержимое.
episode Целое число Номер эпизода контента (обычно для видеоконтента).
title Нить Рекомендуется для запросов, связанных с телевидением, видео- и аудио.
series Нить Рекомендуется для запросов, связанных с телевидением, видео- и аудио.
season Нить Метка, обозначающая сезонность контента.
artist Нить Автор изображения указан в качестве художника.
genre Нить Жанр, наилучшим образом описывающий контент. DV360 рекомендует предоставлять этот сигнал для запросов CTV, видео и аудио.
DV360 поддерживает несколько таксономий значений жанров видео для этого поля:
  • Список жанров Google ( скачать )
  • Категории IAB ТВ/Фильмы/Спорт ( Скачать )
  • Классификация видеожанров Gracenote от Nielsen
album Нить Альбом, к которому относится контент, как правило, для аудио.
isrc Нить Международный стандартный код регистрации, соответствующий стандарту ISO-3901.
producer Объект производителя Подробная информация о производителе контента.
url Нить URL контента.
cat Массив строк Категории контента IAB, описывающие контент.
prodq Целое число Качество продукции:

0 (По умолчанию): Неизвестно
1 : Профессиональный
2 : Просьюмер
3 : Создано пользователем

videoquality Целое число Не поддерживается.
context Целое число Тип контента:

1 : Видео
2 : Игра
3 : Музыка
4 : Применение
5 : Текст
6 : Другое
7 : Неизвестно

contentrating Нить Рекомендуется для аудио- и видеотехники/CTV, поскольку мы начнем принимать решения по этому параметру.
userrating Нить Количество звёзд, лайков и т.д.
qagmediarating Целое число Рейтинг СМИ в соответствии с [руководящими принципами QAG](http://www.iab.net/ne_guidelines).

1 : Для всех категорий зрителей
2 : 12+
3 : Зрелый

keywords Строка (в формате CSV) Не поддерживается.
livestream Целое число Если контент представляет собой прямую трансляцию.

0 : Не в прямом эфире
1 : Контент доступен в режиме реального времени.

sourcerelationship Целое число

0 : Косвенный
1 : Прямой

len Целое число Длительность контента в секундах.

Рекомендуется для запросов, связанных с видео- и аудиооборудованием/телевизионными системами.

language Строка (ISO-639-1-alpha-2) Язык контента.
embeddable Целое число Индикатор возможности встраивания контента (например, встраиваемого видеоплеера).

0 : Не встраивается
1 : Встраиваемый

data Массив объектов данных Дополнительные данные.

Объект производителя

Поле Тип Подробности
id Нить Не поддерживается.
name Нить Не поддерживается.
cat Массив строк Не поддерживается.
domain Нить Домен наивысшего уровня производителя.

Объект данных

Поле Тип Подробности
id Нить Идентификатор поставщика данных.
name Нить Название биржи для поставщика данных.
segment Массив объектов сегментов Фактические значения данных.
ext Расширения данных Расширения для объекта Data.

Поддерживаемые расширения для объектов данных

Поле Тип Подробности
segtax Целое число Идентификатор таксономии. Подробнее см. в разделе «Таксономии сегментов» .
segclass Нить Версия классификатора, которая выдала идентификаторы сегментов в рамках таксономии.

Объект сегмента

Поле Тип Подробности
id Нить Идентификатор сегмента данных, специфичный для поставщика данных.
name Нить Название сегмента данных.
value Нить Значение сегмента данных.

Объект издателя

Поле Тип Подробности
id Нить Необходимый.
name Нить Не поддерживается.
cat Массив строк Не поддерживается.
domain Нить Не поддерживается.

Объект устройства

Поле Тип Подробности
ua Нить Необходимый.
sua Объект UserAgent Структурированная информация об агенте пользователя.
geo Геообъект Местонахождение устройства.
dnt Целое число Флаг «Не отслеживать» устанавливается в заголовке браузера.

0 : Отслеживание не ограничено.
1 : Не отслеживать

lmt Целое число Сигнал Limit Ad Tracking получил коммерческую поддержку.

0 : Отслеживание не ограничено.
1 : Отслеживание должно быть ограничено в соответствии с коммерческими правилами.

ip Нить Требуется, если используется IPv4.

Если IP-адрес усечен, его необходимо указать в параметре device.ext.truncated_ip .

ipv6 Нить Требуется при использовании IPv6.

Если IP-адрес усечен, его необходимо указать в параметре device.ext.truncated_ip .

devicetype Целое число Настоятельно рекомендуется для всех типов инвентаризации. Используется для улучшения распознавания типов устройств.
make Нить
model Нить
os Нить Операционная система устройства.

ios : В запросе приложения это указывает на трафик iOS.
android : Идентифицирует устройство Android, если ua или sua не идентифицируют устройство.
[anything else] : Используется в диагностике для выявления проблем.

Регистр в этом поле не имеет значения.

osv Нить Не поддерживается.
hwv Нить Аппаратная версия устройства.
h Целое число Физическая высота экрана в пикселях.
w Целое число Физическая ширина экрана в пикселях.
ppi Целое число Не поддерживается.
pxratio Двойной Отношение физических пикселей к пикселям, не зависящим от устройства.
js Целое число Не поддерживается.
geofetch Целое число Не поддерживается.
flashver Нить Не поддерживается.
language Строка (ISO-639-1-alpha-2) Язык устройства.
carrier Нить Не поддерживается.
mccmnc Нить Не поддерживается.
connectiontype Целое число Тип сетевого подключения
ifa Нить Идентификатор разрешен для использования рекламодателем в открытом виде.
didsha1 Нить Не поддерживается.
didmd5 Нить Не поддерживается.
dpidsha1 Нить Не поддерживается.
dpidmd5 Нить Не поддерживается.
macsha1 Нить Не поддерживается.
macmd5 Нить Не поддерживается.
ext Расширения устройств Расширения для объекта устройства.

Поддерживаемое расширение для объекта устройства

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

Поле Тип Подробности
truncated_ip Целое число Укажите, усечен ли IP-адрес в поле device.ip запроса на участие в тендере.

0 : Не усечено
1 : Усеченный

По умолчанию IP-адрес не усекается, и это требование действует, если IP-адрес усекается.

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

ifa_type Нить Укажите происхождение поля device.ifa: было ли оно предоставлено самим устройством или сгенерировано издателем или поставщиком услуг в цепочке поставок.

aaid : Android TV
rida : Року
afai : Amazon Fire
idfa : Apple tvOS
msai : Xbox/Microsoft
dpid : Общий идентификатор платформы устройства
ppid : Идентификатор, предоставленный издателем.
sspid : идентификатор, предоставленный SSP
sessionid : Кратковременный идентификатор сессии (только для fcapping)

attestation_token Строка (кодировка base64) Токен подтверждения на основе устройства для бирж, поддерживающих этот уровень проверки устройств.
atts Целое число (Только для iOS) Целочисленное значение, передаваемое для обозначения статуса авторизации отслеживания приложения.

0 : Не определено
1 : Ограниченный доступ
2 : Отказано
3 : Авторизовано

cdep Нить Метка «Устаревание сторонних файлов cookie Chrome».

См. раздел «Тестирование с использованием Chrome» и спецификацию сообщества IAB.

Объект UserAgent

Поле Тип Подробности
browsers Массив объектов BrandVersion Каждый объект BrandVersion идентифицирует браузер или аналогичный программный компонент.
platform Объект BrandVersion Определяет платформу.
mobile Целое число 0 (по умолчанию): Агент предпочитает контент "настольной версии" или "полный".
1 : Агент предпочитает контент для мобильных устройств.
architecture Нить Архитектура устройства, например, "x86" или "arm".
bitness Нить Например, разрядность устройства обозначается как "64" для 64-битной архитектуры.
model Нить Модель устройства.
source Целое число Источник данных, используемых для создания этого объекта, см. в разделе List: User-Agent Source . Рекомендуется использовать при передаче объекта UserAgent .

Объект BrandVersion

Поле Тип Подробности
brand Нить Идентификатор бренда, например, "Chrome" или "Windows". Обязательно.
version Массив строк Последовательность компонентов версии, расположенных в нисходящем иерархическом порядке (основная, второстепенная, микроверсия и так далее).

Геообъект

Поле Тип Подробности
lat Двойной Не поддерживается.
lon Двойной Не поддерживается.
type Целое число Не поддерживается.
accuracy Целое число Не поддерживается.
lastfix Целое число Не поддерживается.
ipservice Целое число Не поддерживается.
country Нить Не поддерживается.
region Нить Не поддерживается.
regionfips104 Нить Не поддерживается.
metro Нить Не поддерживается.
city Нить Не поддерживается.
zip Нить Не поддерживается.
utcoffset Целое число Не поддерживается.

Объект пользователя

Поле Тип Подробности
id Нить Поддерживается, если Google размещает таблицу соответствия идентификаторов.
buyeruid Нить Поддерживается, если SSP размещает таблицу соответствия идентификаторов.
yob Целое число Рекомендуется для таргетирования по демографическим показателям.
gender Нить Рекомендуется для таргетирования по демографическим показателям.
keywords Строка (CSV) Не поддерживается.
customdata Нить Не поддерживается.
geo Геообъект Не поддерживается.
data Массив объектов данных Дополнительные данные.
eids Массив объектов с расширенными идентификаторами Расширенные экземпляры идентификаторов предоставляются биржей.
ext Расширения пользователя Расширения для объекта пользователя.

Поддерживаемые расширения для объекта пользователя

Поле Тип Подробности
consent Строка (безопасная для веб-сайтов, base64) Строка согласия IAB.

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

Значение представляет собой безопасную для веб-сайтов двоичную строку, закодированную в формате Base64 с использованием пользовательского двоичного формата .

us_privacy Нить Если пользователь ознакомился с соблюдением требований CCPA или аналогичных законов.
consented_providers_settings . consented_providers Внешний объект (consented_providers_settings) содержит внутренний целочисленный массив (consented_providers). Когда согласие на использование рекламных технологий в соответствии с GDPR собирается через TCF, в этом поле перечисляются поставщики рекламных технологий, давшие согласие пользователю, которые не участвуют в TCF. См. « Технические характеристики Google по дополнительному согласию ».
eids Массив объектов с расширенными идентификаторами Расширенные экземпляры идентификаторов предоставляются биржей.

Расширенный объект ID

Поле Тип Подробности
source Нить Поставщик идентификатора
uids Массив объектов Extended ID UID Фактические идентификаторы

Расширенный идентификатор UID-объект

Поле Тип Подробности
id Нить Сам идентификатор.
atype Целое число Тип пользовательского агента, связанный с этим идентификатором.

Объект цепочки поставок

Поле Тип Подробности
complete Целое число 0 (по умолчанию): Цепочка поставок неполна.
1 : Цепочка поставок завершена и возвращается к издателю.
ver Нить Необходимый.
Значение имеет формат "major.minor", например, версия 1.0 — это строка "1.0".
nodes массив узлов цепочки поставок Необходимый.

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

В неполной цепочке поставок это представляет собой первый известный узел. Последний узел представляет собой организацию, отправившую этот запрос на участие в тендере.

объект узла цепочки поставок

Поле Тип Подробности
asi Нить Каноническое доменное имя системы SSP, Exchange, Header Wrapper и т. д., к которой подключаются участники торгов. Это может быть операционный домен системы, если он отличается от домена головной корпорации, для упрощения поиска WHOIS и обратного поиска IP-адресов с целью установления четкого права собственности на делегированную систему.

Это значение должно совпадать со значением, используемым для идентификации продавцов в файле ads.txt, если таковой существует.

sid Нить Идентификатор, связанный с учетной записью продавца или реселлера в рекламной системе. Он должен содержать то же значение, что и в транзакциях (например, запросах ставок OpenRTB) в поле, указанном SSP/биржей.

Как правило, в OpenRTB это publisher.id. В OpenDirect это обычно идентификатор организации издателя.

Длина сообщения должна быть ограничена 64 символами.

rid Нить Идентификатор запроса OpenRTB, предоставленный этим продавцом.
name Нить Название компании (юридического лица), которой производится оплата за товары, проданные под указанным seller_id.

Это значение является необязательным и НЕ должно быть включено, если оно присутствует в файле sellers.json рекламной системы.

domain Нить Доменное имя компании, представленной этим узлом.

Это значение является необязательным и НЕ должно быть включено, если оно присутствует в файле sellers.json рекламной системы.

hp Целое число Указывает, будет ли данный узел участвовать в процессе оплаты товарных запасов.

1 : Рекламная система в поле asi выплачивает деньги продавцу в поле sid, который, в свою очередь, отвечает за оплату предыдущему узлу в цепочке.
0 : Этот узел не участвует в процессе оплаты товарных запасов.

Для версии 1.0 SupplyChain это свойство всегда должно быть равно 1. Его обязательное включение является обязательным, поскольку ожидается, что в будущих версиях спецификации будут введены узлы, не связанные с обработкой платежей.

Разработчики должны обеспечить поддержку этой области и ее дальнейшее распространение при создании объектов SupplyChain в запросах на размещение ставок, отправляемых в нижестоящую рекламную систему.

Спецификация ответа на заявку

Объект BidResponse

Атрибут Поддерживается Детали реализации Всегда проходил
идентификатор В случае ошибки синтаксического анализа вместо идентификатора запроса на ставку может быть значение «0». Да
предложение места
бидид
кур Если возникает ошибка синтаксического анализа, этот параметр не передается. Для корректных запросов на торги всегда указывается значение трафика. Да
пользовательские данные
номер Это значение включается только в том случае, если в заявке на участие в тендере были обнаружены проблемы. Возможные значения:
2 : Неверный запрос
12 : Нарушение авторизации Ads.txt
16 : Неполная цепочка поставок
17 : Заблокированный узел цепочки поставок
Примечание: При обнаружении конкретного нарушения файла (app-)ads.txt или SupplyChain, в части (1%) ответов будет отображаться один из кодов 12, 16 или 17. Для всех остальных недействительных запросов будет отображаться код 2.
Запросы, содержащие NBR, будут выглядеть примерно так: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
наружный Если возникла проблема с запросом на участие в тендере, расширение ext может содержать информацию, которая поможет диагностировать ошибку, если это поддерживается.

Поддерживаемые расширения для объекта BidResponse

Атрибут Детали реализации
ошибка

Удобочитаемое описание ошибки в запросе на участие в тендере. Примеры ответов:

  • Текст запроса на участие в тендере был пустым.
  • Запрос на покупку/продажу не был оформлен в валюте, разрешенной для данной биржи.
  • В запросе на участие в тендере не был указан допустимый MIME-тип.
errHelp Ссылка на эту страницу.

Объект Seatbid

Атрибут Поддерживается Детали реализации Всегда проходил
делать ставку да
сиденье да
группа

Объект заявки

Атрибут Поддерживается Детали реализации Всегда проходил
идентификатор да
непрозрачный да
цена да
нурл
нарост
лурл
адм
адид
домен
пучок
iurl
сид да
кредит да
тактика
кот
атрибут
API
протокол
qagmediarating
язык
деалид
в
час
соотношение
соотношение
эксп

Поддерживаемые расширения для объекта ставки

Атрибут Детали реализации
apis DV360 отправит seatbid.bid.apis , если поддерживаются как OMID, так и MRAID. DV360 установит OMID_1 и MRAID в виде целочисленного массива.

параметры показа рекламы

В разделе 4.3 спецификации OpenRTB описаны два различных варианта обслуживания:

  • Уведомление о выигрыше было подано с указанием размера чека.
  • Наценка, указанная в заявке

DV360 поддерживает оба варианта.

  • Для баннерной рекламы DV360 всегда возвращает разметку в поле adm . Разметка, отображаемая в уведомлении о выигрыше, является необязательной.
  • Для видео/аудиорекламы, использующей протокол VAST, DV360 поддерживает возврат VAST XML в поле adm или в ответе на уведомление о выигрыше в зависимости от требований партнеров по обмену контентом.

Чтобы узнать о преимуществах и недостатках этих двух вариантов, обратитесь к спецификации OpenRTB.

Передовые методы

Настоятельно рекомендуется использовать идентификатор партнера Display and Video 360 в качестве идентификатора места. Использование идентификатора места, специфичного для конкретной биржи, не рекомендуется.

Убедитесь, что у ваших издателей есть файлы ads.txt или приложения с файлами app-ads.txt, и что вы указаны в этих файлах как авторизованный продавец или реселлер. Подробнее .

Также необходимо обеспечить согласованность информации, передаваемой в запросах на размещение ставок. Например, файл app.bundle должен соответствовать информации о мобильном устройстве и app.storeurl .

Подключенное телевидение

При передаче файлов device.ifa и device.lmt соблюдайте рекомендации IAB OTT IFA . Также необходимо реализовать device.ext.ifa_type для соответствия этим рекомендациям. Для всех наших возможностей ограничения частоты показа на CTV и таргетирования аудитории потребуется наличие IFA.

Также следует придерживаться недавно опубликованных рекомендаций IAB OTT/CTV Store Assigned ID — в них определяется, как следует передавать app.bundle для приложений CTV, — в основном используя идентификатор, определенный магазином приложений.

Измерение активного просмотра

Active View — это технология Google, используемая для измерения видимости показа и продолжительности его просмотра. Active View использует OMID как для медийной, так и для видеорекламы. Для включения измерения с использованием OMID биржи должны добавить следующие поля в запросы OpenRTB, чтобы DV360 знал, поддерживает ли клиент OMID.

  • Обязательно: добавьте API Framework ( Video.api=7 для OMSDK ) к запросам ставок. Это обязательно для Active View, чтобы включить измерение с использованием OMID.
  • Recommended: Adding omidpn and omidpv to Source.Ext is highly recommended because it will impact how viewability measurements are reported in DV360 to the customer. If the OMID partner name is not on the IAB certification list, we are required by MRC to report the viewability metrics separately from the MRC certified metrics. Learn more .

Часто задаваемые вопросы

Does DV360 Support exchange custom extensions?
Yes, in addition to the extensions listed in this specification, Display and Video 360 may also support custom extensions on a case-by-case basis. It is recommended to specify and test the custom extension during the integration period.
Does DV360 support rewarded video?
Yes, send us the rewarded video extension .
A lot of my inventory is showing up as demographics unknown, how do I improve demographic coverage?
Populate user.yob and user.gender in bid requests to DV360 to increase coverage.
Does DV360 have endpoints for each region?
No, we use a single endpoint globally and we automatically route requests to the nearest data center, so there's no region-specific endpoint we can provide.
What are the requirements for server-to-server (s2s) requests?
Reach out to request addition to our allowlist. The client User Agent has to be forwarded, and ensure that cookies are disabled/ignored in the response to an s2s VAST fetch.
Does DV360 support OMID?
We are able to measure viewability using OMID as long as it is declared as OMID-enabled at bid request time. Details about this are summarized on pages 24-25 .
Which version of Native do you support? Do you have any Native requirements?
We only support Native Ver1.2. Native specification .
Does DV360 support bid requests sent as GZIP?
DV360 can receive gzip compressed bid requests, and will respond with gzip compressed responses if Accept-Encoding header indicates it's supported.
Does DV360 support DBURL?
На данный момент нет.
Does DV360 support win loss notification?
Not at the moment. If you think it would be useful for us to support it please reach out with more details.
Does DV360 require App.name for targeting?
No, DV360 using App.name for reference but it is not required for targeting, App.bundle is used for targeting.
Can DV360 support multiple ad sizes sent in a single bid request?
Yes, we will consider all eligible creative sizes in banner.format.
Does DV360 support multiple formats in the same bid request?
We have limited support for multi-format bid requests, but are working on improving. We support display & video formats for interstitials, but do not currently support display & native. If you are sending multi-format bid requests, please reach out to request a test.
Does DV360 support mixed impression types in the same request?
Currently we only support video/banner interstitials. We are working on native/banner & video/banner. If there are other combinations please reach out to our team.
Can multiple seats each send multiple bids on one or more of such impression opportunities in the same request?
Да.
Does DV360 have a solution or particular need regarding capping or displaying the same advertiser for multiple such impression opportunities in the same request?
DV360 places enforcement that one advertiser can only bid up to one imp opportunities for each request. We expect SSPs to group imp objects meaningfully; eg, all on the same page, all in the same app, etc.
Does DV360 support multiple impressions in the same bid request?
DV360 currently supports multiple impression audio objects. However, we will need to test/enable each exchange that would like to use this feature. See bid request specification for more information. We are working on expanding this to other formats: 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Связаться с нами

If you have any questions or issues, reach out to our exchange support team.