Подключение технологии RTB

By 24.02.2021 5 мая, 2021 Инструкции

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

технология rtb specification

Как работает RTB?

  1. Пользователь заходит на сайт, где размещены рекламные RTB блоки.
  2. Браузер посетителя отправляет в Redtram SSP запрос (Bid request) на показ рекламы.
  3. Рекламная площадка Redtram SSP формирует аукцион для продажи инвентаря.
  4. Рекламодатели, через DSP участвуют в аукционе и формируют ставки (Bid response).
  5. Выигрывает тот рекламодатель, который дал максимальную цену.
  6. Redtram SSP определяет победителя аукциона и передает рекламные материалы в браузер.
  7. Посетитель сайта видит отрисованные рекламные блоки.

Может показаться, что показ рекламы проходит долго по времени, но это не так. 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 Валюта минимальной стоимости показа
Атрибут Тип Применение По умолчанию Описание
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
}
}
]
}

Остались вопросы?