RTB — различия между версиями

Материал из Справочник сервиса Kadam.net
Перейти к: навигация, поиск
Строка 101: Строка 101:
 
   </tr>
 
   </tr>
 
   <tr bgcolor = #F5F5F5>
 
   <tr bgcolor = #F5F5F5>
       <td>id</td>
+
       <td>at</td>
      <td>string</td>
+
       <td>int</td>
      <td>-</td>
+
       <td>2</td>
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
       <td>Принцип аукциона. Если "1", то первый аукцион. Если "2", то второй аукцион. Дополнительные виды аукционов могут быть определены в соответствии с бизнес правилами биржи.</td>
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>id</td>
+
      <td>string</td>
+
      <td>-</td>
+
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>id</td>
+
      <td>string</td>
+
      <td>-</td>
+
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>id</td>
+
      <td>string</td>
+
      <td>-</td>
+
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>id</td>
+
      <td>string</td>
+
      <td>-</td>
+
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>id</td>
+
      <td>string</td>
+
      <td>-</td>
+
      <td>Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>cpm</td>
+
      <td>CPM</td>
+
       <td>int (числовое значение), параметр сотировки, параметр фильтрации</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
       <td>cpc</td>
+
       <td>CPC</td>
+
      <td>int (числовое значение), параметр сотировки, параметр фильтрации</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>prelandvisit</td>
+
      <td>Визиты преленда</td>
+
      <td>int (числовое значение), параметр сотировки, параметр фильтрации</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>prelanduseful</td>
+
      <td>Полезные визиты преленда</td>
+
      <td>int (числовое значение), параметр сотировки, параметр фильтрации</td>
+
  </tr>
+
  <tr bgcolor = #F5F5F5>
+
      <td>prelandscroll</td>
+
      <td>Скролл преленда</td>
+
      <td>int (числовое значение), параметр сотировки, параметр фильтрации</td>
+
 
   </tr>
 
   </tr>
 
</table>
 
</table>

Версия 15:03, 30 мая 2017

Введение

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) - рекламная система представляющая интересы покупателей (рекламодателей)
Впечатление - тизер, баннер, отдельное рекламное объявление

Описание рабочего процесса

Каждый запрос к покупателю (рекламодателю) сопровождается следующими шагами:
1. Выбор покупателя в реальном времени
После получения запроса на показ рекламы от продавца (площадки) RTB аукцион выбирает список покупателей для выставления рекламных ставок. Выбираются ставки, которые имеют наибольшие шансы для победы в аукционе.
2. Запрос на ставки (bid request) от RTB SSP
RTB аукцион отправляет запросы выбранным покупателям (рекламодателям). Запрос содержит техническую информацию необходимую для “поставки” рекламного объявления, а также набор таргетингов по данному запросу. Если один и тот же покупатель (рекламодатель) имеет несколько объявлений, которые совпадают с таргетингами запроса от продавца рекламного места, то RTB аукцион включает в торги все подходящие под запрос поступающие ставки.
3. Ответ от покупателя (bid response)
Покупатель получает запрос от RTB аукциона и оценивает возможность участия в торгах. В качестве ответа покупатель отсылает предложение с ценой ставки или не отвечает на запрос, если у него нет предложений по данному запросу. Покупатель должен ответить на запрос в рамках отведенного интервала времени, иначе потеряет возможность участия в торгах. В случае наличия нескольких предложений для торгов, покупатель должен ответить на запрос ответов с ценой на каждое свое предложение, которое он готов выставить на торг.
4. Аукцион
Когда получены все ставки (в отведенное время на принятие ответов от покупателей), происходит аукцион. Продавцы имеют возможность указать минимальную цену для площадки, на которой они продают место. В связи с этим, каждая победившая ставка должна быть выше, чем минимальная цена, которую выставляет продавец места на площадке. Все материалы проходят обязательную модерацию в системе RTB SSP.
5. Нотификация о результатах
RTB SSP отправляет уведомления о результатах каждому участнику в каждом отдельно взятом аукционе.

Запросы к DSP

Запрос к DSP (или покупателю) представляет собой набор информации:

    - о рекламной площадке;
    - о посетителе этой рекламной площадки;
    - об устройстве, с которого посетитель зашел;
    - о списке рекламных мест под рекламу;

Запрос к DSP представлен в json формате, то есть [content_type] => application/json.


Пример запроса DSP/покупателю

Определение объекта
Ниже приводятся определения различных объектов, задействованных в запросе.
Объект запроса предложения
Объект ставки предложения высшего уровня содержит глобально уникальную ставку предложения или ID аукциона. Этот обязательный «ID» атрибут требует, по крайней мере, один «imp» (например, impression) объект. Другие атрибуты являются необязательными, поскольку обмен может устанавливать значения по умолчанию. Колонка «по умолчанию» определяет, как дополнительные параметры должны быть интерпретированы, если явные значения не предусмотрены.

Поле Тип По умолчанию Описание
id string - Уникальный идентификатор ставки запроса, обеспечивающийся путем обмена
imp array of objects - Массив объектов впечатления. Несколько аукционов впечатлений могут быть указаны в одной ставке предложения. Для правильной ставки требуется, по крайней мере, одно предложение.
site object - см. объект сайта
device object - см. объект устройства
user object - см. объект пользователя
ext object - Этот объект является прототипом, который может содержать пользовательские JSON, согласованные сторонами в сделке OpenRTB, поддерживающей гибкость стандартов, определенных в данной спецификации. Описано в примере запроса к DSP / покупателю
at int 2 Принцип аукциона. Если "1", то первый аукцион. Если "2", то второй аукцион. Дополнительные виды аукционов могут быть определены в соответствии с бизнес правилами биржи.

Пример валидного ответа DSP

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

Под статистикой по площадкам в кабинете рекламодателя подразумевается статистика по показам и кликам на площадке в разрезе каждой кампании.
Для получения статистики по площадкам используется метод 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