Проблемы с начислением

Почему не работает?

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

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

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

Алгоритм накопления

Изначально алгоритм Колизея был очень простым, линейным. Раз в два часа парсились активности, заново пересчитывались все баллы и обновлялся виджет исходя из этих данных. Такой подход был простым, понятным, но совсем не эффективным.

Причины, по которым приложение стало более сложным:

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

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

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

4. Спам. Если оставить всё линейно, ваше сообщество будет завалено огромным количеством бессмысленных комментариев. Это отпугнет лояльную аудиторию, навредит климату в сообществе.

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

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

Как обновляются данные?

Лучший способ разобраться почему не работает, это понять как всё устроено.

Обновление виджета

Почему такая опция существует? Почему она не включена по умолчанию? — Всё дело в том, что не всем нужен виджет, ведь балльная система работает и без него, а взаимодействие с пользователем может идти только через «Кабинет пользователя». Также иногда необходимо зафиксировать рейтинг в виджете, но баллы продолжать считать, для чего нужно остановить «Обновление виджета» и оставить включенным «Учет активностей».

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

Учет активностей

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

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

Важные тезисы для понимания:

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

2. Баллы накапливаются и не пересчитываются заново, к примеру, раз в несколько часов, как при парсинге.

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

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

5. Период определяет рамки постов, а не активностей. Выставив период с 1 по 5 число, мы не получим все активности за это время под любыми постами хоть двухлетней давности, а только те, которые были под записями, что публиковались в этот период.

А точно ли всё считается?

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

Почему виджет не обновляется?

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

Виджет и рейтинг — не тоже самое. Уже упомянуто выше, что виджет просто подтягивает данные из рейтинга раз в 10 минут. Сам же рейтинг обновляется от активностей в режиме реального времени, а не по какому-то определенному графику . Рейтинг может обновляться каждую секунду, если активности много, и стоять неизменным часами, если новой активности (подходящей под заданные условия) нет вовсе.

Если же в самом приложении баллы у пользователей одни, а в виджете сообщества другие, тогда проверьте включена ли опция «Обновление виджета», а также попробуйте нажать «Установить виджет» и обновить его во всплывающем окне вручную. Бывает так, что ВК запрещает нам устанавливать виджет до того, как вы это сделаете сами вручную. Также если вы с телефона, ВК может кешировать виджет, при этом все обновляется, но вы не видите новой информации. На ПК в этот момент все хорошо, а вот с телефона данные старые. Нужно просто сбросить кеш, для этого перейдите в любой другой паблик и вернитесь обратно в свой или просто очистите запущенные приложения сбросив оперативную память телефона.

Не работает после удаления/переустановки приложения

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

Почему не были начислены баллы за конкретную активность?

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

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

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

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

Почему начислено слишком много?

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

Не работает после сдвига дат

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

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

Пользователь набрал баллы, но уровень не поднялся

Уровни – это пошаговые квесты с внутренним содержимым. Поэтому повышение уровня происходит в момент посещения пользователем приложения. Если вы видите такую ситуацию, значит участник просто не заходил после того, как набрал достаточно баллов для открытия уровня.

Больше информации об уровнях здесь.