Запрос на бид Open RTB 2.5
На этой странице описываются различные компоненты RTB-запросов, которые вы будете получать для размещения ставок.
Заголовки запроса ставки
HTTP-заголовок версии OpenRTB: x-openrtb-version: 2.5
HTTP-заголовок Keep-Alive: Connection: Keep-Alive
JSON содержимого: Content-Type: application/json
Заголовок кодирования данных: Accept-Encoding
Запрос ставки 2.5
При запросе ставок для конкретного контекста платформа выполнит HTTP-запрос с тайм-аутом 300 мс и отправит следующий объект, закодированный как JSON, в теле запроса. HTTP рекомендуется из-за дополнительной задержки при использовании HTTPS.
id
Уникальный ID запроса ставки (строка)
site
Сведения о веб-сайте издателя через объект Site (object)
device
Сведения об устройстве пользователя, на которое будет доставлен показ рекламы (object)
user
Сведения о человеке-пользователе устройства; рекламная аудитория (object)
imp
Сведения о рекламном размещении или показе, выставляемом на аукцион (object)
regs
Сведения о любых отраслевых, правовых или государственных нормативных требованиях, действующих для этого запроса (object)
ext
Заполнитель для расширений OpenRTB (object)
site
id
Уникальный ID сайта (строка)
domain
Доменное имя сайта (строка)
cat
ID категории IAB (массив строк)
page
Полный URL страницы, где будет показано объявление (строка)
keywords
Ключевые слова можно использовать, чтобы рекламные зоны получали нужный тип рекламы. Ключевые слова должны быть строкой слов, разделённых запятыми
ext
Заглушка для расширений, специфичных для биржи (объект)
site.ext
exchangecat
Пользовательский ID категории ExoClick (целое число)
idzone
Пользовательский ID рекламной зоны ExoClick (целое число)
keyword
Соответствующее ключевое слово, если есть (строка)
device
ua
User-Agent браузера (строка)
sua
Структурированная информация user-agent, которая может использоваться, когда клиент поддерживает User-Agent Client Hints (объект)
geo
Местоположение устройства, предполагаемое как текущее местоположение пользователя, заданное объектом Geo
ip
IPv4-адрес пользователя (строка)*
ipv6
IPv6-адрес пользователя (строка)*
language
Язык браузера (строка)
os
Операционная система (строка)
js
Поддержка JavaScript, где 0 = нет, 1 = да (целое число)
ext
Заполнитель для расширений OpenRTB, специфичных для биржи (объект)
*В запросе ставки будет присутствовать ровно один из ip или ipv6.
device.geo
country
Страна ISO3
ipservice
Сервис или провайдер, используемый для определения геолокации по IP-адресу, если применимо (integer)
device.ext
remote_addr
Основной IP-адрес пользователя (строка)
x_forwarded_for
IP-адрес пользователя из X-FORWARDED-FOR или пусто, если не задан (строка)
device.sua
Структурированная информация User-Agent. device.sua считается более точным представлением атрибутов устройства.
browsers
Отправляйте бренды и версии, полученные из заголовка Sec-CH-UA-Full-Version-List. (Массив BrandVersion объектов)
platform
Отправляйте бренд, полученный из заголовка Sec-CH-UA-Platform, и версию, полученную из заголовка Sec-CH-UA-Platform-Version. (BrandVersion Объект)
mobile
Получайте это значение из заголовка Sec-CH-UA-Mobile. (целое число)
architecture
Получайте это значение из заголовка Sec-CH-UA-Arch. (строка)
bitness
Получайте это значение из заголовка Sec-CH-UA-Bitness. (строка)
model
Получайте это значение из заголовка Sec-CH-UA-Model. (строка)
source
Источник данных, использованных для создания этого объекта, Список: источник User-Agent в AdCOM 1.0 (целое число; по умолчанию 0)
device.sua.browsers | device.sua.platform
brand
Значение может быть получено из заголовков User-Agent Client Hints и представлять либо бренд user agent (из заголовка Sec-CH-UA-Full-Version), либо бренд платформы (из заголовка Sec-CH-UA-Platform). (строка)
version
Последовательность компонентов версии в порядке убывания по иерархии [major, minor, micro, …] (массив строк)
user
id
Уникальный ID пользователя (строка)
user.ext
согласие
Это строка согласия, требуемая стандартами IAB. Пока только отрицательное согласие (строка)
regs
ext
Заполнитель для расширений OpenRTB, специфичных для биржи.
regs.ext
GDPR
Это 0, если вызывающая сторона считает, что пользователь не подпадает под GDPR, и 1, если пользователь подпадает под GDPR. Если ни то ни другое, этот параметр будет неопределён.
imp
id
Уникальный идентификатор этого показа в контексте запроса ставки (string)
instl
1 = объявление интерстициальное или полноэкранное, 0 = не интерстициальное (integer)
video
Сведения через объект Video, представляющий видеопоказ in-stream
secure
Флаг, указывающий, требуется ли для показа защищённый URL HTTPS (integer)
ext
Заполнитель для расширений OpenRTB, специфичных для биржи (объект)
imp.video
mimes
Поддерживаемые MIME-типы контента (например, "video/mp4") (массив строк )
minduration
Минимальная длительность видеорекламы в секундах (целое число)
maxduration
Максимальная длительность видеорекламы в секундах (целое число)
protocols
Массив поддерживаемых видеопротоколов (целое число)
linearity
Указывает, должен ли показ быть линейным, нелинейным и т. д. Если ничего не указано, считать, что разрешены все варианты (целое число)
boxingallowed
Указывает, разрешено ли размещение контента 4:3 в окне 16:9 с чёрными полями, где 0 = нет, 1 = да (целое число)
pos
Позиция рекламы на экране (целое число)
h
Ширина видеоплеера в независимых от устройства пикселях (DIPS) (целое число)
w
Высота видеоплеера в независимых от устройства пикселях (DIPS) (целое число)
ext
Заполнитель для расширений OpenRTB, специфичных для биржи (объект)
imp.video.ext
zone_type
Тип зоны в рекламных форматах ExoClick (например: video_slider)
Последнее обновление
Это было полезно?