При просмотре этой страницы держите под рукой спецификацию 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 . Для аудиомодулей поддерживается более одного объекта |
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 . В отчетности для покупателей это будет называться «Источник трафика издателя» и будет иметь одно из следующих значений: |
gdemsignals | Нить | Сигнальный блок SCAR API из GMA SDK. Рекомендуется, если трафик GMA SDK, в противном случае запрещено. |
disable_gma_format | инт | Необязательно, если предоставлен gdemsignals , в противном случае запрещено.0 (по умолчанию): при заполнении gdemsignals ответ на заявку adm представляет собой двоичный двоичный объект JSON.1 : Вместо двоичного JSON-объекта также будет предоставлен рекламный тег. |
Исходный объект
Поле | Тип | Подробности |
---|---|---|
fd | Целое число | Организация, ответственная за окончательное решение о продаже показа0 (по умолчанию): решение принимает биржа.1 : Решение принимается вышестоящим источником. |
tid | Нить | Не поддерживается. |
pchain | Нить | Не поддерживается. |
schain | Цепочка поставок | Требуется почти во всех случаях. Это поле предпочтительнее, чем предоставление |
ext | Расширения источника | Необязательный. |
Объект исходных расширений
Это расширение настоятельно рекомендуется, поскольку оно влияет на то, как показатели видимости передаются клиенту в DV3. Если название партнера OMID НЕ входит в список сертификации IAB , MRC обязывает нас сообщать показатели видимости отдельно от сертифицированных MRC показателей. Подробнее .
Поле | Тип | Подробности |
---|---|---|
omidpn | Нить | Идентификатор интеграции OM SDK. Совпадает с параметром «name» объекта OMID Partner. |
omidpv | Нить | Версия интеграции OM SDK. Совпадает с параметром "versionString" объекта OMID Partner. |
schain | Цепочка поставок | Вместо этого новые интеграции должны использовать schain полей в Источнике . |
Объект Regs
Поле | Тип | Подробности |
---|---|---|
coppa | Целое число | 0 (по умолчанию): COPPA не применим к этому запросу.1 : Этот запрос соответствует требованиям COPPA. |
ext | Расширения правил | Необязательный. |
Объект расширения Regs
Поле | Тип | Подробности |
---|---|---|
gdpr | Целое число | Укажите, относится ли запрос на ставку к региону ЕЭЗ.0 (по умолчанию): регион, не входящий в ЕЭЗ.1 : регион ЕЭЗ,Более подробную информацию см. в разделе Решение Consented Provider для GDPR . |
us_privacy | Нить | Для реализации строки us_privacy следуйте технической спецификации, предоставленной IAB Tech Lab. Когда мы получаем строку |
Объект Imp
Поле | Тип | Подробности |
---|---|---|
id | Нить | Уникальный идентификатор для этого показа в контексте запроса ставки (обычно значение начинается с 1 и увеличивается до n для n показов). |
metric | Объект | Не поддерживается. |
banner | Баннер | Требуется для размещения баннерной рекламы. |
video | Видео | Требуется для возможностей видеорекламы. |
audio | Аудио | Требуется для аудиорекламы. |
native | Родной | Требуется для возможностей нативной рекламы. |
pmp | ПМП | Для этого показа действуют сделки частной торговой площадки. |
displaymanager | Нить | Название партнёра по рекламному посредничеству, технологии SDK или плеера, отвечающего за рендеринг рекламы (обычно видео или мобильной). Используется некоторыми рекламными серверами для настройки рекламного кода партнёром. Рекомендуется для видео и/или приложений. |
displaymanagerver | Нить | Версия партнёра по рекламному посреднику, технологии SDK или проигрывателя, отвечающего за рендеринг рекламы (обычно видео или мобильной). Используется некоторыми рекламными серверами для настройки рекламного кода партнёром. Рекомендуется для видео и/или приложений. |
instl | Целое число | 0 (по умолчанию): не интерстициальный.1 : реклама является интерстициальной или полноэкранной. |
tagid | Нить | Идентификатор конкретного места размещения рекламы или тега объявления, использованного для начала аукциона. Это может быть полезно для устранения неполадок или оптимизации покупателем. |
bidfloor | Плавать | Минимальная ставка для этого показа, выраженная в CPM. |
bidfloorcur | Нить | Валюта указана с использованием буквенных кодов ISO-4217. |
clickbrowser | Целое число | Указывает тип браузера, открываемого при нажатии на креатив в приложении. Обратите внимание, что Safari View Controller на устройствах iOS 9.x считается родным браузером для целей этого поля. |
secure | Целое число | Если для этого впечатления требуется безопасный HTTPS-URL или небезопасный HTTP-URL.0 (по умолчанию): небезопасно1 : безопасный |
iframebuster | Массив строк | |
exp | Целое число | Срок действия ставки устанавливается DV 360 без учёта значения, отправленного партнёром в этом поле. События показов, полученные после истечения периода ожидания показов (обычно 1 час), отбрасываются как просроченные и не подлежат оплате DV 360. |
rwdd | Целое число | Указывает, получает ли пользователь вознаграждение за просмотр рекламы.0 (по умолчанию): не вознаграждается1 : НагражденКак правило, видеореклама позволяет пользователям бесплатно прочитать дополнительную новостную статью, получить дополнительную жизнь в игре или получить спонсируемый музыкальный сеанс без рекламы. Вознаграждение обычно выплачивается после завершения просмотра видеорекламы. |
Объект расширения Imp
Поле | Тип | Подробности |
---|---|---|
bcrid | Нить | Список идентификаторов креативов, которые следует заблокировать. |
Объект баннера
Поле | Тип | Подробности |
---|---|---|
format | Форматировать массив | Список поддерживаемых форматов. |
w | Целое число | format . |
h | Целое число | format . |
wmax | Целое число | Не поддерживается. |
hmax | Целое число | Не поддерживается. |
wmin | Целое число | Не поддерживается. |
hmin | Целое число | Не поддерживается. |
btype | Целочисленный массив | Список заблокированных типов баннерной рекламы: |
battr | Целочисленный массив | Поддерживаются следующие значения: |
pos | Целое число | Позиция объявления: |
mimes | Массив строк | Не поддерживается. DV360 будет использовать text/html для всех баннерных креативов. |
topframe | Целое число | 0 (по умолчанию): Баннер доставляется в iframe.1 : Не поддерживается: баннер доставляется в верхнюю рамку. |
expdir | Целочисленный массив | 1 : Левый2 : Право3 : Вверх4 : Вниз5 : Расширяемый полноэкранный режим |
api | Целочисленный массив | Поддерживаемые API-фреймворки |
id | Нить | Идентификатор объекта баннера, который должен быть уникальным в показе. Рекомендуется при использовании объектов |
vcm | Целое число | Актуально только для 0 : Баннер отображается одновременно с видеообъявлением.1 : Баннер является конечной заставкой после видео. |
Формат объекта
Поле | Тип | Подробности |
---|---|---|
w | Целое число | Ширина в аппаратно-независимых пикселях (DIPS). |
h | Целое число | Высота в аппаратно-независимых пикселях (DIPS). |
wratio | Целое число | Не поддерживается. |
hratio | Целое число | Не поддерживается. |
wmin | Целое число | Не поддерживается. |
Видео объект
Мы настоятельно рекомендуем указывать место размещения в видео в запросе ставки. Отсутствие поля места размещения классифицируется как неизвестное место размещения. Подробнее см. в статье о таргетинге на позиции .
Поле | Тип | Подробности |
---|---|---|
mimes | Массив строк | Требуется по крайней мере один тип MIME. |
minduration | Целое число | Минимальная продолжительность видео в секундах, по умолчанию минимум отсутствует. |
maxduration | Целое число | Максимальная продолжительность видео в секундах, по умолчанию максимум отсутствует. |
protocols | Целочисленный массив | Требуется хотя бы один поддерживаемый протокол. |
w | Целое число | Ширина видеоплеера в аппаратно-независимых пикселях (DIPS). |
h | Целое число | Высота видеоплеера в аппаратно-независимых пикселях (DIPS). |
startdelay | Целое число | Задержка запуска в секундах для размещения рекламы в начале, в середине или в конце ролика. |
placement | Целое число | Настоятельно рекомендуется указать plcmt (и/или) место размещения видео в запросе ставки. Отсутствие обоих полей будет классифицировано как неизвестное место размещения. |
plcmt | Целое число | Настоятельно рекомендуется указать plcmt (и/или) место размещения видео в запросе ставки. Отсутствие обоих полей будет классифицировано как неизвестное место размещения. Примечание: Чтобы считаться In-Stream (Placement или Plcmt Type 1), для размещения/показа видео необходимо установить «звук включен» и правильно указать метод воспроизведения (подходят значения 1, 3, 4 и 5). Примечание: Если указаны оба параметра: plcmt: Accompanying Content (2) считается placement: In Article (3) plcmt: No Content/Standalone (4) считается placement: In feed (4) placement: In Banner нет сопоставления в plcmt |
linearity | Целое число | Не поддерживается. |
skip | Целое число | Если видеоплеер позволит пропустить рекламу. |
skipmin | Целое число | Не поддерживается. |
skipafter | Целое число | Не поддерживается. |
sequence | Целое число | Если в одном запросе ставки предлагается несколько показов рекламы, порядковый номер позволит скоординировать показ нескольких креативов. |
battr | Целочисленный массив | Заблокированные креативные атрибуты. |
maxextended | Целое число | Максимальная продолжительность расширенной видеорекламы, если продление разрешено. |
minbitrate | Целое число | Минимальная скорость передачи данных в Кбит/с. |
maxbitrate | Целое число | Максимальная скорость передачи данных в Кбит/с. |
boxingallowed | Целое число | Указывает, разрешено ли наложение содержимого формата 4:3 в окно формата 16:9 |
playbackmethod | Целочисленный массив | Методы воспроизведения, которые могут использоваться. Если ни один из них не указан, можно использовать любой метод. |
playbackend | Целое число | Событие, приводящее к завершению воспроизведения. |
delivery | Целочисленный массив | Поддерживаемые способы доставки. Если не указано ни одного, предполагается, что поддерживаются все. |
pos | Целое число | Положение рекламы на экране. |
companionad | Массив баннеров | Сопутствующие рекламные объявления, если таковые имеются. |
api | Целочисленный массив | |
companiontype | Целочисленный массив | Не поддерживается. |
maxseq | Целое число | Максимальное количество объявлений, которые могут быть возвращены в динамическом видеомодуле. |
poddur | Целочисленный массив | Максимальная длина динамического видеомодуля в секундах. |
Поддерживаемое расширение для видеообъекта
Поле | Тип | Подробности |
---|---|---|
rewarded | Целое число | Это поле указывает, были ли запросы вознаграждены или нет. Должна быть отправлена целым числом. |
Аудио объект
Поле | Тип | Подробности |
---|---|---|
mimes | Массив строк | Требуется по крайней мере один тип MIME. |
minduration | Целое число | Минимальная продолжительность рекламы в секундах. |
maxduration | Целое число | Максимальная продолжительность рекламы в секундах. |
protocols | Целочисленный массив | |
startdelay | Целое число | Задержка начала показа рекламы в начале, в середине или в конце ролика (в секундах). |
sequence | Целое число | Не поддерживается. |
battr | Целочисленный массив | Не поддерживается. |
maxextended | Целое число | Не поддерживается. |
minbitrate | Целое число | Минимальная скорость передачи данных в Кбит/с. |
maxbitrate | Целое число | Максимальная скорость передачи данных в Кбит/с. |
delivery | Целочисленный массив | Не поддерживается. |
companionad | Массив объектов баннера | Любые креативные слоты для сопутствующих баннеров. |
api | Целочисленный массив | Список поддерживаемых API-фреймворков для этого впечатления. |
companiontype | Целочисленный массив | Не поддерживается. |
maxseq | Целочисленный массив | Не поддерживается. |
feed | Целое число | Тип аудиопотока. |
stitched | Целое число | Не поддерживается. |
nvol | Целое число | Не поддерживается. |
Родной объект
Более подробную информацию см. в спецификациях нативной рекламы DV360 .
Поле | Тип | Подробности |
---|---|---|
request | Нить | Строка закодирована в собственном json-объекте. |
ver | Нить | 1.0 : Не поддерживается1.1 : Не поддерживается1.2 |
api | Целочисленный массив | Список поддерживаемых API-фреймворков для этого впечатления. |
battr | Целочисленный массив | Не поддерживается. |
PMP-объект
Поле | Тип | Подробности |
---|---|---|
private_auction | Целое число | 0 (по умолчанию): разрешены все ставки1 : Только предложения |
deals | Массив объектов сделки | Сделки, которые следует включить. |
Объект сделки
Поле | Тип | Подробности |
---|---|---|
id | Нить | Объект PMP не может содержать более одного объекта сделки на один идентификатор. |
bidfloor | Двойной | Минимальная ставка за этот показ в CPM. Обязательно, если |
bidfloorcur | Нить | Валюта указана с использованием буквенных кодов ISO-4217. Если не указано иное, по умолчанию используется валюта запроса ставки. |
at | Целое число | Если не указано иное, по умолчанию соответствует bid_request.at . |
wseat | Массив строк | Идентификаторы партнеров, имеющих право на сделку. Отсутствие мест не подразумевает ограничений по количеству мест. |
wadomain | Массив строк | Домены рекламодателей, допущенные к участию в этой сделке. Отсутствие мест не подразумевает ограничений по домену. |
guar | Целое число | Это поле указывает, является ли сделка гарантированной. Должна быть отправлена целым числом. Для принятия гарантированных сделок биржа должна быть разрешена DV360; обратитесь к нам , чтобы запросить эту информацию. Если ваша биржа в настоящее время использует другой механизм для сигнализации о гарантированных сделках с DV360, свяжитесь с нами , чтобы обсудить переход на это предпочтительное расширение. |
ext | Расширения сделок | Необязательный. |
Поддерживаемое расширение для объекта сделки
Поле | Тип | Подробности |
---|---|---|
guaranteed | Целое число | Это поле указывает, является ли сделка гарантированной. Должна быть отправлена целым числом. Для принятия гарантированных сделок биржа должна быть разрешена DV360; обратитесь к нам , чтобы запросить эту информацию. Если ваша биржа в настоящее время использует другой механизм для сигнализации о гарантированных сделках с DV360, свяжитесь с нами , чтобы обсудить переход на это предпочтительное расширение. Вместо этого поля рекомендуется использовать |
Объект сайта
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор сайта на бирже. |
name | Нить | Не поддерживается. |
domain | Нить | Домен сайта. Рекомендуется отправлять полный URL-адрес в site.page, а не только заполнять site.domain. |
cat | Массив строк | Не поддерживается. |
sectioncat | Массив строк | Не поддерживается. |
pagecat | Массив строк | Не поддерживается. |
page | Нить | Полный URL-адрес, по которому будет показан оттиск. Для таргетинга рекомендуется отправлять полный URL-адрес. |
ref | Нить | URL-адрес реферера, который привел к переходу на текущую страницу. |
search | Нить | Не поддерживается. |
mobile | Целое число | Не поддерживается. |
privacypolicy | Целое число | Не поддерживается. |
publisher | Объект издателя | Подробная информация об издателе сайта. |
content | Объект контента | Подробная информация о содержании сайта. |
keywords | Строка (формат CSV) | Не поддерживается. |
ext | Расширения сайта | Расширения для объекта сайта. |
Объект расширения сайта
Поле | Тип | Подробности |
---|---|---|
inventorypartnerdomain | Нить | Используется для совместного использования инвентаря CTV, см. пояснительные материалы к приложению IAB CTV . |
Объект приложения
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор приложения на бирже. |
name | Нить | Названия приложений, которые могут быть изменены по запросу издателей. Названия приложений для запросов без SDK (в основном подключенные телевизоры) могут быть предоставлены издателем непосредственно в запросе. |
bundle | Нить | Необходимый. Для iOS это должен быть числовой идентификатор магазина приложений. Мы не принимаем идентификаторы пакетов в стиле обратного DNS. Для приложений CTV мы рекомендуем передавать идентификатор приложения, заданный магазином. Пожалуйста, следуйте недавно опубликованным рекомендациям IAB по назначению идентификатора магазина OTT/CTV . |
domain | Нить | Домен, например mygame.foo.com |
storeurl | Нить | Требуется для проверки app-ads.txt и проверки магазина приложений Connected TV. |
cat | Массив строк | Не поддерживается. |
sectioncat | Массив строк | Не поддерживается. |
pagecat | Массив строк | Не поддерживается. |
ver | Нить | Не поддерживается. |
privacypolicy | Целое число | Не поддерживается. |
paid | Целое число | Не поддерживается. |
publisher | Объект издателя | Информация об издателе приложения. |
content | Объект контента | Информация о содержании приложения. |
keywords | Строка (формат CSV) | Не поддерживается. |
ext | Расширения приложений | Расширения для объекта приложения. |
Объект расширения приложения
Поле | Тип | Подробности |
---|---|---|
inventorypartnerdomain | Нить | Используется для совместного использования инвентаря CTV, см. пояснительные материалы к приложению IAB CTV . |
Объект контента
Мы рекомендуем передавать эти атрибуты, если они доступны.
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор, однозначно определяющий содержимое. |
episode | Целое число | Номер эпизода контента (обычно для видеоконтента). |
title | Нить | Рекомендуется для запросов на CTV, видео и аудио. |
series | Нить | Рекомендуется для запросов на CTV, видео и аудио. |
season | Нить | Метка сезона контента. |
artist | Нить | Авторство контента принадлежит художнику. |
genre | Нить | Жанр, который лучше всего описывает контент. DV360 рекомендует предоставлять этот сигнал для запросов на CTV, видео и аудио. DV360 поддерживает несколько таксономий значений жанра видео для этого поля: |
album | Нить | Альбом, к которому принадлежит контент (обычно для аудио). |
isrc | Нить | Международный стандартный код записи, соответствующий ISO-3901. |
producer | Объект-производитель | Подробная информация о производителе контента. |
url | Нить | URL-адрес контента. |
cat | Массив строк | Категории контента IAB, описывающие контент. |
prodq | Целое число | Качество продукции: |
videoquality | Целое число | Не поддерживается. |
context | Целое число | Тип контента: |
contentrating | Нить | Рекомендуется для аудио и видео/CTV, поскольку мы начнем принимать решения по этому атрибуту. |
userrating | Нить | Количество звезд, лайков и т. д. |
qagmediarating | Целое число | Рейтинг СМИ согласно [руководству QAG](http://www.iab.net/ne_guidelines). |
keywords | Строка (формат CSV) | Не поддерживается. |
livestream | Целое число | Если контент представляет собой прямую трансляцию. |
sourcerelationship | Целое число | |
len | Целое число | Длина контента в секундах. Рекомендуется для запросов на CTV/видео и аудио. |
language | Строка (ISO-639-1-альфа-2) | Язык содержания. |
embeddable | Целое число | Индикатор того, является ли контент встраиваемым (например, встраиваемый видеоплеер) |
data | Массив объектов данных | Дополнительные данные. |
Объект-производитель
Поле | Тип | Подробности |
---|---|---|
id | Нить | Не поддерживается. |
name | Нить | Не поддерживается. |
cat | Массив строк | Не поддерживается. |
domain | Нить | Домен высшего уровня производителя. |
Объект данных
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор поставщика данных. |
name | Нить | Имя биржи для поставщика данных. |
segment | Массив объектов Segment | Фактические значения данных. |
ext | Расширения данных | Расширения для объекта Data. |
Поддерживаемые расширения для объекта данных
Поле | Тип | Подробности |
---|---|---|
segtax | Целое число | Идентификатор таксономии, более подробную информацию см. в разделе Таксономии сегментов . |
segclass | Нить | Версия классификатора, которая создала идентификаторы сегментов в таксономии. |
Сегмент объекта
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор сегмента данных, специфичный для поставщика данных. |
name | Нить | Имя сегмента данных. |
value | Нить | Ценность сегмента данных. |
Объект издателя
Поле | Тип | Подробности |
---|---|---|
id | Нить | Необходимый. |
name | Нить | Не поддерживается. |
cat | Массив строк | Не поддерживается. |
domain | Нить | Не поддерживается. |
Объект устройства
Поле | Тип | Подробности |
---|---|---|
ua | Нить | Необходимый. |
sua | объект UserAgent | Структурированная информация о пользовательском агенте. |
geo | Геообъект | Местоположение устройства. |
dnt | Целое число | Флаг «Не отслеживать», установленный в заголовке браузера. |
lmt | Целое число | Сигнал Limit Ad Tracking одобрен коммерчески. |
ip | Нить | Требуется, если IPv4. Если IP-адрес усечен, его необходимо объявить в |
ipv6 | Нить | Требуется, если IPv6. Если IP-адрес усечен, его необходимо объявить в |
devicetype | Целое число | Настоятельно рекомендуется для всех типов инвентаря. Используется для улучшения распознавания типов устройств. |
make | Нить | |
model | Нить | |
os | Нить | Операционная система устройства. Это поле нечувствительно к регистру. |
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 запроса ставки. По умолчанию не усекается и требуется, если IP-адрес усекается. Если запрос на ставку не объявлен, он может быть классифицирован как недействительный трафик. |
ifa_type | Нить | Укажите происхождение поля device.ifa: было ли оно предоставлено самим устройством или сгенерировано издателем или SSP в цепочке поставок. |
attestation_token | Строка (кодировка base64) | Токен подтверждения подлинности на основе устройства для бирж, поддерживающих этот уровень проверки устройства. |
atts | Целое число | (Только для iOS) Целое число, передаваемое для представления статуса авторизации отслеживания приложения. |
cdep | Нить | Метка прекращения использования сторонних файлов cookie в Chrome. См. тестирование с помощью Chrome и спецификацию сообщества IAB. |
объект UserAgent
Поле | Тип | Подробности |
---|---|---|
browsers | Массив объектов BrandVersion | Каждый объект BrandVersion идентифицирует браузер или аналогичный программный компонент. |
platform | Объект BrandVersion | Идентифицирует платформу. |
mobile | Целое число | 0 (по умолчанию): Агент предпочитает «настольный» или «полный» контент.1 : Агент предпочитает «мобильный» контент. |
architecture | Нить | Архитектура устройства, например, «x86» или «arm». |
bitness | Нить | Разрядность устройства, например, «64» для 64-битной архитектуры. |
model | Нить | Модель устройства. |
source | Целое число | Источник данных, использованных для создания этого объекта, см. в списке: Источник User-Agent . Рекомендуется при передаче объекта UserAgent . |
Объект BrandVersion
Поле | Тип | Подробности |
---|---|---|
brand | Нить | Идентификатор бренда, например, «Chrome» или «Windows». Обязательно. |
version | Массив строк | Последовательность компонентов версии в нисходящем иерархическом порядке (основная, второстепенная, микро и т. д.). |
Геообъект
Поле | Тип | Подробности |
---|---|---|
lat | Двойной | Не поддерживается. |
lon | Двойной | Не поддерживается. |
type | Целое число | Не поддерживается. |
accuracy | Целое число | Не поддерживается. |
lastfix | Целое число | Не поддерживается. |
ipservice | Целое число | Не поддерживается. |
country | Нить | Не поддерживается. |
region | Нить | Не поддерживается. |
regionfips104 | Нить | Не поддерживается. |
metro | Нить | Не поддерживается. |
city | Нить | Не поддерживается. |
zip | Нить | Не поддерживается. |
utcoffset | Целое число | Не поддерживается. |
Пользовательский объект
Поле | Тип | Подробности |
---|---|---|
id | Нить | Поддерживается, если Google размещает таблицу соответствий идентификаторов. |
buyeruid | Нить | Поддерживается, если SSP размещает таблицу соответствий идентификаторов. |
yob | Целое число | Рекомендуется для демографического таргетинга. |
gender | Нить | Рекомендуется для демографического таргетинга. |
keywords | Строка (CSV) | Не поддерживается. |
customdata | Нить | Не поддерживается. |
geo | Геообъект | Не поддерживается. |
data | Массив объектов данных | Дополнительные данные. |
eids | Массив объектов расширенного идентификатора | Расширенные экземпляры идентификаторов, предоставляемые биржей. |
ext | Пользовательские расширения | Расширения для объекта пользователя. |
Поддерживаемые расширения для объекта пользователя
Поле | Тип | Подробности |
---|---|---|
consent | Строка (веб-безопасная base64) | Строка согласия IAB. Содержит метаданные о том, на сбор какой информации пользователь дал согласие и каким поставщикам разрешено использовать эту информацию. Значение представляет собой веб-безопасную двоичную строку, закодированную в формате base64 с использованием пользовательского двоичного формата . |
us_privacy | Нить | Если пользователь увидел соответствие CCPA или аналогичным законам. |
consented_providers_settings . consented_providers | Внешний объект (consented_providers_settings), оборачивающий внутренний массив Integer (consented_providers). | Если согласие GDPR собирается через TCF, в этом поле перечисляются поставщики рекламных технологий, получившие согласие пользователя и не участвующие в TCF. См. « Техническую спецификацию дополнительного согласия Google ». |
eids | Массив объектов расширенного идентификатора | Расширенные экземпляры идентификаторов, предоставляемые биржей. |
Расширенный идентификатор объекта
Поле | Тип | Подробности |
---|---|---|
source | Нить | Поставщик идентификатора |
uids | Массив объектов UID с расширенным идентификатором | Фактические идентификаторы |
Расширенный идентификатор объекта UID
Поле | Тип | Подробности |
---|---|---|
id | Нить | Сам идентификатор. |
atype | Целое число | Тип пользовательского агента, связанного с этим идентификатором. |
Объект цепочки поставок
Поле | Тип | Подробности |
---|---|---|
complete | Целое число | 0 (по умолчанию): Цепочка поставок неполная.1 : Цепочка поставок завершена и возвращается к издателю. |
ver | Нить | Необходимый. Значение имеет формат «major.minor», например, версия 1.0 — это строка «1.0». |
nodes | Массив узлов цепочки поставок | Необходимый. В полной цепочке поставок первый узел представляет собой исходную рекламную систему и идентификатор продавца, участвующего в транзакции, т. е. владельца сайта, приложения или другого носителя. В неполной цепочке поставок это первый известный узел. Последний узел представляет собой субъекта, отправившего этот запрос. |
Объект узла цепочки поставок
Поле | Тип | Подробности |
---|---|---|
asi | Нить | Каноническое доменное имя системы SSP, Exchange, Header Wrapper и т. д., к которой подключаются участники торгов. Это может быть рабочий домен системы, если он отличается от родительского корпоративного домена, для упрощения поиска в WHOIS и обратного поиска по IP-адресу для установления точного владельца делегированной системы. Это должно быть то же значение, которое используется для идентификации продавцов в файле ads.txt, если он существует. |
sid | Нить | Идентификатор, связанный с аккаунтом продавца или реселлера в рекламной системе. Он должен содержать то же значение, что и в транзакциях (например, в запросах ставок OpenRTB) в поле, указанном SSP/биржей. В OpenRTB это обычно publisher.id. В OpenDirect это, как правило, идентификатор организации издателя. Длина пароля должна быть ограничена 64 символами. |
rid | Нить | OpenRTB RequestId запроса, отправленного этим продавцом. |
name | Нить | Название компании (юридического лица), которая получает оплату за инвентарь, проданный по указанному seller_id. Это значение является необязательным и НЕ должно быть включено, если оно существует в файле sellers.json рекламной системы. |
domain | Нить | Доменное имя компании, представленной этим узлом. Это значение является необязательным и НЕ должно быть включено, если оно существует в файле sellers.json рекламной системы. |
hp | Целое число | Указывает, будет ли этот узел участвовать в потоке платежей за инвентарь. Для версии 1.0 SupplyChain это свойство всегда должно быть равно 1. Его явно требуется включить, поскольку ожидается, что в будущих версиях спецификации будут введены узлы обработки неплатежей. Разработчики должны убедиться, что они поддерживают это поле и распространяют его далее при построении объектов SupplyChain в запросах ставок, отправляемых в нижестоящую рекламную систему. |
Спецификация ответа на заявку
Объект BidResponse
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
идентификатор | Если произошла ошибка синтаксического анализа, вместо идентификатора запроса ставки может быть «0». | Да | |
ставка на место | |||
бидид | |||
дворняжка | В случае ошибки анализа этот параметр не передаётся. Для корректного запроса ставки всегда предоставляется текущий трафик. | Да | |
пользовательские данные | |||
nbr | Этот параметр включается только в случае обнаружения проблемы с запросом ставки. Возможные значения:2 : Неверный запрос12 : Нарушение авторизации Ads.txt16 : Неполная цепочка поставок17 : Заблокированный узел цепочки поставокПримечание: при обнаружении конкретного нарушения (app-)ads.txt или SupplyChain для части (1%) ответов будет указан один из кодов 12, 16 или 17. Для всех остальных недействительных запросов будет указан код 2. Запросы, включающие NBR, будут выглядеть примерно так: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } | ||
доб. | Если возникла проблема с запросом на ставку, в расширении может содержаться информация, помогающая диагностировать ошибку (там, где это поддерживается). |
Поддерживаемые расширения для объекта BidResponse
Атрибут | Подробности реализации |
---|---|
ошибаться | Удобочитаемое описание ошибки в запросе ставки. Возможные варианты ответа:
|
errHelp | Ссылка на эту страницу. |
Объект Seatbid
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
делать ставку | да | ||
сиденье | да | ||
группа |
Объект ставки
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
идентификатор | да | ||
неприятный | да | ||
цена | да | ||
нурл | |||
кап | |||
лурл | |||
адм | |||
адид | |||
домен | |||
пучок | |||
iurl | |||
сид | да | ||
крид | да | ||
тактика | |||
кот | |||
атрибут | |||
API | |||
протокол | |||
qagmediarating | |||
язык | |||
делид | |||
в | |||
час | |||
соотношение | |||
соотношение сторон | |||
опыт |
Поддерживаемые расширения для объекта ставки
Атрибут | Подробности реализации |
---|---|
apis | DV360 отправит seatbid.bid.apis , если поддерживаются и OMID, и MRAID. DV360 установит и OMID_1, и MRAID как целочисленный массив. |
Варианты показа рекламы
В разделе 4.3 спецификации OpenRTB указаны два различных варианта обслуживания:
- Наценка, указанная в уведомлении о выигрыше
- Наценка, указанная в заявке
DV360 поддерживает оба варианта.
- Для баннерной рекламы DV360 всегда возвращает разметку в поле
adm
. Разметка, указанная в уведомлении о выигрыше, необязательна. - Для видео/аудиорекламы с использованием протокола VAST DV360 поддерживает возврат VAST XML в поле
adm
или в ответе уведомления о выигрыше на основе требований партнеров по обмену.
Обратитесь к спецификации OpenRTB, чтобы узнать плюсы и минусы этих двух вариантов.
Лучшие практики
Настоятельно рекомендуется использовать в качестве идентификатора места партнерский идентификатор Display and Video 360. Использование идентификатора места, специфичного для биржи, не рекомендуется.
Убедитесь, что у ваших издателей есть файлы ads.txt или приложения со связанными файлами app-ads.txt, и что вы указаны в этом файле как авторизованный продавец или реселлер. Подробнее .
Также убедитесь, что в запросах ставок передается согласованная информация. Например, app.bundle
должен соответствовать информации о мобильном устройстве и app.storeurl
.
Подключенное телевидение
Соблюдайте рекомендации IAB OTT IFA при передаче device.ifa
и device.lmt
. Также необходимо реализовать device.ext.ifa_type
для соответствия этим рекомендациям. Для всех наших возможностей ограничения частоты показов и таргетинга аудитории на CTV требуется наличие IFA.
Также придерживайтесь недавно опубликованных рекомендаций IAB OTT/CTV Store Assigned ID — они определяют, как app.bundle
должен передаваться для приложений CTV — в основном с использованием идентификатора, определенного в магазине приложений.
Измерение Active View
Active View – это технология Google, используемая для определения того, был ли показ видимым и в течение какого времени. Active View использует OMID как для медийной, так и для видеорекламы. Чтобы включить измерение с использованием OMID, биржи должны добавить следующие поля в запросы OpenRTB, чтобы DV360 знал о поддержке OMID клиентом.
- Обязательно: добавьте API Framework (
Video.api=7
дляOMSDK
) в запросы ставок. Это обязательно для Active View, чтобы включить измерение с помощью OMID. - Рекомендуется. Настоятельно рекомендуется добавить
omidpn
иomidpv
вSource.Ext
, поскольку это повлияет на то, как данные о видимости будут сообщаться клиенту в DV360. Если имя партнера OMID отсутствует в списке сертификации IAB , MRC требует от нас сообщать показатели видимости отдельно от показателей, сертифицированных MRC. Узнайте больше .
Часто задаваемые вопросы
- Осуществляет ли поддержка DV360 обмен пользовательскими расширениями?
- Да, в дополнение к расширениям, перечисленным в этой спецификации, Display and Video 360 также может поддерживать пользовательские расширения в каждом конкретном случае. Рекомендуется указать и протестировать пользовательское расширение в период интеграции.
- Поддерживает ли DV360 видео с вознаграждением?
- Да, отправьте нам вознагражденное расширение видео .
- Большая часть моего инвентаря отображается как «Неизвестная демографическая информация». Как мне улучшить демографический охват?
- Укажите
user.yob
иuser.gender
в запросах ставок на DV360, чтобы увеличить охват. - Есть ли у DV360 конечные точки для каждого региона?
- Нет, мы используем единую конечную точку во всем мире и автоматически маршрутизируем запросы в ближайший центр обработки данных, поэтому мы не можем предоставить конечную точку для конкретного региона.
- Каковы требования к запросам между серверами (s2s)?
- Свяжитесь с нами , чтобы запросить добавление в наш белый список. Пользовательский агент клиента необходимо перенаправить и убедиться, что файлы cookie отключены/игнорируются в ответ на выборку VAST s2s.
- Поддерживает ли DV360 OMID?
- Мы можем измерить видимость с помощью OMID, если во время запроса ставки он объявлен как поддерживающий OMID. Подробности об этом изложены на страницах 24-25 .
- Какую версию Native вы поддерживаете? Есть ли у вас какие-либо требования к Native?
- Мы поддерживаем только Native Ver1.2. Родная спецификация .
- Поддерживает ли DV360 запросы ставок, отправляемые в формате GZIP?
- DV360 может получать запросы ставок, сжатые gzip, и будет отвечать ответами, сжатыми gzip, если заголовок Accept-Encoding указывает, что это поддерживается.
- Поддерживает ли DV360 DBURL?
- На данный момент нет.
- Поддерживает ли DV360 уведомление о выигрыше и проигрыше?
- Не сейчас. Если вы считаете, что нам было бы полезно поддержать его, сообщите нам более подробную информацию.
- Требуется ли для DV360 App.name для таргетинга?
- Нет, DV360 использует App.name для справки, но это не обязательно для таргетинга. Для таргетинга используется
App.bundle
. - Может ли DV360 поддерживать несколько размеров объявлений, отправленных в одном запросе ставки?
- Да, мы рассмотрим все подходящие размеры объявлений в формате Banner.format.
- Поддерживает ли DV360 несколько форматов в одном запросе ставки?
- У нас ограниченная поддержка многоформатных запросов ставок, но мы работаем над ее улучшением. Мы поддерживаем форматы медийной и видеорекламы для межстраничных объявлений, но в настоящее время не поддерживаем медийную и нативную рекламу. Если вы отправляете многоформатные запросы ставок, свяжитесь с нами и запросите тестирование.
- Поддерживает ли DV360 смешанные типы показов в одном запросе?
- В настоящее время мы поддерживаем только межстраничные видео и баннеры. Мы работаем над нативным/баннером и видео/баннером. Если есть другие комбинации, свяжитесь с нашей командой.
- Могут ли несколько мест отправлять несколько ставок на одну или несколько таких возможностей показа в одном запросе?
- Да.
- Есть ли у DV360 решение или особая потребность в ограничении или показе одного и того же рекламодателя для нескольких таких возможностей показа в одном запросе?
- DV360 устанавливает требование, согласно которому один рекламодатель может предлагать только одну ставку для каждого запроса. Мы ожидаем, что SSP будут осмысленно группировать объекты-импы; например, все на одной странице, все в одном приложении и т. д.
- Поддерживает ли DV360 несколько показов в одном запросе ставки?
- DV360 в настоящее время поддерживает несколько аудиообъектов показа. Однако нам нужно будет протестировать/включить каждую биржу, которая захочет использовать эту функцию. Дополнительную информацию см. в спецификации запроса ставок . Мы работаем над распространением этого на другие форматы:
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
Связаться с нами
Если у вас есть какие-либо вопросы или проблемы, обратитесь в нашу службу поддержки обмена.