Спецификация 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 Массив 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 ответ на заявку 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 полей в Источнике .

Объект Regs

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

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

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

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

Объект Imp

Поле Тип Подробности
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 : родной

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

secure Целое число Если для этого впечатления требуется безопасный HTTPS-URL или небезопасный HTTP-URL.
0 (по умолчанию): небезопасно
1 : безопасный
iframebuster Массив строк
exp Целое число Срок действия ставки устанавливается DV 360 без учёта значения, отправленного партнёром в этом поле. События показов, полученные после истечения периода ожидания показов (обычно 1 час), отбрасываются как просроченные и не подлежат оплате DV 360.
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 (выше/ниже/на выходе)
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
5 : Оболочка VAST 2.0
6 : Оболочка VAST 3.0
7 : VAST 4.0
8 : Оболочка VAST 4.0
9 : ДААСТ 1.0
10 : Обертка DAAST 1.0

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

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

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

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

Примечание: Чтобы считаться In-Stream (Placement или Plcmt Type 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) или подтипе Plcmt 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 для Active View.
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
7 : VAST 4.0
8 : Оболочка VAST 4.0

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 Массив объектов сделки Сделки, которые следует включить.

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

Поле Тип Подробности
id Нить Объект PMP не может содержать более одного объекта сделки на один идентификатор.
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 .

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 Нить Рекомендуется для запросов на CTV, видео и аудио.
series Нить Рекомендуется для запросов на CTV, видео и аудио.
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 Целое число Длина контента в секундах.

Рекомендуется для запросов на CTV/видео и аудио.

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

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

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

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

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

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

Поле Тип Подробности
id Нить Идентификатор поставщика данных.
name Нить Имя биржи для поставщика данных.
segment Массив объектов 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-альфа-2) Язык устройства.
carrier Нить Не поддерживается.
mccmnc Нить Не поддерживается.
connectiontype Целое число Тип сетевого подключения
ifa Нить Идентификатор, разрешенный для использования рекламодателем в открытом виде.
didsha1 Нить Не поддерживается.
didmd5 Нить Не поддерживается.
dpidsha1 Нить Не поддерживается.
dpidmd5 Нить Не поддерживается.
macsha1 Нить Не поддерживается.
macmd5 Нить Не поддерживается.
ext Расширения устройств Расширения для объекта устройства.

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

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

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

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

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

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

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

aaid : Android TV
rida : Roku
afai : Amazon Fire
idfa : Apple tvOS
msai : Xbox/Microsoft
dpid : общий идентификатор платформы устройства
ppid : идентификатор, предоставленный издателем
sspid : идентификатор, предоставленный поставщиком общих служб
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 Целое число Источник данных, использованных для создания этого объекта, см. в списке: Источник User-Agent . Рекомендуется при передаче объекта 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), оборачивающий внутренний массив Integer (consented_providers). Если согласие GDPR собирается через TCF, в этом поле перечисляются поставщики рекламных технологий, получившие согласие пользователя и не участвующие в TCF. См. « Техническую спецификацию дополнительного согласия Google ».
eids Массив объектов расширенного идентификатора Расширенные экземпляры идентификаторов, предоставляемые биржей.

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

Поле Тип Подробности
source Нить Поставщик идентификатора
uids Массив объектов 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 RequestId запроса, отправленного этим продавцом.
name Нить Название компании (юридического лица), которая получает оплату за инвентарь, проданный по указанному seller_id.

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

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

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

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

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

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

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

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

Объект BidResponse

Атрибут Поддерживается Подробности реализации Всегда проходил
идентификатор Если произошла ошибка синтаксического анализа, вместо идентификатора запроса ставки может быть «0». Да
ставка на место
бидид
дворняжка В случае ошибки анализа этот параметр не передаётся. Для корректного запроса ставки всегда предоставляется текущий трафик. Да
пользовательские данные
nbr Этот параметр включается только в случае обнаружения проблемы с запросом ставки. Возможные значения:
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"
  }
}
доб. Если возникла проблема с запросом на ставку, в расширении может содержаться информация, помогающая диагностировать ошибку (там, где это поддерживается).

Поддерживаемые расширения для объекта 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 .

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

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

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

Измерение Active View

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

  • Обязательно: добавьте API Framework ( Video.api=7 для OMSDK ) в запросы ставок. Это обязательно для Active View, чтобы включить измерение с помощью OMID.
  • Рекомендуется. Настоятельно рекомендуется добавить omidpn и omidpv в Source.Ext , поскольку это повлияет на то, как данные о видимости будут сообщаться клиенту в DV360. Если имя партнера OMID отсутствует в списке сертификации IAB , MRC требует от нас сообщать показатели видимости отдельно от показателей, сертифицированных MRC. Узнайте больше .

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

Осуществляет ли поддержка DV360 обмен пользовательскими расширениями?
Да, в дополнение к расширениям, перечисленным в этой спецификации, Display and Video 360 также может поддерживать пользовательские расширения в каждом конкретном случае. Рекомендуется указать и протестировать пользовательское расширение в период интеграции.
Поддерживает ли DV360 видео с вознаграждением?
Да, отправьте нам вознагражденное расширение видео .
Большая часть моего инвентаря отображается как «Неизвестная демографическая информация». Как мне улучшить демографический охват?
Укажите user.yob и user.gender в запросах ставок на DV360, чтобы увеличить охват.
Есть ли у DV360 конечные точки для каждого региона?
Нет, мы используем единую конечную точку во всем мире и автоматически маршрутизируем запросы в ближайший центр обработки данных, поэтому мы не можем предоставить конечную точку для конкретного региона.
Каковы требования к запросам между серверами (s2s)?
Свяжитесь с нами , чтобы запросить добавление в наш белый список. Пользовательский агент клиента необходимо перенаправить и убедиться, что файлы cookie отключены/игнорируются в ответ на выборку VAST s2s.
Поддерживает ли DV360 OMID?
Мы можем измерить видимость с помощью OMID, если во время запроса ставки он объявлен как поддерживающий OMID. Подробности об этом изложены на страницах 24-25 .
Какую версию Native вы поддерживаете? Есть ли у вас какие-либо требования к Native?
Мы поддерживаем только Native Ver1.2. Родная спецификация .
Поддерживает ли DV360 запросы ставок, отправляемые в формате GZIP?
DV360 может получать запросы ставок, сжатые gzip, и будет отвечать ответами, сжатыми gzip, если заголовок Accept-Encoding указывает, что это поддерживается.
Поддерживает ли DV360 DBURL?
На данный момент нет.
Поддерживает ли DV360 уведомление о выигрыше и проигрыше?
Не сейчас. Если вы считаете, что нам было бы полезно поддержать его, сообщите нам более подробную информацию.
Требуется ли для DV360 App.name для таргетинга?
Нет, DV360 использует App.name для справки, но это не обязательно для таргетинга. Для таргетинга используется App.bundle .
Может ли DV360 поддерживать несколько размеров объявлений, отправленных в одном запросе ставки?
Да, мы рассмотрим все подходящие размеры объявлений в формате Banner.format.
Поддерживает ли DV360 несколько форматов в одном запросе ставки?
У нас ограниченная поддержка многоформатных запросов ставок, но мы работаем над ее улучшением. Мы поддерживаем форматы медийной и видеорекламы для межстраничных объявлений, но в настоящее время не поддерживаем медийную и нативную рекламу. Если вы отправляете многоформатные запросы ставок, свяжитесь с нами и запросите тестирование.
Поддерживает ли DV360 смешанные типы показов в одном запросе?
В настоящее время мы поддерживаем только межстраничные видео и баннеры. Мы работаем над нативным/баннером и видео/баннером. Если есть другие комбинации, свяжитесь с нашей командой.
Могут ли несколько мест отправлять несколько ставок на одну или несколько таких возможностей показа в одном запросе?
Да.
Есть ли у DV360 решение или особая потребность в ограничении или показе одного и того же рекламодателя для нескольких таких возможностей показа в одном запросе?
DV360 устанавливает требование, согласно которому один рекламодатель может предлагать только одну ставку для каждого запроса. Мы ожидаем, что SSP будут осмысленно группировать объекты-импы; например, все на одной странице, все в одном приложении и т. д.
Поддерживает ли DV360 несколько показов в одном запросе ставки?
DV360 в настоящее время поддерживает несколько аудиообъектов показа. Однако нам нужно будет протестировать/включить каждую биржу, которая захочет использовать эту функцию. Дополнительную информацию см. в спецификации запроса ставок . Мы работаем над распространением этого на другие форматы:
{
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"
}

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

Если у вас есть какие-либо вопросы или проблемы, обратитесь в нашу службу поддержки обмена.