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

При работе с этой страницей держите под рукой спецификацию OpenRTB 2.6.

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

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

Спецификация запроса ставки

Запрос ставки – это HTTP-запрос POST с телом объекта запроса ставки. Формат тела определяется в заголовке Content-Type.

В ответ на запрос ставки возвращается HTTP-ответ 204 без тела (если ставка не сделана) или HTTP-ответ 200 с телом ответа на запрос ставки.

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

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

Формат JSON

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

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

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

Формат Protobuf

ПРИМЕЧАНИЕ. Поддержка Protobuf находится на этапе бета-тестирования. Если вас интересует эта функция, свяжитесь со службой поддержки DV360.

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

Поддержка расширений ограничена. Если вы хотите использовать их, обратитесь в службу поддержки Дисплея и Видео 360.

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

Объект запроса ставки

Поле Тип Сведения
id Строка Обязательно.
Уникальный идентификатор запроса ставки. Его можно использовать для идентификации отдельных запросов в течение очень короткого времени после их обработки.
imp Массив Imp Требуется хотя бы один объект 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 в источнике.
purch Целое число Параметр "Оплаченный трафик" относится к трафику, перенаправленному с ресурсов, не принадлежащих издателю, который оплатил трафик или привлек посетителей вознаграждением.
Это соответствует новой спецификации MRC IVT 2.0.

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

gdemsignals Строка Блоб сигнала SCAR API из GMA SDK.
Рекомендуется, если используется трафик GMA SDK. В противном случае запрещено.
disable_gma_format int Можно не использовать при наличии элемента 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.
schain Цепь поставок В новых интеграциях вместо него следует использовать поле schain в источнике.

Объект Regs

Поле Тип Сведения
coppa Целое число 0 (по умолчанию). Закон США "О защите личных сведений детей в интернете" (COPPA) неприменим к этому запросу.
1: к этому запросу применим закон США "О защите личных сведений детей в интернете" (COPPA).
gdpr Строка Флаг, указывающий, регулируется ли запрос регламентом GDPR. 0 – нет, 1 – да, отсутствие значения означает, что это неизвестно. Подробную информацию можно найти в документации DV360 по GDPR. Ожидается только один из параметров: regs.gdpr или regs.ext.gdpr.
us_privacy Строка Передает сигналы, связанные с конфиденциальностью потребителей в соответствии с законодательством США. Ознакомьтесь со спецификациями строки конфиденциальности США. Когда мы получаем строку us_privacy в запросе ставки и строка IAB указывает, что пользователь отказался, Дисплей и Видео 360 считает запрос непригодным для персонализированных ставок. Мы не передаем сигнал IAB другим поставщикам.

Можно указать только одно значение: regs.us_privacy, user.us_privacy или user.ext.us_privacy.
gpp Строка Содержит строку согласия протокола Global Privacy Protocol. DV360 поддерживает только некоторые разделы GPP, в том числе US National, California и другие. Разделы спецификации TCF от IAB Europe не принимаются. Вместо них используйте user.consent или user.ext.consent.
gpp_sid Массив целых чисел Массив разделов строки согласия по протоколу Global Privacy Protocol, которые должны применяться к этой транзакции.
ext Расширения Regs Необязательное поле.

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

Поле Тип Сведения
gdpr Целое число Флаг, указывающий, распространяются ли на запрос правила GDPR, как описано в разделе regs.gdpr. Можно указать только одно значение: regs.gdpr или regs.ext.gdpr.
us_privacy Строка Подробная информация приведена в документации по regs.us_privacy. Можно указать только одно значение: regs.us_privacy, regs.ext.us_privacy или user.ext.us_privacy.

Объект Imp

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

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

clickbrowser Целое число

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

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

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

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

Объект расширения показа

Поле Тип Сведения
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 – Flash.

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 Целое число Ширина в пикселях, не зависящих от устройства.
h Целое число Высота в пикселях, не зависящих от устройства.
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 – DAAST 1.0
10 – контейнер DAAST 1.0

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

0 (по умолчанию): неизвестно
1: In-Stream
2: в баннере
3: в статье
4: в фиде
5: плавающее

Примечание. Чтобы место размещения или показ считались In-Stream (тип места размещения 1), для них должен быть включен звук и правильно задан метод воспроизведения (подходят значения 1, 3, 4 и 5).
plcmt Целое число Настоятельно рекомендуется указывать в запросе ставки место размещения видеорекламы (параметр plcmt). Если оба поля отсутствуют, место размещения будет классифицировано как неизвестное.

0 (по умолчанию): неизвестно
1: In-Stream
2: сопутствующий контент
3: межстраничное объявление
4: без контента/отдельное объявление

Примечание. Чтобы место размещения или показ считались In-Stream (тип места размещения 1), для них должен быть включен звук и правильно задан метод воспроизведения (подходят значения 1, 3, 4 и 5).

Примечание. Если указаны оба параметра (plcmt и placement), приоритет будет иметь plcmt. Подробнее о переходе на plcmt можно узнать в руководстве IAB.

Примечание. 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) или подтипом места размещения 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: ORMMA.
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: Omid V1

companiontype Массив целых чисел Не поддерживается.
maxseq Массив целых чисел Не поддерживается.
feed Целое число Тип аудиофида. Ознакомьтесь со списком типов фидов в AdCOM 1.0.

1: музыкальный стриминговый сервис;
2: FM/AM-радио (контент, который транслируется в прямом эфире, а также доступен через онлайн-стриминг);
3: подкаст (оригинальный предварительно записанный контент, распространяемый в виде эпизодов);
4: радиопередача в записи (записанный фрагмент радиошоу, которое изначально транслировалось в прямом эфире);
5: интернет-радио (контент, который доступен только через онлайн-стриминг, а не в AM/FM-диапазоне);
6: видеоигра (фоновая музыка в видеоиграх);
7: преобразование текста в речь (аудиокниги, плагин для сайта, который может читать статьи).

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

Нативный объект

Подробнее о спецификациях нативных объявлений DV360…

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

7: Omid V1

battr Массив целых чисел Не поддерживается.

Объект PMP

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

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

Поле Тип Сведения
id Строка Объект PMP не может содержать более одного объекта сделки для каждого идентификатора.
bidfloor Двойной трекер Минимальная ставка для этого показа в цене за тысячу показов.

Обязательно, если at=3.

bidfloorcur Строка Валюта, указанная с помощью буквенных кодов ISO 4217.

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

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

1 – первая цена
2 – вторая цена
3 – фиксированная цена

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

Если рабочих мест нет, то нет и ограничений на них.

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

Если лицензий нет, то нет и ограничений на домены.

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

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

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

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

ext Расширения со спецпредложениями Необязательное поле.

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

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

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

Если ваша биржа использует другой механизм для передачи сигналов о гарантированных сделках в 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 Объект Publisher Информация об издателе сайта.
content Объект контента Сведения о контенте на сайте.
keywords Строка (формат CSV) Не поддерживается.
ext Расширения сайта Расширения для объекта сайта.

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

Поле Тип Сведения
inventorypartnerdomain Строка Используется для совместного использования инвентаря подключенных телевизоров. Подробнее о приложениях для подключенных телевизоров от IAB…

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

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

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

bundle Строка Обязательно.

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

Для приложений для подключенных телевизоров мы рекомендуем передавать идентификатор приложения, заданный магазином. Соблюдайте недавно опубликованные правила IAB в отношении идентификаторов, используемых при показе на платформах с поддержкой технологии OTT и подключенных телевизорах.

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

Объект ссылки на приложение

Поле Тип Сведения
inventorypartnerdomain Строка Используется для совместного использования инвентаря подключенных телевизоров. Подробнее о приложениях для подключенных телевизоров от IAB…

Объект контента

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

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

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

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

1 – видео
2 – игра
3 – музыка
4 – приложение
5 – текст
6 – другое
7 – неизвестно

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

1: все аудитории
2: 12+
3: для взрослых

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

0 – не транслируется в прямом эфире
1 – транслируется в прямом эфире

sourcerelationship Целое число

0: дополнительная покупка
1: прямая покупка

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

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

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

0: не встраивается
1: встраивается

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

Объект продюсера

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

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

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

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

Поле Тип Сведения
segtax Целое число Идентификатор классификации. Подробнее о классификациях сегментов…
segclass Строка Версия классификатора, который создал идентификаторы сегментов в классификации.

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

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

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

Поле Тип Сведения
id Строка Обязательно.
name Строка Не поддерживается.
cat Массив строк Не поддерживается.
domain Строка Не поддерживается.

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

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

0 – отслеживание не ограничено
1 – не отслеживать

lmt Целое число Сигнал ограничения отслеживания рекламы, одобренный коммерческой организацией.

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

ip Строка Обязательный при использовании адреса IPv4.

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

ipv6 Строка Обязательно, если используется IPv6.

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

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

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

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

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

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

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

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

0: не обрезано
1: обрезано

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

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

ifa_type Строка Укажите источник поля device.ifa: само устройство или издатель или платформа продавца в цепочке поставок.

aaid: Android TV
rida: Roku
afai: Amazon Fire
idfa: Apple tvOS
msai: Xbox/Microsoft
dpid: Generic device platform ID
ppid: Publisher provided ID
sspid: SSP provided ID
sessionid: Short-lived session ID (fcapping only)

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 Целое число Источник данных, использованных для создания этого объекта. Подробнее о списке источников данных агента пользователя… Рекомендуется при передаче объекта 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 Объект Geo Не поддерживается.
data Массив объектов данных Дополнительные данные.
eids Массив объектов расширенного идентификатора. Экземпляры расширенных идентификаторов, предоставленные биржей.
ext Расширения для пользователей Расширения для объекта пользователя.

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

Поле Тип Сведения
eids Массив объектов расширенного идентификатора. Экземпляры расширенных идентификаторов, предоставленные биржей.
consented_providers_settings.consented_providers Внешний объект (consented_providers_settings), содержащий внутренний массив целых чисел (consented_providers). Если согласие по GDPR собирается с помощью TCF, в этом поле перечислены поставщики рекламных технологий, которые не поддерживают TCF, но на взаимодействие с которыми пользователь дал согласие. Техническая спецификация "Дополнительное согласие" от Google.
us_privacy Строка Подробная информация приведена в документации по regs.us_privacy. Можно указать только одно значение: regs.us_privacy, regs.ext.us_privacy или user.ext.us_privacy.

Объект расширенного идентификатора

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

Объект Extended ID UID

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

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

Поле Тип Сведения
complete Целое число 0 (по умолчанию): цепочка поставок неполная.
1: цепочка поставок завершена и ведет к издателю.
ver Строка Обязательно.
Значение имеет формат "основная.дополнительная", например версия 1.0 – это строка "1.0".
nodes Массив узлов цепочки поставок Обязательно.

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

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

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

Поле Тип Сведения
asi Строка Каноническое доменное имя платформы продавца, биржи, контейнера заголовка или другой системы, к которой обращаются системы назначения ставок. Вы можете указать действующий домен платформы, если он отличается от родительского корпоративного домена. Такая возможность предусмотрена для того, чтобы упростить поиск WHOIS и обратные запросы IP. В этом случае можно точно установить владельца соответствующей системы.

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

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

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

Длина не должна превышать 64 символа.

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

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

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

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

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

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

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

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

Спецификация ответов на запросы ставок

Объект BidResponse

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

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

Атрибут Особенности реализации
err

Описание ошибки, связанной с запросом ставки, в удобном для восприятия формате. Ответы могут быть следующими:

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

Объект seatbid

Атрибут Поддерживается Особенности реализации Всегда пройдено
ставка Да
место; Да
group

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

Атрибут Поддерживается Особенности реализации Всегда пройдено
id Да
Идентификатор показа Да
цена Да
nurl
кап
lurl
adm
adid
adomain
bundle
iurl
cid Да
crid Да
тактика;
CAT
атриб.
api
протокол
qagmediarating
language
dealid
w
ч.
wratio
hratio
exp

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

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

Варианты показа объявлений

В разделе 4.3 спецификации OpenRTB описаны два варианта показа:

  • Разметка, показанная в уведомлении о выигрыше
  • Разметка, переданная в ставке

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

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

Преимущества и недостатки этих вариантов описаны в спецификации OpenRTB.

Рекомендации

Мы настоятельно рекомендуем использовать в качестве идентификатора места размещения идентификатор партнера Дисплея и Видео 360. Не рекомендуется использовать идентификаторы мест, относящиеся к определенной бирже.

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

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

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

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

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

Отслеживание показов Active View

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

  • Обязательно добавьте в запросы ставок фреймворк API (Video.api=7 для Web Video OMSDK, Native.api=7 для Native App OMSDK, Banner.api=7 или Audio.api=7). Это обязательное условие для того, чтобы Active View мог собирать данные с помощью OMID.
  • Рекомендуется добавить omidpn и omidpv в Source.Ext, поскольку это повлияет на то, как данные о видимости будут передаваться клиенту в DV360. Если название партнера OMID не указано в списке сертифицированных компаний IAB, мы должны в соответствии с требованиями MRC предоставлять показатели видимости отдельно от показателей, сертифицированных MRC. Подробнее…
Отслеживание показов Active View для нативных объявлений

Чтобы включить отслеживание Active View для нативных объявлений, DV360 требует от издателей и бирж выполнения дополнительных действий.

  • Нативные медийные объявления. В ответ на запрос ставки в объект adm.native Дисплей и Видео 360 добавляет следующий код eventtrackers:

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

    Биржи должны передавать издателям дополнительные трекеры событий, а издатели – выполнять следующие действия:

    1. Установите OMSDK.
    2. Загружайте OMSDK при показе нативных объявлений.
    3. Выполняет код JavaScript в элементе eventtrackers.url с заданными параметрами.

  • Нативные видеообъявления. Дисплей и Видео 360 позволяет отслеживать видимость, добавляя стандартное расширение AdVerifications в XML-код VAST.

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

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

Регламент ЕС в отношении ИИ для нативной рекламы на сторонних платформах

Чтобы рекламодатели могли соблюдать новые правила прозрачности. Согласно регламентам ЕС, Индии и штата Нью-Йорк в отношении ИИ, если в рекламе используются объекты, созданные или измененные с помощью ИИ, объявление должно содержать сообщение об этом. С июля 2026 года рекламодатели смогут добавлять в креативы Дисплея и Видео 360 (DV360) отметки о том, что они созданы или изменены с помощью ИИ. Это поможет соблюдать актуальные требования законодательства о прозрачности использования искусственного интеллекта.

Рекламодатели могут добавлять отметки об ИИ-контенте непосредственно в креативы или с помощью специального параметра в интерфейсе и API Дисплея и Видео 360. Подробнее о том, как использовать настройки ярлыков ИИ-контента для пометки объявлений.

Для объявлений, созданных Google, мы используем минимальный ярлык ИИ до клика и раскрытие информации после клика на панели About This Ad (О рекламе).

Для форматов нативных объявлений на сторонних платформах Google не может повлиять на окончательный вид объявления. В этих случаях сигнал о подтверждении будет распространяться как часть ответа на запрос объявления, чтобы биржи и издатели могли показывать итоговое объявление вместе с пометкой об ИИ-контенте или уведомлением. Сигнал будет частью поля adm.native.ext ответа на запрос нативного объявления. Новое поле adm.native.ext имеет следующий формат:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }
  • should_disclosure_ai (true или false) указывает, нужно ли добавлять пометку об ИИ в финальное объявление.
  • Поле ai_disclosure_url может присутствовать или отсутствовать. Оно будет присутствовать, только если для параметра should_disclosure_ai задано значение true, а поле URL native.privacy пустое. В этом случае при нажатии на пометку об ИИ пользователь должен переходить по URL, указанному в этом поле. В противном случае при нажатии на пометку об ИИ пользователь должен переходить к стандартному полю URLnative.privacy.

Эти сигналы должны передаваться издателям, чтобы они могли показывать объявления с пометкой об ИИ-контенте.

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

Поддерживает ли DV360 пользовательские расширения бирж?
Да, помимо расширений, перечисленных в этой спецификации, Дисплей и Видео 360 может также поддерживать специальные расширения в каждом отдельном случае. Рекомендуем указать и протестировать собственное расширение в период интеграции.
Поддерживает ли DV360 видеорекламу с вознаграждением?
Да, отправьте нам расширение для видеообъявлений с вознаграждением.
Большая часть моего инвентаря относится к категории "Неизвестные демографические данные". Как улучшить охват демографических данных?
Указывайте в запросах ставок для DV360 значения user.yob и user.gender, чтобы увеличить охват.
Есть ли в Дисплее и Видео 360 конечные точки для каждого региона?
Нет, мы используем единую конечную точку для всех регионов и автоматически направляем запросы в ближайший центр обработки данных, поэтому у нас нет конечной точки, предназначенной для определенного региона.
Каковы требования к межсерверным запросам?
Обратитесь к нам с просьбой добавить вас в белый список. Агент пользователя клиента должен быть переслан, а файлы cookie должны быть отключены или проигнорированы в ответе на запрос VAST s2s.
Поддерживает ли DV360 OMID?
Мы можем отслеживать видимость с помощью OMID, если в запросе ставки указано, что OMID включен. Подробная информация об этом приведена на страницах 24–25.
Какую версию Native вы поддерживаете? У вас есть требования к нативной рекламе?
Мы поддерживаем только нативный формат версии 1.2. Спецификация нативных объявлений.
Поддерживает ли DV360 запросы ставок, отправленные в формате GZIP?
DV360 может получать запросы ставок, сжатые с помощью gzip, и отправлять ответы, сжатые с помощью gzip, если в заголовке Accept-Encoding указано, что это поддерживается.
Поддерживает ли DV360 DBURL?
Нет, сейчас такая функция не поддерживается.
Поддерживает ли DV360 уведомления о потере?
Да, Дисплей и Видео 360 заполняет поле bid.lurl в ответах на запросы ставок. Если ставка проигрывает, биржа может отправить на этот URL запрос с указанием причины, которая будет показана рекламодателям. Эти причины могут помочь рекламодателям избежать потерь в будущем.
Требуется ли в DV360 параметр App.name для таргетинга?
Нет, DV360 использует App.name для справки, но для таргетинга это не требуется. App.bundle используется для таргетинга.
Поддерживает ли Дисплей и Видео 360 несколько размеров объявлений, отправленных в одном запросе ставки?
Да, мы будем учитывать все подходящие размеры объявлений в banner.format.
Поддерживает ли DV360 несколько форматов в одном запросе ставки?
Мы поддерживаем многоформатные запросы ставок, но работаем над улучшением этой функции. Мы поддерживаем медийные и видеоформаты для межстраничных объявлений, но не поддерживаем медийные и нативные форматы. Если вы отправляете многоформатные запросы ставок, запросите тестирование.
Поддерживает ли DV360 разные типы показов в одном запросе?
В настоящее время мы поддерживаем только межстраничные видеообъявления и баннеры. Мы работаем над нативными объявлениями, баннерами и видеообъявлениями. Если вы используете другие сочетания, обратитесь в нашу службу поддержки.
Могут ли несколько рабочих мест отправлять несколько ставок на одну или несколько возможностей показа в одном запросе?
Да.
Есть ли у DV360 решение или особые требования в отношении ограничения частоты показа или показа одного и того же объявления рекламодателя для нескольких таких возможностей показа в одном запросе?
В DV360 действует ограничение: рекламодатель может делать ставки только на один показ в рамках каждого запроса. Мы ожидаем, что SSP-платформы будут группировать объекты imp по смыслу, например все объекты на одной странице или в одном приложении.
Поддерживает ли DV360 несколько показов в одном запросе ставки?
В настоящее время Дисплей и Видео 360 поддерживает несколько объектов аудиопоказа. Однако нам нужно будет протестировать и включить каждую биржу, которая захочет использовать эту функцию. Подробнее о спецификации запроса ставки… Мы работаем над тем, чтобы добавить поддержку других форматов: 
{
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"
}

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

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