При просмотре этой страницы имейте под рукой спецификацию 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 полей в Source . |
Объект Regs
Поле | Тип | Подробности |
---|---|---|
coppa | Целое число | 0 (по умолчанию): COPPA не применим к этому запросу.1 : Этот запрос соответствует требованиям COPPA. |
ext | Расширения Регламентов | Необязательный. |
Объект расширения Regs
Поле | Тип | Подробности |
---|---|---|
gdpr | Целое число | Укажите, относится ли запрос на ставку к региону ЕЭЗ.0 (по умолчанию): регион, не входящий в ЕЭЗ.1 : регион ЕЭЗ,Более подробную информацию см. в разделе «Решение поставщика согласия для GDPR» . |
us_privacy | Нить | Для реализации строки us_privacy следуйте технической спецификации, предоставленной IAB Tech Lab. Когда мы получаем строку |
Объект Имп
Поле | Тип | Подробности |
---|---|---|
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 час), отбрасываются как устаревшие и не считаются подлежащими оплате DV360. |
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 Store Assigned ID . |
domain | Нить | Домен, например mygame.foo.com |
storeurl | Нить | Требуется для проверки app-ads.txt и проверки магазина приложений Connected TV. |
cat | Массив строк | Не поддерживается. |
sectioncat | Массив строк | Не поддерживается. |
pagecat | Массив строк | Не поддерживается. |
ver | Нить | Не поддерживается. |
privacypolicy | Целое число | Не поддерживается. |
paid | Целое число | Не поддерживается. |
publisher | Объект издателя | Информация об издателе приложения. |
content | Объект контента | Информация о содержании приложения. |
keywords | Строка (формат CSV) | Не поддерживается. |
ext | Расширения приложений | Расширения для объекта приложения. |
Объект расширения приложения
Поле | Тип | Подробности |
---|---|---|
inventorypartnerdomain | Нить | Используется для обмена инвентарем CTV, см. пояснение к приложению IAB CTV . |
Объект контента
Мы рекомендуем передавать эти атрибуты, если они доступны.
Поле | Тип | Подробности |
---|---|---|
id | Нить | Идентификатор, однозначно определяющий содержимое. |
episode | Целое число | Номер эпизода контента (обычно для видеоконтента). |
title | Нить | Рекомендуется для запросов на CTV, видео и аудио. |
series | Нить | Рекомендуется для запросов на CTV, видео и аудио. |
season | Нить | Метка сезона контента. |
artist | Нить | Автором контента указан художник. |
genre | Нить | Жанр, который лучше всего описывает контент. DV360 рекомендует предоставлять этот сигнал для запросов CTV, видео и аудио. DV360 поддерживает несколько таксономий значений жанра видео для этого поля: |
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 | Фактические значения данных. |
Сегмент объекта
Поле | Тип | Подробности |
---|---|---|
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: было ли оно предоставлено самим устройством или сгенерировано издателем или поставщиком общих служб в цепочке поставок. |
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 | Массив объектов Extended ID | Расширенные экземпляры идентификаторов, предоставляемые биржей. |
ext | Пользовательские расширения | Расширения для объекта пользователя. |
Поддерживаемые расширения для объекта пользователя
Поле | Тип | Подробности |
---|---|---|
consent | Строка (веб-безопасный base64) | Строка согласия IAB. Содержит метаданные о том, на сбор какой информации пользователь дал согласие и каким поставщикам разрешено использовать эту информацию. Значение представляет собой двоичную строку, закодированную в кодировке base64 и использующую пользовательский двоичный формат . |
us_privacy | Нить | Если пользователь увидел соответствие CCPA или аналогичным законам. |
consented_providers_settings . consented_providers | Внешний объект (consented_providers_settings), оборачивающий внутренний массив целых чисел (consented_providers). | Передайте поставщикам согласие на запрос GDPR. Подробнее см. Consented Provider Solution для GDPR . |
eids | Массив объектов Extended ID | Расширенные экземпляры идентификаторов, предоставляемые биржей. |
Расширенный идентификатор объекта
Поле | Тип | Подробности |
---|---|---|
source | Нить | Поставщик идентификатора |
uids | Массив расширенных идентификаторов UID-объектов | Фактические идентификаторы |
Расширенный идентификатор UID объекта
Поле | Тип | Подробности |
---|---|---|
id | Нить | Сам идентификатор. |
atype | Целое число | Тип пользовательского агента, связанного с этим идентификатором. |
Объект цепочки поставок
Поле | Тип | Подробности |
---|---|---|
complete | Целое число | 0 (по умолчанию): Цепочка поставок неполная.1 : Цепочка поставок завершена и возвращается к издателю. |
ver | Нить | Необходимый. Значение форматируется как «major.minor», например, версия 1.0 — это строка «1.0». |
nodes | Массив узлов цепочки поставок | Необходимый. В полной цепочке поставок первый узел представляет собой начальную рекламную систему и идентификатор продавца, участвующего в транзакции, т. е. владельца сайта, приложения или другого носителя. В неполной цепочке поставок он представляет собой первый известный узел. Последний узел представляет собой сущность, отправляющую этот запрос на ставку. |
Объект узла цепочки поставок
Поле | Тип | Подробности |
---|---|---|
asi | Нить | Каноническое доменное имя системы SSP, Exchange, Header Wrapper и т. д., к которой подключаются участники торгов. Это может быть операционный домен системы, если он отличается от родительского корпоративного домена, для упрощения поиска WHOIS и обратного IP-адреса с целью установления четкого права собственности на систему делегирования. Это должно быть то же значение, которое используется для идентификации продавцов в файле ads.txt, если таковой существует. |
sid | Нить | Идентификатор, связанный с учетной записью продавца или реселлера в рекламной системе. Он должен содержать то же значение, которое используется в транзакциях (т. е. запросы ставок OpenRTB) в поле, указанном SSP/биржей. Обычно в OpenRTB это publisher.id. Для OpenDirect это обычно идентификатор организации издателя. Длина пароля не должна превышать 64 символа. |
rid | Нить | OpenRTB RequestId запроса, отправленного этим продавцом. |
name | Нить | Наименование компании (юридического лица), которая оплачивает инвентарь, проданный под указанным seller_id. Это значение является необязательным и НЕ должно быть включено, если оно существует в файле sellers.json рекламной системы. |
domain | Нить | Доменное имя компании, представленной этим узлом. Это значение является необязательным и НЕ должно быть включено, если оно существует в файле sellers.json рекламной системы. |
hp | Целое число | Указывает, будет ли этот узел участвовать в потоке платежей за инвентарь. Для версии SupplyChain 1.0 это свойство всегда должно быть равно 1. Его явно необходимо включить, поскольку ожидается, что в будущих версиях спецификации будут введены узлы обработки неплатежей. Разработчики должны убедиться, что они поддерживают это поле и распространяют его далее при построении объектов SupplyChain в запросах ставок, отправляемых в нижестоящую рекламную систему. |
Спецификация ответа на заявку
Объект BidResponse
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
идентификатор | Если произошла ошибка синтаксического анализа, вместо идентификатора запроса ставки может быть «0». | Да | |
местобид | |||
bidid | |||
дворняжка | Если происходит ошибка разбора, это не передается. Для действительного запроса ставки всегда предоставляется трафик cur. | Да | |
пользовательские данные | |||
количество | Это включается только в том случае, если была обнаружена проблема с запросом ставки, и всегда будет 2 , Недопустимый запрос, согласно спецификации OpenRTB.Запросы, включающие NBR, будут выглядеть примерно так: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } | ||
доб. | Если возникла проблема с запросом на ставку, расширение может содержать информацию, которая поможет диагностировать ошибку (если это поддерживается). |
Поддерживаемые расширения для объекта BidResponse
Атрибут | Подробности реализации |
---|---|
ошибаться | Человекочитаемое описание ошибки с запросом ставки. Случаи ответа включают:
|
errHelp | Ссылка на эту страницу. |
Объект Seatbid
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
делать ставку | да | ||
сиденье | да | ||
группа |
Объект ставки
Атрибут | Поддерживается | Подробности реализации | Всегда проходил |
---|---|---|---|
идентификатор | да | ||
неприятный | да | ||
цена | да | ||
нурл | |||
кап | |||
лурл | |||
адм | |||
адид | |||
домен | |||
пучок | |||
iurl | |||
сид | да | ||
крид | да | ||
тактика | |||
кот | |||
атр | |||
апи | |||
протокол | |||
qagmediarating | |||
язык | |||
действителен | |||
ж | |||
час | |||
отношение | |||
отношение | |||
эксп |
Поддерживаемые расширения для объекта ставки
Атрибут | Подробности реализации |
---|---|
apis | DV360 отправит seatbid.bid.apis , если поддерживаются и OMID, и MRAID. DV360 установит и OMID_1, и MRAID как целочисленный массив. |
Параметры показа рекламы
В разделе 4.3 спецификации OpenRTB указаны два различных варианта обслуживания:
- Наценка, поданная в уведомлении о победе
- Наценка, указанная в заявке
DV360 поддерживает оба варианта.
- Для баннерной рекламы DV360 всегда возвращает разметку в поле
adm
. Разметка, предоставляемая в уведомлении о выигрыше, необязательна. - Для видео/аудиорекламы с использованием протокола VAST DV360 поддерживает возврат VAST XML в поле
adm
или в ответе уведомления о выигрыше на основе требований партнеров по обмену.
Чтобы узнать плюсы и минусы этих двух вариантов, обратитесь к спецификации OpenRTB.
Лучшие практики
Настоятельно рекомендуется использовать идентификатор партнера Display and Video 360 в качестве идентификатора места. Использование идентификатора места, специфичного для биржи, не рекомендуется.
Убедитесь, что у ваших издателей есть файлы ads.txt или приложения со связанными файлами app-ads.txt, и они указывают вас в файле как авторизованного продавца или реселлера. Узнать больше .
Также убедитесь, что в запросах ставок передается согласованная информация. Например, app.bundle
должен соответствовать информации о мобильном устройстве и app.storeurl
.
Подключенное ТВ
Придерживайтесь рекомендаций IAB OTT IFA при передаче device.ifa
и device.lmt
. Вам также следует реализовать device.ext.ifa_type
для соответствия рекомендациям. Все наши возможности ограничения частоты CTV и таргетинга аудитории потребуют наличия IFA.
Также придерживайтесь недавно опубликованных рекомендаций IAB OTT/CTV Store Assigned ID (они определяют, как app.bundle
должен передаваться для приложений CTV), в основном с использованием идентификатора, определенного в магазине приложений.
Измерение Active View
Active View — это технология Google, используемая для измерения того, был ли показ видимым и как долго. Active View использует OMID как для дисплейной, так и для видеорекламы. Чтобы включить измерение с использованием OMID, биржи должны добавить следующие поля в запросы OpenRTB, чтобы DV360 знал о поддержке OMID клиентом.
- Требуется: Добавьте API Framework (
Video.api=7
дляOMSDK
) к запросам ставок. Это обязательно для Active View, чтобы включить измерение с использованием OMID. - Рекомендуется: добавление
omidpn
иomidpv
вSource.Ext
настоятельно рекомендуется, поскольку это повлияет на то, как измерения видимости будут сообщаться в DV360 клиенту. Если имя партнера OMID отсутствует в списке сертификации IAB , MRC требует от нас сообщать метрики видимости отдельно от сертифицированных метрик MRC. Подробнее .
Часто задаваемые вопросы
- Поддерживает ли DV360 обмен пользовательскими расширениями?
- Да, в дополнение к расширениям, перечисленным в этой спецификации, Display and Video 360 может также поддерживать пользовательские расширения в каждом конкретном случае. Рекомендуется указать и протестировать пользовательское расширение в период интеграции.
- Поддерживает ли DV360 видео с вознаграждением?
- Да, отправьте нам расширение для видео с вознаграждением .
- Большая часть моего инвентаря отображается с неизвестными демографическими данными. Как мне улучшить демографический охват?
- Заполните
user.yob
иuser.gender
в запросах ставок в DV360, чтобы увеличить охват. - Есть ли у DV360 конечные точки для каждого региона?
- Нет, мы используем единую конечную точку по всему миру и автоматически направляем запросы в ближайший центр обработки данных, поэтому мы не можем предоставить конечную точку, привязанную к какому-либо региону.
- Каковы требования к запросам «сервер-сервер» (s2s)?
- Обратитесь , чтобы запросить добавление в наш список разрешенных. Клиентский пользовательский агент должен быть перенаправлен, и убедитесь, что файлы cookie отключены/игнорированы в ответе на выборку s2s VAST.
- Поддерживает ли DV360 OMID?
- Мы можем измерить видимость с использованием OMID, если она объявлена OMID с поддержкой во время запроса. Подробности об этом приведены на страницах 24-25 .
- Какую версию нативного вы поддерживаете? У вас есть собственные требования?
- Мы поддерживаем только родной Ver1.2. Нативная спецификация .
- Отправлены ли запросы на поддержку DV360 в качестве GZIP?
- DV360 может получать запросы на сжатую ставку GZIP и ответит с помощью сжатых ответов GZIP, если заголовок приема, кодируя, указывает на его поддерживается.
- Поддерживает ли DV360 Dburl?
- На данный момент нет.
- DV360 поддерживает уведомление о победе?
- Не сейчас. Если вы думаете, что нам было бы полезно поддержать его, пожалуйста, обратитесь к более подробной информации.
- Требуется ли DV360 app.name для таргетинга?
- Нет, DV360 с использованием app.name для справки, но это не требуется для таргетинга,
App.bundle
используется для таргетинга. - Может ли DV360 поддержать несколько размеров объявлений, отправленных в один запрос на предложение?
- Да, мы рассмотрим все подходящие творческие размеры в Banner.format.
- Поддерживает ли DV360 несколько форматов в одном и том же запросе ставки?
- Мы имеем ограниченную поддержку для многоформатных запросов предложений, но работаем над улучшением. Мы поддерживаем отображение и форматы видео для интерстициалов, но в настоящее время не поддерживаем дисплей и нативные. Если вы отправляете многоформатные запросы на ставку, пожалуйста, обратитесь за запросом теста.
- Поддерживает ли DV360 смешанные типы впечатлений в том же запросе?
- В настоящее время мы поддерживаем только интерстиции видео/баннера. Мы работаем над Native/Banner & Video/Banner. Если есть другие комбинации, пожалуйста, обратитесь к нашей команде.
- Могут ли несколько мест отправить несколько предложений на одну или несколько таких возможностей впечатления в одном и том же запросе?
- Да.
- Есть ли у DV360 решение или особую потребность в ограничении или отображении одного и того же рекламодателя для множества таких возможностей впечатления в том же запросе?
- DV360 устанавливает право соблюдения, что один рекламодатель может предложить только одну возможность IMP для каждого запроса. Мы ожидаем, что SSP будут значительно группировать объекты IMP; Например, все на одной странице, все в одном и том же приложении и т. Д.
- Поддерживает ли DV360 несколько впечатлений в одном и том же запросе ставки?
- DV360 в настоящее время поддерживает несколько впечатлений. Тем не менее, нам нужно будет протестировать/включить каждый обмен, который хотел бы использовать эту функцию. См. Спецификацию запроса ставки для получения дополнительной информации. Мы работаем над расширением этого в других форматах:
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
Связаться с нами
Если у вас есть какие -либо вопросы или проблемы, обратитесь к нашей команде поддержки Exchange.