Описание баннерной системы

Основные понятия и компоненты работы баннерной системы

Сервис баннеров включает в себя три сущности - Banners, Campaigns и Promos.

Баннер (Banners) - это набор контента (ссылка, контент, тайтл и картинка), которые будут отображаться в баннерном слоте у клиента.

Кампания (Campaigns) - это набор баннеров (минимум один), которые связаны между собой (по усмотрению менеджера) и соотношение их выдачи настраивается в кампании. Так например кампания может включать в себя баннера связанные одним БК или одним турниром.

Промо (Promos) - это набор кампаний, связанных между собой (по усмотрению менеджера), в промо кампаниям задаются триггеры (временной период показа) и приоритеты их выдачи. Именно ссылки на промо и находятся на сайтах клиентов и в промо генерируется баннер необходимый к показу исходя из всех условий (триггеры и приоритет кампании, а также ротация баннеров в кампаниях).

Создание баннера (Banners)

Для создания баннера необходимо заполнить несколько полей:

1. Name - внутреннее имя баннера, оно будет отображаться только в админке, как правило у клиентов формируются шаблоны для названий баннеров, для удобства опознавания их в админке.

2. Url - ссылка зашитая в баннере (та самая ссылка куда будет направлен пользователь кликнув на баннер на сайте клиента).

3. Title и Content - необязательные к заполнению поля, заполняются клиентом необходимой для него информацией.

4. Status - Active: баннер активен и будет показываться в выдаче / Inactive: баннер неактивен, и не при каких условиях не покажется в выдаче.

5. Images - с помощью кнопки для загрузки картинок (Upload) менеджер может загрузить необходимые картинки (максимальный размер картинки 1MB) и задать им Breakpoint, либо оставить дефолтный.

6. Campaigns - уже на этапе создания баннера его можно привязать к кампании (это не обязательно), достаточно нажать Edit campaigns и из списка кампаний выбрать необходимые (баннер может быть привязан к нескольким кампаниям) и поставить галочки в чекбоксах нужных кампаний.

Создание нового баннера

После заполнения всех полей необходимо нажать кнопку Save, только после этого все указанные изменения применяются.

Для удобства использования - после создания баннера открывается общая страница баннеров, а в правом верхнем углу отображается поп-ап со ссылкой на только что созданный/отредактированный баннер (этот поп-ап также появляется и при создании/редактировании кампаний и промо).

Создание кампании (Campaigns)

Для создания Кампании необходимо указать её внутреннее имя Name, по аналогии с баннерами, Кампании тоже как правило имеют шаблонные названия. Также необходимо указать Status кампании, если кампания Inactive - то все баннера, относящиеся к этой кампании, в выдаче не появятся (это относится именно к кампании, т.е если баннера находятся в других активных кампаниях - то в рамках этих кампаний баннера будут появляться в выдаче).

Banners - с помощью Edit banners менеджер может выбрать набор баннеров, которые будут показываться в рамках создаваемой кампании (т.е в одной кампании может быть несколько баннеров).

После выбора всех необходимых баннеров - они сразу добавляются в таблицу Banners на странице кампании.

В этой таблице есть несколько полей:

1. Name (название из админки)

2. Status - для визуализации менеджеру актуального статуса у баннеров кампании

3. Url баннеров, Rotation rate - ротация (проценты показа) баннеров (см. ниже)

4. Actions (столбец), который позволяет удалить сразу из таблицы не нужный для кампании баннер.

Создание новой Кампании

Особености параметра Rotation Rate

Rotation rate - это функционал ротации баннеров, или процент их выдачи относительно кампании. Как это работает:

Если в Кампании несколько баннеров - менеджер может распределить проценты их выдачи при обращении к этой кампании.

Предположим, что в нашей кампании добавлено три баннера (Б1, Б2 и Б3). И если менеджеру необходимо задать выдачу Б1 в 50% случаев - то ему достаточно указать “50” в поле ротации напротив нужного баннера (в нашем примере напротив Б1). таким образом Б1 приобретает кастомное значение ротации 50, а так как суммарное количество процентов должно быть равно 100, то два остальных баннера (без кастомного значения) автоматически разделят поровну оставшиеся проценты (Б2 - 25% и Б3 - 25%), но при необходимости можно задать кастомные значения у каждого из баннеров, но сумма ротации всех баннеров не должна превышать значение 100.

Изменение параметра ротации баннера

Уже на этапе создания Кампании её можно привязать к Промо (это не обязательно), достаточно нажать Edit promos из списка промо выбрать необходимые (Кампания может быть привязана к нескольким Промо) и поставить галочки в чекбоксах нужных Промо.

Привязка Кампании к Промо

Создание промо (Promos)

Для создания промо, необходимо как и в прошлых блоках сервиса - указать внутреннее имя Name. А также выбрать список Кампаний, которые будут выдаваться в рамках создаваемого промо. После выбора всех необходимых кампаний - они сразу добавляются в таблицу Campaigns на странице промо. В этой таблице есть несколько полей: Name (название из админки),

Создание Промо

Priority - приоритет кампании в выдаче (чем ниже числовое значение - тем выше приоритет), Trigger body - триггер для выдачи кампании - это временной промежуток задаваемый менеджером.

К примеру:

scheduled-between from 06/10/2022 12:00:22 (GMT+3) to 30/10/2022 01:05:25 (GMT+3)

будет означать, что Кампания будет появляться в выдаче в период между 06.10 по 30.10, и столбец Actions, который позволяет удалить сразу из таблицы ненужную для Промо кампанию или отредактировать её триггер.

Редактирование приоритетов Кампаний

Пример использования сервиса

Предположим менеджеру необходимо в слоте для баннеров на сайте отображать две кампании, одну постоянную и одну в определенный промежуток времени (например в период проведения какого либо турнира).

Менеджер заводит Кампанию 1 (К1) в которой будет три баннера (Б1, Б2 и Б3), и Кампанию 2 (К2) с баннерами (Б4 и Б5).

Тестовая Камания 1

Тестовая Кампания 2

Предположим, что менеджеру необходимо настроить кастомную выдачу баннеров в Кампаниях (т.к не все баннера должны отображаться равнозначно). Для этого нужно использовать функционал ротации баннеров (Rotation rate).

В таблице Banners, в столбце Rotation rate, необходимо указать значение (целое число) - которое указывает процент выдачи баннера.

Указание параметра Rotation Rate

Так в примере для Б2 указано кастомное значение ротации (50%), кастомное значение подсвечивается толстой рамкой и его можно сбросить до дефолтного нажав крестик около блока с ротацией. Для остальных баннеров кампании происходит автоматическое равное распределение оставшихся процентов (так на примере для Б1 и Б3 ротация установилась по 25%).

Дефолтное значение не статично и пересчитывается при изменении кастомных значений. Суммарное значение всех полей ротации должно быть 100.

Изменение Rotation Rate

Если кастомное значение установлено “0” - то это вывод из ротации и баннер не будет показываться в выдаче (в примере это Б3). Также работает и при указании 100% ротации для одного баннера - т.е во всех обращениях к кампании будет показываться только этот баннер.

Следующим шагом менеджер создает Промо и добавляет в него две нужные кампании.

Создание Промо

Предположим что в К1 баннера связаны с определенным событием и должны отображаться в определенный промежуток времени, для этого в промо для кампаний добавлена возможность указания триггера (это временной период в который кампания будет отображаться в промо.

Данные о приориете Кампании

Так как на примере с помощью кнопки Update trigger менеджер может задать временной период отображении кампании. К1 в примере будет отображаться в период с 1 октября по 31 октября. Но для того чтобы определить какую кампанию из двух (например с 01.10 по 31.10 в примере к показу доступны обе кампании) отображать у менеджера есть возможность задать приоритет для кампаний. Это значение от 0 до 99 с помощью которого и определяются приоритетные к выдаче кампании.

Кампании без триггера всегда должны быть ниже приоритетом, чем кампании с триггером - т.к в обратном случае - кампания с триггером никогда не будет доступна к показу.

Корректное распределение триггеров

Пример корректного распределения триггеров и приоритетов указан на скрине. При таких настройках промо поведение будет следующим:

В период from 01/10/2022 00:00:33 (GMT+3) to 31/10/2022 00:01:37 (GMT+3) при обращении к промо будут показываться баннера К1 (это баннера Б1, Б2 и Б3) в соответствии с ротацией указанной в кампании, так как:

1. наступил временной триггер по которому она может показываться

2. у кампании наивысший приоритет (по отношению к другим кампаниям в промо).

Но вне временного периода from 01/10/2022 00:00:33 (GMT+3) to 31/10/2022 00:01:37 (GMT+3) при обращении к промо будут показываться баннера К2 (это баннера Б4 и Б5) в соответствии с ротацией указанной в К2.

Гайд для баннерной системы