Открытая заявка на участие в торгах RTB 2.5
На этой странице описаны различные компоненты RTB-запросов, которые вы получите для участия в торгах.
Заголовки конкурсных заявок
- HTTP-заголовок версии OpenRTB: x-openrtb-version: 2.5
- Заголовок HTTP Keep-Alive: Соединение: Keep-Alive
- Содержание JSON: Content-Type: application/json
- Заголовок кодировки данных: Accept-Encoding
Заявка на участие в торгах 2,5
При запросе ставок для определенного контекста платформа выполнит HTTP-запрос с таймаутом 300 мс и отправит в теле запроса следующий объект, закодированный как JSON. рекомендуется использовать HTTP** из-за дополнительной задержки при использовании HTTPS.
| Атрибут | Описание |
|---|
| id | Уникальный идентификатор заявки на участие в торгах (строка) |
| сайт | Подробности через объект Site о сайте издателя (объект) |
| устройство | Данные об устройстве пользователя, на которое будет доставлен оттиск (объект) |
| пользователь | Подробная информация о человеке, пользующемся устройством; рекламная аудитория (объект) |
| имп | Детали размещения объявления или впечатления, выставляемого на аукцион (объект) |
| регс | Подробные сведения о любых отраслевых, правовых или правительственных нормах, действующих в отношении данного запроса (объект) |
| ext | Место для расширений OpenRTB (объект) |
сайт
| Атрибут | Описание |
|---|
| id | Уникальный идентификатор сайта (строка) |
| домен | Доменное имя сайта (строка) |
| кот | Идентификатор категории IAB (массив строк) |
| страница | Полный URL-адрес страницы, на которой будет показано объявление (строка) |
| ключевые слова | Ключевые слова можно использовать для того, чтобы рекламные зоны получали нужный тип рекламы. Ключевые слова должны представлять собой строку слов, разделенных запятыми |
| ext | Место для специфических для биржи расширений (объект) |
site.ext
| Атрибут | Описание |
|---|
| обменник | Идентификатор пользовательской категории ExoClick (целое число) |
| idzone | Пользовательский идентификатор рекламной зоны ExoClick (целое число) |
| ключевое слово | Соответствующее ключевое слово, если таковое имеется (строка) |
устройство
| Атрибут | Описание |
|---|
| ua | Агент пользователя браузера (строка) |
| sua | Структурированная информация об агенте пользователя, которая может быть использована, когда клиент поддерживает User-Agent Client Hints (объект) |
| гео | Предполагается, что местоположение устройства - это текущее местоположение пользователя, определяемое объектом Geo |
| ip | IPv4-адрес пользователя (строка)* |
| ipv6 | IPv6-адрес пользователя (строка)* |
| язык | Язык браузера (строка) |
| os | Операционная система (строка) |
| js | Поддержка JavaScript, где 0 = нет, 1 = да (целое число) |
| ext | Место для специфических для биржи расширений OpenRTB (объект) |
*В запросе на участие в торгах будет присутствовать только один из ip или ipv6.
устройство.гео
| Атрибут | Описание |
|---|
| страна | Страна ISO3 |
| ipservice | Сервис или провайдер, используемый для определения геолокации по IP-адресу, если применимо (целое число) |
устройство.ext
| Атрибут | Описание |
|---|
| удалённый_адрес | Основной IP-адрес пользователя (строка) |
| x_forwarded_for | X-FORWARDED-FOR IP-адрес пользователя или пустой, если он не установлен (строка) |
устройство.sua
Структурированная информация об агенте пользователя. device.sua считается более точным представлением атрибутов устройства.
| Атрибут | Описание |
|---|
| браузеры | Отправка марок и версий, полученных из заголовка Sec-CH-UA-Full-Version-List. (Массив объектов BrandVersion) |
| платформа | Отправляет бренд, полученный из заголовка Sec-CH-UA-Platform, и версию, полученную из заголовка Sec-CH-UA-Platform-Version. (Объект BrandVersion) |
| мобильный | Получите это значение из заголовка Sec-CH-UA-Mobile. (целое число) |
| архитектура | Получите это значение из заголовка Sec-CH-UA-Arch. (строка) |
| битность | Извлеките это значение из заголовка Sec-CH-UA-Bitness. (строка) |
| модель | Получите это значение из заголовка Sec-CH-UA-Model. (строка) |
| источник | Источник данных, использованных для создания этого объекта, Список: Источник User-Agent в AdCOM 1.0 (целое число; по умолчанию 0) |
| Атрибут | Описание |
|---|
| бренд | Значение может быть получено из заголовков User-Agent Client Hints, представляющих либо марку агента пользователя (из заголовка Sec-CH-UA-Full-Version), либо марку платформы (из заголовка Sec-CH-UA-Platform). (строка) |
| версия | Последовательность компонентов версии, в нисходящем иерархическом порядке [мажор, минор, микро, ...](array of string) |
пользователь
| Атрибут | Описание |
|---|
| id | Уникальный идентификатор пользователя (строка) |
user.ext
| Атрибут | Описание |
|---|
| согласие | Это строка согласия, требуемая стандартами IAB. Отрицательное согласие только сейчас (строка) |
регс
| Атрибут | Описание |
|---|
| ext | Место для специфических для биржи расширений OpenRTB. |
regs.ext
| Атрибут | Описание |
|---|
| gdpr | Параметр равен 0, если вызывающая сторона считает, что пользователь не подпадает под GDPR, и 1, если пользователь подпадает под GDPR. Если ни то, ни другое, этот параметр не будет определен. |
имп
| Атрибут | Описание |
|---|
| id | Уникальный идентификатор для данного впечатления в контексте запроса на участие в торгах (строка) |
| instl | 1 = объявление является интерстициальным или полноэкранным, 0 = не является интерстициальным (целое число) |
| видео | Детали через объект Video, который представляет видеоизображение в потоке |
| безопасный | Флаг, указывающий, требует ли оттиск безопасный HTTPS URL (целое число) |
| ext | Место для специфических для биржи расширений OpenRTB (объект) |
имп.видео
| Атрибут | Описание |
|---|
| мимы | Поддерживаемые типы MIME содержимого (например, "video/mp4") (массив строк ) |
| мышление | Минимальная продолжительность видеорекламы в секундах (целое число) |
| maxduration | Максимальная продолжительность видеорекламы в секундах (целое число) |
| протоколы | Массив поддерживаемых видеопротоколов (целое число) |
| линейность | Указывает, должен ли оттиск быть линейным, нелинейным и т.д. Если не указано, считайте, что разрешены все (целое число) |
| бокс разрешен | Указывает, разрешено ли буквенное копирование содержимого формата 4:3 в окно 16:9, где 0 = нет, 1 = да (целое число) |
| позиция | Положение объявления на экране (целое число) |
| h | Ширина видеоплеера в независимых от устройства пикселях (DIPS) (целое число) |
| w | Высота видеоплеера в независимых от устройства пикселях (DIPS) (целое число) |
| ext | Место для специфических для биржи расширений OpenRTB (объект) |
imp.video.ext
| Атрибут | Описание |
|---|
| тип зоны | Тип зоны в форматах объявлений ExoClick (например: video_slider) |