Skip to main content

Типы событий

Система GMFY позволяет гибко управлять типами событий, поступающих извне или генерируемых внутренними механизмами. Работа с типами событий осуществляется через вкладку «События» административной панели.

Определения​

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

Тип события может быть:

  • Внешним — поступает извне через API от геймифицируемой системы.
  • Внутренним — создается самой системой на основе срабатывания геймификационных условий (достижение рейтинга, получение бейджа и т.д.).

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

Интерфейс управления​

На вкладке «События» события представлены в виде карточек. Каждая карточка отображает:

  • Ключ события
  • Описание (если указано)
  • Пиктограммы включенных опций (уникальность, периодичность, лимит и др.)
  • Информацию о включении события в механики геймификации

В верхней части экрана находятся три вкладки:

  • Активные — события, доступные для использования
  • Архивированные — деактивированные события
  • Неопределённые — события, полученные системой, но не сопоставленные с типами

Создание типа события​

Внешнее событие​

Для создания внешнего события необходимо:

  1. Перейти на вкладку «События»

  2. Нажать кнопку «Создать новый (тип события)»

  3. Заполнить поля:

    • Ключ события (обязательное поле)

    • Описание (опционально)

    • Уникальность по бизнес-ключу — событие обрабатывается только один раз на уникальный businessKey

    • Раз в период — ограничение по периоду: день/неделя/месяц

      • Подопция «без пропусков» включает последовательный счёт

    • Добавить лимит — позволяет автоматически создать внутреннее событие при достижении количества внешних

Внутреннее событие​

При создании внутреннего события указываются:

  • Ключ события (обязательное поле)

  • Нотификация:

    • Текст сообщения пользователю
    • Время жизни (TTL) в секундах

  • Webhook:

    • URL для REST-запроса
    • Заголовки авторизации

Редактирование и удаление​

  • Для редактирования события нажмите на карточку. Откроется окно с деталями и настройками.
  • Все поля, кроме ключа события, доступны для редактирования.

Архивация и активация​

  • Событие можно архивировать или разархивировать через контекстное меню карточки.
  • Архивированные события переносятся во вкладку «Архивированные» и не используются в механиках.
  • Активация также осуществляется из контекстного меню.

Работа с неопределёнными событиями​

  • Если система получает событие, не сопоставленное с типом, оно отображается во вкладке «Неопределённые».

  • Через контекстное меню доступны два действия:

    • Создать тип события на его основе
    • Игнорировать — создается архивный тип события с таким ключом

Детальная информация​

  • При клике на карточку открывается всплывающее окно, содержащее:

    • Полную конфигурацию события
    • Быструю аналитику (график получения, количество обработок)

Ограничения​

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