Аукцион RTB

Каждый раз, когда экран собирается заполнить программатик-слот, управляющая им система управления контентом (CMS) отправляет CityScreen Context рекламный запрос — вопрос о том, что показывать; классические слоты CMS контролирует напрямую, о них написано в других разделах. Этот раздел описывает, что происходит между вопросом и ответом.

Страница адресована инженерам, которые подключают CMS к платформе, и сотрудникам с ролями владельца, администратора и менеджера, которые настраивают, что платформа продаёт от их имени.

Рекламный запрос относится к одной рекламной поверхности, к одному моменту и к одной длительности слота. Платформа решает заново для каждой возможности и записывает принятое решение.

Цикл

ad-request-loop

Вызов синхронный. CMS держит соединение открытым на протяжении всей описанной выше последовательности, включая win notice, отправляемое победившему партнёру.

Шаг за шагом

  1. Приходит запрос. CMS отправляет рекламный запрос, в котором названы организация и рекламная поверхность и указаны момент показа, длительность слота и оценка аудитории.

  2. Определяется, кто обращается. Платформа находит токен доступа и по нему определяет организацию, которая сама должна быть включена. Затем организацию из пути запроса сверяют с её собственными настройками синхронизации, так что токен и идентификатор инвентаря должны совпасть. См. Токены доступа.

  3. Проверяются часы. Время показа из запроса сравнивают со временем сервера. Расхождение в три минуты и больше в любую сторону заканчивает запрос ошибкой, поэтому, когда экран целиком перестаёт продавать, первым делом стоит заподозрить несинхронизированные часы плеера.

  4. Собирается контекст. Платформа загружает данные рекламной поверхности, её настройки, действующую комиссию и прайс-лист, который охватывает эту поверхность, вместе с источниками спроса, которых он допускает. У рекламной поверхности свой прайс-лист, если он к ней привязан, а иначе действует прайс-лист организации по умолчанию.

  5. Рассчитываются минимальные цены. Оценка аудитории, присланная CMS, передаётся дальше как есть, если только у рекламной поверхности нет поправочного коэффициента: тогда используется скорректированное значение. Для каждой длительности креатива, на которую в прайс-листе есть цена, считается минимальная цена, увеличенная на комиссию, поэтому партнёру предлагают ту сумму, которую ему придётся заплатить. См. Минимальные цены.

  6. Каждого допущенного партнёра опрашивают одновременно. Прайс-лист RTB в режиме аукциона раскладывает партнёров по группам приоритета и сравнивает пришедшие ставки. Прайс-лист в режиме waterfall вместо сравнения берёт первый пригодный ответ. В любом случае партнёров опрашивают параллельно, а ответ, который не пришёл в пределах лимита на партнёра, не учитывается. См. Лимит времени.

  7. Выбирается победитель. Сначала отбрасываются ответы без пригодной ставки: ниже минимальной цены, нулевые, с неподходящей длительностью креатива, с креативом, который не подходит рекламной поверхности, с кампанией, не нацеленной на эту рекламную поверхность. Кампания programmatic guaranteed (PG-кампания), у которой текущий момент попадает в расписание и у которой в квоте на текущий час остались показы, занимает слот раньше любой ставки. Иначе побеждает самая высокая ставка, и с неё списывают сумму по правилу итоговой цены — см. Как выбирается победитель.

  8. Победителя уведомляют раньше, чем CMS. Если выигравшая ставка пришла с URL win notice (уведомления о выигрыше), платформа вызывает его с указанием списанной цены и ждёт. Если вызов не удался, ответ CMS пустой.

  9. Решение записывается. Платформа записывает рекламную поверхность, победившего партнёра, кампанию и объявление, минимальную цену, списанную цену и комиссию платформы с неё. На этой записи строятся отчётность по доставке, выручка и учёт выигрышей и проигрышей партнёров.

  10. Ответ возвращается. CMS получает идентификатор запроса, идентификатор объявления, которое нужно показать, и цену. Это объявление у CMS уже есть, потому что креативы попадают к ней после одобрения, поэтому ответ только называет, какое из них показывать.

  11. Возвращается результат. После того как слот отыграл, CMS сообщает об успехе или неудаче по идентификатору запроса. К оплате выставляется только подтверждённый показ. См. Отчётность.

Что заканчивает запрос без ответа

Одни из этих причин приводят к ошибке, другие — к пустому, но успешному ответу. Эта разница важна тем, кто пишет обработку ошибок в CMS.

Причина Результат Куда смотреть

Неизвестный токен или организация отключена

Ошибка

Токены доступа

Организация в пути запроса — не та, которой принадлежит токен

Ошибка

Токены доступа

Часы плеера расходятся со временем сервера на три минуты и больше

Ошибка

Эта страница, шаг 3

Рекламная поверхность отключена

Ошибка

Активация

Рекламную поверхность не охватывает ни один прайс-лист, и у организации нет прайс-листа по умолчанию

Ошибка

Прайс-листы RTB

Прайс-лист не допускает ни одного активного источника спроса

Ошибка

Управление источниками спроса

Комиссия оказывается нулевой или отрицательной

Ошибка

Сборы и комиссия

Ни один партнёр не сделал ставку, или ни одна ставка не выше минимальной цены

Пустой ответ

Как выбирается победитель

Победителя не удалось уведомить

Пустой ответ

Эта страница, шаг 8