Подключение RTB системы – справочная информация для партнёров. Описывает работу и техническое взаимодействие интерфейсов между собой, для лучшего понимания технологии. Разработка реализована согласно спецификации OpenRTB v.2.5 – https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf

Как работает RTB?
- Пользователь заходит на сайт, где размещены рекламные RTB блоки.
- Браузер посетителя отправляет в Redtram SSP запрос (Bid request) на показ рекламы.
- Рекламная площадка Redtram SSP формирует аукцион для продажи инвентаря.
- Рекламодатели, через DSP участвуют в аукционе и формируют ставки (Bid response).
- Выигрывает тот рекламодатель, который дал максимальную цену.
- Redtram SSP определяет победителя аукциона и передает рекламные материалы в браузер.
- Посетитель сайта видит отрисованные рекламные блоки.
Может показаться, что показ рекламы проходит долго по времени, но это не так. RTB аукцион срабатывает мгновенно, за миллисекунды. Пользователь сайта не замечает и не догадывается, что реклама проходит такие этапы отбора и борьбы за показы между рекламодателями.
Компоненты технологии
RTB (Real Time Bidding) – это технология закупки рекламы в режиме реального времени по принципу аукциона, в котором участвую рекламодатели и владельцы площадок.
Рекламодатели предлагают свои ставки за показ объявления, а веб-мастер выбирают самую выгодную цену за показ рекламы на своем сайте. Всё происходит мгновенно и автоматически.
SSP (Sell Side Platform) – платформа онлайн торгов, которая представляет интересы владельцев сайтов (веб-мастеров).
DSP (Demand Side Platform) – платформа объединяющая интересы рекламодателей, формирует финальную ставку для выкупа рекламного инвентаря.
Bid request – запрос от SSP, отправляемый рекламодателям для участия в онлайн торгах.
Bid response – ответ рекламодателя-победителя в виде ставки, сформированной в ходе аукциона.
RTB-блок – инвентарь или место на сайте, которое веб-мастер выделил под рекламу.
Спецификация RedTram SSP
Содержание
На заметку. В описанных ниже подразделах расскажем как определяется объекты моделей запросов. Используются несколько соглашений, о которых нужно знать:
1. Атрибуты, которые «обязательные» и их отсутствие технически нарушает протокол.
2. Некоторые необязательные атрибуты помечены как «рекомендуемые» из-за их высокой важности для бизнеса.
3. Если значение по умолчанию не указано явно, пропущенный атрибут интерпретируется как «неизвестно».
Параметры bid-запроса (Bid Request)
Объект Bid request
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Обязательное | — | Уникальный идентификатор bid-запроса |
imp | array of objects | Обязательное | — | Массив баннеров. В одном bid-запросе может быть указано несколько объектов. Наличие по крайней мере одного баннера — обязательно. |
device | object | Рекомендуемое | — | Описание устройства отображения баннера (например, мобильные устройства, десктоп и другие) и параметры отображения (например, поддержка flash) |
user | object | Рекомендуемое | — | Описание пользователя. Может включать уникальные идентификаторы пользователей |
site | object | Рекомендуемое | — | Объект сайта или мобильного приложения. Может содержать только одно из двух значений |
bcat | array of strings | Необязательное | — | Заблокированные рекламные категории |
cur | array of strings | Необязательное | — | Валюта аукциона |
Объект Impression
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Обязательное | — | Уникальный идентификатор показа в контексте bid-запроса |
banner | object | Обязательное | — | Ссылка на объект баннера |
bidfloor | float | Необязательное | 0 | Минимальная стоимость показа в CPM |
bidfloorcur | string | Необязательное | USD | Валюта минимальной стоимости показа |
Объект Banner
Атрибут | Тип | Применение | По умолчанию | Описание |
w | integer | Рекомендуемое | — | Ширина баннера в пикселях |
h | integer | Рекомендуемое | — | Высота баннера в пикселях |
pos | integer | Необязательное | — | Позиция на странице |
battr | array of integer | Необязательное | — | Типы баннеров, заблокированных пользователем |
Объект Site
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Рекомендуемое | — | Идентификатор сайта |
ref | optional | Рекомендуемое | — | Ссылка реферера, с которого произошел переход на страницу сайта |
page | string | Рекомендуемое | — | Полная ссылка страницы, где произошел показ |
cat | array of strings | Рекомендуемое | — | Массив категорий по стандарту IAB (5 на весь сайт) |
sectioncat | array of strings | Рекомендуемое | — | Массив категорий по стандарту IAB (5 на весь сайт) |
Объект Content
Атрибут | Тип | Применение | По умолчанию | Описание |
keywords | string | Рекомендуемое | — | Разделенный запятыми, список ключевых слов, описывающих контент. |
Объект Device
Атрибут | Тип | Применение | По умолчанию | Описание |
ua | string | Рекомендуемое | — | Строка юзер агента браузера посетителя |
ip | string | Рекомендуемое | — | IPv4 адрес устройства |
geo | object | Рекомендуемое | — | География, полученная из служб определения местоположения устройства |
language | string | Необязательно | — | Язык браузера; стандарт alpha-2/ISO 639-1 |
Объект User
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Рекомендуемое | — | Уникальный идентификатор пользователя на бирже |
buyeruid | string | Рекомендуемое | — | ID пользователя в системе DSP |
Параметры bid-ответа (Bid Response)
Объект Bid response
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Обязательное | — | Идентификатор bid-ответа |
seatbid | array of objects | Необязательное | — | Массив seatbid объектов |
Объект Seatbid
Атрибут | Тип | Применение | По умолчанию | Описание |
bid | array of objects | Обязательное | — | Идентификатор bid-запроса. Массив bid-объектов, каждый из которых соотносится с impression-объектом (объектом показа) bid-запроса. Каждый impression-объект может содержать несколько bid-объектов |
Объект Bid
Атрибут | Тип | Применение | По умолчанию | Описание |
id | string | Обязательное | — | Идентификатор bid-объекта |
impid | string | Обязательное | — | Идентификатор impression-объекта, к которому относится bid-объект |
price | float | Обязательное | — | Ставка в CPM |
adid | string | Необязательное | — | Идентификатор рекламного блока, который будет показан в случае, если аукцион будет выигран |
adomain | array of strings | Необязательное | — | Основной домен/домен верхнего уровня для проверки рекламодателя |
nurl | string | Необязательное | — | Ссылка оповещения о выигрыше лота |
Пример запроса рекламного блока
{ "ver": "1.1", "context": 1, "plcmttype": 1, "plcmtcnt": 1, "seq": 0, "assets": [ { "id": 1, "required": 1, "title": { "len": 140 } }, { "id": 2, "required": 1, "image": { "type": 3, "wmin": 200, "hmin": 200 } }, { "id": 3, "required": 1, "image": { "type": 1, "wmin": 50, "hmin": 50 } }, { "id": 4, "required": 1, "data": { "type": 2 } }, { "id": 5, "required": 1, "data": { "type": 12 } } ] }