RTB

Введение

RTB аукцион (SSP) предоставляет владельцам рекламных площадок возможность вести торги в реальном времени выбирая самые выгодные предложения, которые предоставляют рекламодатели.

Как работает RTB (real-time bidding)

Real-time bidding (торги в реальном времени) являются взаимодействием уровня серверсервер между рекламным инвентарем на аукционе SSP (sell-side platform) и продавцами (рекламными площадками) по протоколу http post. Весь рекламный инвентарь, который удовлетворяет требования, доступен владельцам площадок посредством RTB инфраструктуры.
Ниже описанный принцип работы аукциона дает краткое понятие о процессе (более детализированное описание смотрите в разделе “Описание рабочего процесса”):
1. RTB SSP (Real-time bidding sell-side platform) получает рекламный запрос от продавца и отбирает список покупателей для аукциона
2. RTB SSP отправляет запрос покупателям из выбранного списка
3. Каждый покупатель из списка получает запрос и оценивает свою возможность участия в торгах, отвечает на запрос
4. RTB SSP проводит аукцион на основании полученных ставок от покупателей
5. RTB SSP «доставляет» рекламное объявление победителя торгов среди рекламодателей продавцу рекламного места на площадке
6. RTB SSP отсылает результаты торгов участникам аукциона

О документе

Документ описывает подключение DSP (demand-side platform) или рекламодателя к RTB SSP (sell-side platform). Интерфейс SSP разработан в соответствии со спецификацией протокола OpenRTB v.2.3
http://www.iab.net/media/file/OpenRTB-API-Specification-Version-2-3.pdf

Термины и определения

Bid request – запрос от RTB SSP отсылаемый покупателям (рекламодателям) для выставления на торг своих рекламных предло ений Bid response – ответ покупателя к RTB SSP в качестве ставки для торгов CPM (Cost per mille) – цена за одну тысячу показов рекламного объявления RTB (Real-time bidding) – торги в реальном времени, принцип поставки рекламы продавцу рекламного места в реальном времени SSP (sell-side platform) – система торгов в реальном времени, представляющая интересы продавцов (владельцев площадок) DSP (demand-side platform) - рекламная система представляющая интересы покупателей (рекламодателей) Впечатление - тизер, баннер, отдельное рекламное объявление

Синхронизация пользователей

Под статистикой по площадкам в кабинете рекламодателя подразумевается статистика по показам и кликам на площадке в разрезе каждой кампании.
Для получения статистики по площадкам используется метод ads.campaigns.statblock (GET запрос)

Параметры	Значение	Дополнительные атрибуты
date_from	Начальная дата выводимой статистики.	строка, формат YYYY-MM-DD (пример: 2017-05-15), параметр фильтрации
date_to	Конечная дата выводимой статистики.	строка, формат YYYY-MM-DD (пример: 2017-05-15), параметр фильтрации
campaign_id	id кампании	обязательный параметр, int (числовое значение), параметр фильтрации
signature	Подпись (генерируется с помощью временного токена, см. выше)	обязательный параметр, строка
app_id	id пользователя	обязательный параметр, int (числовое значение)
macros	id площадки	int (числовое значение), параметр сотировки, параметр фильтрации
leads	Лиды	int (числовое значение), параметр сотировки, параметр фильтрации
views	Показы	int (числовое значение), параметр сотировки, параметр фильтрации
clicks	Клики	int (числовое значение), параметр сотировки, параметр фильтрации
conversions	Подтвердженные конверсии	int (числовое значение), параметр сотировки, параметр фильтрации
rejections	Отказанные конверсии	int (числовое значение), параметр сотировки, параметр фильтрации
ctr	CTR	int (числовое значение), параметр сотировки, параметр фильтрации
cpm	CPM	int (числовое значение), параметр сотировки, параметр фильтрации
cpc	CPC	int (числовое значение), параметр сотировки, параметр фильтрации
prelandvisit	Визиты преленда	int (числовое значение), параметр сотировки, параметр фильтрации
prelanduseful	Полезные визиты преленда	int (числовое значение), параметр сотировки, параметр фильтрации
prelandscroll	Скролл преленда	int (числовое значение), параметр сотировки, параметр фильтрации

Результат:
Возвращает объект с данными, пример:

{
  "response": {
    "count": 1,
    "items": [
      {
        "macros": "12345678901234",
        "block": "1234",
        "domain": "123456789",
        "leads": "0",
        "views": "123",
        "clicks": "0",
        "conversions": "0",
        "rejections": "0",
        "ctr": "0.0000",
        "cpm": "0.00",
        "cpc": null,
        "moneyOut": "0.000000",
        "moneyIn": null,
        "prelandvisit": "0",
        "prelanduseful": "0",
        "prelandscroll": "0",
        "landvisit": "0",
        "landuseful": "0",
        "landscroll": "0",
        "multiplier": null,
        "blackList": "0"
      }
    ],
    "request": {
      "campaignId": 123456,
      "limit": 10,
      "offset": 0
    }
  }
}

Сортировка

Сортировка по возрастанию

sort={параметр}
Пример: api.kadam.net?sort=views

Сортировка по убыванию

sort=-{параметр}
Пример: api.kadam.net?sort=-views

Сортировка по нескольким параметрам

sort={параметр1},-{параметр2},{параметр3}
Пример: api.kadam.net?sort=views,-clicks,leads

Фильтрация

{параметр}={значение}
Примеры:
api.kadam.net?attr=10
api.kadam.net?attr=string
api.kadam.net?attr=string&date_from=01.05.2016&date_to=01.07.2016