Skip to main content
Справочник к странице «Промо-баннеры».

Понятия

Модели и поля

Промо-баннер

Рекламный баннер платформы, который показывается сотрудникам компаний в интерфейсе. Баннеры общие для всей платформы (создаются в админке), а ограничения и журнал показов ведутся по компаниям и пользователям внутри одной записи. Идентификация Содержимое Показ Доступность

Представление баннера

Набор полей баннера, которые отдаются в интерфейс. Наружу уходят только содержательные поля; периодичность, журнал показов, чёрный список и флаг активности остаются внутренними.

Выдача баннера

Возвращает один баннер, который сейчас уместно показать текущему пользователю компании. Берётся первый активный баннер, не попавший в чёрный список компании и либо ещё не показанный этому пользователю, либо показанный раньше, чем указанная периодичность; если подходящего нет — ответ пустой.

Отметка о прочтении баннера

Записывает в журнал показов текущее время для пары «компания — пользователь». Отдельный вызов по номеру баннера; неизвестный номер даёт ошибку «не найдено».

Баннеры в админке

Страница платформенной админки, где создаются и отключаются баннеры. Список показывает заголовок и флаг активности, поиск идёт по заголовку, описанию, промокоду и ссылке.