Описание баннерной системы
Основные понятия и компоненты работы баннерной системы
Сервис баннеров включает в себя три сущности - Banners, Campaigns и Promos.
Баннер (Banners) - это набор контента (ссылка, контент, тайтл и картинка), которые будут отображаться в баннерном слоте у клиента.
Кампания (Campaigns) - это набор баннеров (минимум один), которые связаны между собой (по усмотрению менеджера) и соотношение их выдачи настраивается в кампании. Так например кампания может включать в себя баннера связанные одним БК или одним турниром.
Промо (Promos) - это набор кампаний, связанных между собой (по усмотрению менеджера), в промо кампаниям задаются триггеры (временной период показа) и приоритеты их выдачи. Именно ссылки на промо и находятся на сайтах клиентов и в промо генерируется баннер необходимый к показу исходя из всех условий (триггеры и приоритет кампании, а также ротация баннеров в кампаниях).
Создание баннера (Banners)
Для создания баннера необходимо заполнить несколько полей:
Name- внутреннее имя баннера, оно будет отображаться только в админке, как правило у клиентов формируются шаблоны для названий баннеров, для удобства опознавания их в админке.Url- ссылка зашитая в баннере (та самая ссылка куда будет направлен пользователь кликнув на баннер на сайте клиента).TitleиContent- необязательные к заполнению поля, заполняются клиентом необходимой для него информацией.Status- Active: баннер активен и будет показываться в выдаче / Inactive: баннер неактивен, и не при каких условиях не покажется в выдаче.Images- с помощью кнопки для загрузки картинок (Upload) менеджер может загрузить необходимые картинки (максимальный размер картинки 1MB) и задать им Breakpoint, либо оставить дефолтный.Campaigns- уже на этапе создания баннера его можно привязать к кампании (это не обязательно), достаточно нажать Edit campaigns и из списка кампаний выбрать необходимые (баннер может быть привязан к нескольким кампаниям) и поставить галочки в чекбоксах нужных кампаний.
После заполнения всех полей необходимо нажать кнопку Save, только после этого все указанные изменения применяются.
Для удобства использования - после создания баннера открывается общая страница баннеров, а в правом верхнем углу отображается поп-ап со ссылкой на только что созданный/отредактированный баннер (этот поп-ап также появляется и при создании/редактировании кампаний и промо).
Создание кампании (Campaigns)
Для создания Кампании необходимо указать её внутреннее имя Name, по аналогии с баннерами, Кампании тоже как правило имеют шаблонные названия. Также необходимо указать Status кампании, если кампания Inactive - то все баннера, относящиеся к этой кампании, в выдаче не появятся (это относится именно к кампании, т.е если баннера находятся в других активных кампаниях - то в рамках этих кампаний баннера будут появляться в выдаче).
Banners - с помощью Edit banners менеджер может выбрать набор баннеров, которые будут показываться в рамках создаваемой кампании (т.е в одной кампании может быть несколько баннеров).
После выбора всех необходимых баннеров - они сразу добавляются в таблицу Banners на странице кампании.
В этой таблице есть несколько полей:
Name (название из админки)
Status- для визуализации менеджеру актуального статуса у баннеров кампанииUrlбаннеров,Rotation rate- ротация (проценты показа) баннеров (см. ниже)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).
Предположим, что менеджеру необходимо настроить кастомную выдачу баннеров в Кампаниях (т.к не все баннера должны отображаться равнозначно). Для этого нужно использовать функционал ротации баннеров (Rotation rate).
В таблице Banners, в столбце Rotation rate, необходимо указать значение (целое число) - которое указывает процент выдачи баннера.
Так в примере для Б2 указано кастомное значение ротации (50%), кастомное значение подсвечивается толстой рамкой и его можно сбросить до дефолтного нажав крестик около блока с ротацией. Для остальных баннеров кампании происходит автоматическое равное распределение оставшихся процентов (так на примере для Б1 и Б3 ротация установилась по 25%).
Дефолтное значение не статично и пересчитывается при изменении кастомных значений. Суммарное значение всех полей ротации должно быть 100.
Если кастомное значение установлено “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) в соответствии с ротацией указанной в кампании, так как:
наступил временной триггер по которому она может показываться
у кампании наивысший приоритет (по отношению к другим кампаниям в промо).
Но вне временного периода from 01/10/2022 00:00:33 (GMT+3) to 31/10/2022 00:01:37 (GMT+3) при обращении к промо будут показываться баннера К2 (это баннера Б4 и Б5) в соответствии с ротацией указанной в К2.
Last updated