Спецификация 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 полей в Source .

Объект Regs

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

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

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

Когда мы получаем строку 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 : родной

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

secure Целое число Если для этого показа требуется безопасный HTTPS-URL или небезопасный HTTP-URL.
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 : Всплывание (выше/ниже/на выходе)
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 : ВАСТ 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) должны сигнализировать о размещении out-stream типа 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 : VPAID2
3 : MRAID 1
4 : ОРММА
5 : МРЕЙД 2
6 : МРЕЙД 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 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 Нить Рекомендуется для запросов на CTV, видео и аудио.
series Нить Рекомендуется для запросов на CTV, видео и аудио.
season Нить Метка сезона контента.
artist Нить Автором контента указан художник.
genre Нить Жанр, который лучше всего описывает контент. DV360 рекомендует предоставлять этот сигнал для запросов CTV, видео и аудио.
DV360 поддерживает несколько таксономий значений жанра видео для этого поля:
  • Список жанров Google ( Скачать )
  • Категории IAB TV/Movie/Sports ( Скачать )
  • Таксономия жанров видео 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 Фактические значения данных.

Сегмент объекта

Поле Тип Подробности
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: было ли оно предоставлено самим устройством или сгенерировано издателем или поставщиком общих служб в цепочке поставок.

aaid : Android TV
rida : Року
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 Массив объектов Extended ID Расширенные экземпляры идентификаторов, предоставляемые биржей.
ext Пользовательские расширения Расширения для объекта пользователя.

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

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

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

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

us_privacy Нить Если пользователь увидел соответствие CCPA или аналогичным законам.
consented_providers_settings . consented_providers Внешний объект (consented_providers_settings), оборачивающий внутренний массив целых чисел (consented_providers). Передайте поставщикам согласие на запрос GDPR. Подробнее см. Consented Provider Solution для GDPR .
eids Массив объектов Extended ID Расширенные экземпляры идентификаторов, предоставляемые биржей.

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

Поле Тип Подробности
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 : Этот узел не участвует в потоке платежей за инвентарь.

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

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

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

Объект BidResponse

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

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

Атрибут Подробности реализации
ошибаться

Человекочитаемое описание ошибки с запросом ставки. Случаи ответа включают:

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

Объект Seatbid

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

Объект ставки

Атрибут Поддерживается Подробности реализации Всегда проходил
идентификатор да
неприятный да
цена да
нурл
кап
лурл
адм
адид
домен
пучок
iurl
сид да
крид да
тактика
кот
атр
апи
протокол
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 отключены/игнорированы в ответе на выборку s2s VAST.
Поддерживает ли DV360 OMID?
Мы можем измерить видимость с использованием OMID, если она объявлена ​​OMID с поддержкой во время запроса. Подробности об этом приведены на страницах 24-25 .
Какую версию нативного вы поддерживаете? У вас есть собственные требования?
Мы поддерживаем только родной Ver1.2. Нативная спецификация .
Отправлены ли запросы на поддержку DV360 в качестве GZIP?
DV360 может получать запросы на сжатую ставку GZIP и ответит с помощью сжатых ответов GZIP, если заголовок приема, кодируя, указывает на его поддерживается.
Поддерживает ли DV360 Dburl?
На данный момент нет.
DV360 поддерживает уведомление о победе?
Не сейчас. Если вы думаете, что нам было бы полезно поддержать его, пожалуйста, обратитесь к более подробной информации.
Требуется ли DV360 app.name для таргетинга?
Нет, DV360 с использованием app.name для справки, но это не требуется для таргетинга, App.bundle используется для таргетинга.
Может ли DV360 поддержать несколько размеров объявлений, отправленных в один запрос на предложение?
Да, мы рассмотрим все подходящие творческие размеры в Banner.format.
Поддерживает ли DV360 несколько форматов в одном и том же запросе ставки?
Мы имеем ограниченную поддержку для многоформатных запросов предложений, но работаем над улучшением. Мы поддерживаем отображение и форматы видео для интерстициалов, но в настоящее время не поддерживаем дисплей и нативные. Если вы отправляете многоформатные запросы на ставку, пожалуйста, обратитесь за запросом теста.
Поддерживает ли DV360 смешанные типы впечатлений в том же запросе?
В настоящее время мы поддерживаем только интерстиции видео/баннера. Мы работаем над Native/Banner & Video/Banner. Если есть другие комбинации, пожалуйста, обратитесь к нашей команде.
Могут ли несколько мест отправить несколько предложений на одну или несколько таких возможностей впечатления в одном и том же запросе?
Да.
Есть ли у DV360 решение или особую потребность в ограничении или отображении одного и того же рекламодателя для множества таких возможностей впечатления в том же запросе?
DV360 устанавливает право соблюдения, что один рекламодатель может предложить только одну возможность IMP для каждого запроса. Мы ожидаем, что SSP будут значительно группировать объекты IMP; Например, все на одной странице, все в одном и том же приложении и т. Д.
Поддерживает ли 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"
}

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

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