Пошаговая настройка

Данное руководство определяет пошаговую настройку балльной системы и установку виджета. Настройка более широкого функционала описана в отдельных соответствующих разделах.

Шаг 1: Условия начисления

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

Идем в раздел «Настройки» → «Условия начисления», активируем или наоборот отключаем ненужные активности используя ползунок, выставляем свое количество баллов, параметров. По умолчанию уже есть выставленные настройки, можем просто оставить их.

Не забываем нажать «Сохранить».

Шаг 2: Основные настройки системы

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

Название баллов

Изменяем название баллов, если нужно задать какое-то свое. Здесь требуется указать четыре формы в разных падежах через запятую. Мы используем это название в ценах на товары, виджете и много еще где.

Период

Выставляем период проведения. По умолчанию стоит «Бессрочно», это означает, что приложение будет накапливать баллы столько, сколько это потребуется без ограничений по периоду. Если же мы выставим какие-то даты, то учет активностей начнется с первого числа по последнее. Достигнув окончания периода учет прекратится для новых постов.

Даты представлены включительно. Выставив с 1 по 7, мы получаем период с 1 числа 00:00 часов до 7 числа 23:59 по местному времени.

Сдвиг дат и обнуление

«Автозапуск на такой же период» — опция «вечнозеленого» конкурса. Выставив период и включив опцию, произойдет следующее: в 00:00 по местному времени после окончания периода алгоритм переставит даты на такой же период вперед, обнулит рейтинг и накопление баллов начнется с нуля.

Только новые посты

Ограничение по последним постам. Чтобы не давать баллы за старые посты, существует такая опция. Она гарантирует, что пользователи будут получать баллы только за активности под новыми постами и не будет ситуации, когда какой-то участник в последний день конкурса пролайкает сотни старых постов и вырвется в лидеры.

Не забываем нажать «Сохранить».

Шаг 3: Подсчитать за прошедший период

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

В большинстве случаев этого достаточно, однако иногда все же требуется учесть и прошлые активности. Чтобы всё же решить этот вопрос и учесть прошлые лайки и комментарии, была создана опция «Подсчет за прошедший период». Она доступна на месте рейтинга, когда он еще не сформирован. Алгоритм работает через парсинг, за счет чего вы можете подсчитать баллы по старым активностям.

Выбираем за какое количество дней собрать данные и запускаем. Учтите, что опция сканирует только стену сообщества, поэтому комментарии под товарами, в обсуждениях, а также вступления не будут найдены.

Шаг 4: Передача разрешений

Как и упоминалось выше, приложение слушает события активностей сообщества. Для этого ему нужно подключить специальный «колбэк-сервер» в вашу группу. Сделать это можно только получив разрешение от администратора. Такая же ситуация из подключением бота, рассылками, обновлением виджета.

Мы создали отдельный раздел, где показаны все ваши переданные разрешения. Обычно приложение запрашивает права сразу при попытке включить опцию, но иногда требуется передавать их явно, о чем вас попросит всплывающая подсказка.

Идем в раздел «Разрешения» и нажимаем на «Передать» или «Обновить».

Шаг 5: Включение учета активностей

Получив от вас разрешения теперь приложение может подключить колбэк-сервер для прослушивания событий активностей сообщества.

За это отвечает опция «Учет активностей». Включаем ползунок и теперь активности будут учитываться по заданным условиям в режиме реального времени. Отслеживать начисления, а также проверять корректность работы вы можете в разделе «Арена» → «История», где будет показана таблица с активностью пользователей, сколько и за что именно начислено баллы с возможностью перехода на эту активность.

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

Настроить кабинет пользователя можно в разделе «Настройки» → «Кабинет пользователя». Подробнее здесь.

Шаг 6: Установка виджета

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

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

Идем в раздел «Настройки» → «Виджет». Выбираем нужный тип, задаем настройки.

Не забываем нажать «Сохранить».

После идем в раздел «Арена», включаем «Обновление виджета» (можно выключать потом, когда нужно продолжить учитывать активность, но требуется какое-то время показывать старый рейтинг). При включении опции у вас должно появится окно подтверждения установки виджета. Если вы не подтвердите, ВКонтакте может не дать нам со стороны сервера обновлять виджет.

Если окна не было или вы перебили наш виджет каким-то другим от иного приложения (в сообществе может быть только один виджет), тогда нажимаем «Установить виджет».

Видимость виджета приложения

Если у вас не получилось настроить приложение, напишите нам в сообщения сообщества.