Открытая заявка на участие в торгах RTB 2.5
На этой странице объясняется, как подавать заявки на участие в торгах
Предлагаемые заголовки конкурсных заявок
- HTTP-заголовок версии OpenRTB: x-openrtb-version: 2.5
- Заголовок HTTP Keep-Alive: Соединение: Keep-Alive
- Содержание JSON: Content-Type: application/json
Следующие объекты должны быть отправлены в теле запроса в кодировке JSON:
Заявка на участие в торгах
| Атрибут | Требуется? | Описание |
|---|
| на | Да | Тип аукциона, первая цена = 1 (int) |
| id | Да | Уникальный идентификатор заявки на участие в торгах (строка) |
| имп | Да | Массив объектов Imp, представляющих предлагаемые впечатления(объект). |
| сайт | Да | Подробная информация о сайте (объекте) издательства. |
| приложение | Да | Подробная информация о приложении (объекте) издателя. |
| устройство | Да | Сведения об устройстве пользователя, на которое будет доставлено впечатление (объект). |
| пользователь | Нет | Подробная информация о человеке, использующем устройство; рекламная аудитория (объект). |
| ext | Нет | Держатель для расширений к OpenRTB. |
Примечание: В каждом запросе должен присутствовать только один из объектов {site, app}.
имп
| Атрибут | Требуется? | Описание |
|---|
| id | Да | Уникальный идентификатор впечатления в данном запросе на участие в торгах (строка) |
| bidfloor | Нет | Минимальная ставка за данное впечатление (CPM) / клик (CPC) и валюта счета (float). |
| баннер | Только для полностраничных изображений | Баннерный объект (предмет). |
| безопасный | Нет; Рекомендуется 1 | Флаг, указывающий, требует ли впечатление безопасного HTTPS URL творческих активов и разметки, где 0 = небезопасный, 1 = безопасный. Если флаг опущен, состояние безопасности неизвестно, но можно предположить поддержку небезопасного HTTP, необязательно (целое число) |
имп.знамя
| Атрибут | Требуется? | Описание |
|---|
| w | Да | Ширина баннера (целое число) |
| h | Да | Высота баннера (целое число) |
| мимы | Да | Типы мимов - изображение/jpg, изображение/png, видео/mp4 или изображение/webp |
имп.видео
| Атрибут | Требуется? | Описание |
|---|
| мимы | Да | Поддерживаемые типы MIME содержимого (например, "video/mp4") (массив строк ) |
| мышление | Нет | Минимальная продолжительность видеорекламы в секундах (целое число) |
| maxduration | Нет | Максимальная продолжительность видеорекламы в секундах (целое число) |
| протоколы | Нет | Массив поддерживаемых видеопротоколов (целое число) |
| линейность | Нет | Указывает, должен ли оттиск быть линейным, нелинейным и т.д. Если не указано, считайте, что разрешены все (целое число) |
| бокс разрешен | Нет | Указывает, разрешено ли буквенное копирование содержимого формата 4:3 в окно 16:9, где 0 = нет, 1 = да (целое число) |
| позиция | Нет | Положение объявления на экране (целое число) |
| h | Нет | Ширина видеоплеера в независимых от устройства пикселях (DIPS) (целое число) |
| w | Нет | Высота видеоплеера в независимых от устройства пикселях (DIPS) (целое число) |
| ext | Нет | Место для специфических для биржи расширений OpenRTB (объект) |
imp.video.ext
| Атрибут | Требуется? | Описание |
|---|
| тип зоны | Нет | Тип зоны в форматах объявлений ExoClick (например: video_slider) |
| cta | Нет | Указывает, отображается ли в рекламной зоне компонент CTA (целое число) |
сайт
| Атрибут | Требуется? | Описание |
|---|
| id | Рекомендуем | Уникальный идентификатор сайта (строка) |
| имя | Нет | Название сайта (строка) |
| домен | Рекомендуем | Доменное имя сайта (строка) |
| кот | Нет | Идентификатор категории IAB (массив строк) |
| страница | Рекомендуем | Полный URL-адрес страницы, на которой будет показано объявление (строка) |
| ключевые слова | Нет | Ключевые слова можно использовать для того, чтобы рекламные зоны получали нужный тип рекламы. Ключевые слова должны представлять собой строку слов, разделенных запятыми |
site.ext
| Атрибут | Требуется? | Описание |
|---|
| обменник | Нет | Идентификатор пользовательской категории ExoClick (целое число) |
| idzone | Нет | Пользовательский идентификатор зоны ExoClick (целое число) |
приложение
| Атрибут | Требуется? | Описание |
|---|
| id | Рекомендуем | Уникальный идентификатор приложения (строка) |
| имя | Нет | Название приложения (строка) |
| домен | Рекомендуем | Доменное имя приложения (строка) |
| кот | Нет | Идентификатор категории IAB (массив строк) |
| ключевые слова | Нет | Ключевые слова можно использовать для того, чтобы рекламные зоны получали нужный тип рекламы. Ключевые слова должны представлять собой строку слов, разделенных запятыми (строка) |
| издатель | Нет | Сведения об издателе (объекте) |
устройство
| Атрибут | Требуется? | Описание |
|---|
| ua | Да | Агент пользователя браузера (строка) |
| sua | Нет | Структурированная информация об агенте пользователя, которая может быть использована, когда клиент поддерживает User-Agent Client Hints (объект) |
| гео | Нет | Предполагается, что местоположение устройства - это текущее местоположение пользователя, определяемое объектом Geo. |
| ip | Да | IPv4-адрес пользователя (строка)* |
| ipv6 | Да | IPv6-адрес пользователя (строка)* |
| язык | Рекомендуем | Язык браузера (строка) |
| os | Нет | Операционная система (строка) |
| js | Нет | Поддержка JavaScript, где 0 = нет, 1 = да (целое число) |
| ext | Нет | Место для расширения OpenRTB, специфичного для биржи |
Примечание: В запросе нужно указывать только ip или ipv6, но не оба. Если вы используете ipv6, удалите атрибут ip, и наоборот. Включение обоих атрибутов может привести к ошибкам.
устройство.гео
| Атрибут | Требуется? | Описание |
|---|
| страна | Нет | Страна ISO3 |
устройство.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. (строка) |
| источник | Рекомендуем | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Атрибут | Требуется? | Описание |
|---|
| бренд | Требуется | Значение может быть получено из заголовков User-Agent Client Hints, представляющих либо марку агента пользователя (из заголовка Sec-CH-UA-Full-Version), либо марку платформы (из заголовка Sec-CH-UA-Platform). (строка) |
| версия | Рекомендуем | Последовательность компонентов версии, в нисходящем иерархическом порядке [мажор, минор, микро, ...] (массив строк) |
пользователь
| Атрибут | Требуется? | Описание |
|---|
| id | Нет | Уникальный идентификатор пользователя (строка) |
| ext | Нет | Место для специфических для биржи расширений OpenRTB (объект) |
user.ext
| Атрибут | Требуется? | Описание |
|---|
| согласие | Нет | Это строка согласия, требуемая стандартами IAB. Отрицательное согласие только сейчас (строка) |
регс
| Атрибут | Требуется? | Описание |
|---|
| ext | Нет | Место для специфических для биржи расширений OpenRTB (объект) |
regs.ext
| Атрибут | Требуется? | Описание |
|---|
| gdpr | Нет | Параметр равен 0, если вызывающая сторона считает, что пользователь не подпадает под GDPR, и 1, если пользователь подпадает под GDPR. Если ни то, ни другое, этот параметр не будет определен. |
ext
| Атрибут | Требуется? | Описание |
|---|
| суб | Нет | Идентификатор подсистемы. Это должно быть число от шести до десяти цифр: Не используйте нули в начале Sub ID. |