Активации промокодов в IZI

Активации промокодов: полная история использования в сети клубов

Раздел «Активации промокодов» в IZI CRM — это журнал всех случаев, когда игроки вашей сети использовали промокоды. Каждая запись фиксирует дату активации, клиента (игрока), клуб, в котором произошла активация, промокод и сумму начисленного бонуса. Раздел работает на уровне организации: данные со всех клубов сети видны в едином списке, который можно фильтровать и экспортировать. Активации создаются автоматически — когда игрок вводит код через мобильное приложение или на кассе, система проверяет валидность кода (активна ли промо-кампания, не истёк ли срок, доступен ли код в данном клубе, не был ли этот код уже использован этим игроком) и при успехе мгновенно зачисляет бонус на баланс клиента с атрибуцией к конкретной активации.

Что фиксируется в каждой записи

Когда игрок успешно активирует промокод, в системе создаётся запись со следующими полями:

Поле в CRM	Что содержит
Дата активации	Точная дата и время события
Клиент	Имя и фамилия игрока, кликабельно до карточки клиента
Клуб	Клуб, где была совершена активация
Промокод	Строка кода; кликабельно до карточки промокода внутри кампании
Бонус	Сумма, зачисленная на баланс клиента в момент активации

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

Механика активации

Понимание того, что происходит «под капотом», помогает правильно интерпретировать данные в таблице.

Последовательность событий

1. Игрок вводит код в приложении или на кассе.
2. Система находит промокод в базе по строке кода и организации клуба.
3. Проверяется кампания: активна ли, не начнётся ли позже, не закончилась ли.
4. Проверяется клуб: если у промокода указан список клубов — текущий клуб должен быть в нём.
5. Проверяется уникальность: пара «этот промокод + этот игрок» не должна существовать. Один игрок не может активировать один и тот же код дважды.
6. Проверяется лимит: если у промокода задан maxActivations, счётчик использований (usedCount) должен быть меньше лимита.
7. Если все проверки пройдены — атомарно создаётся запись активации и начисляется бонус на баланс.
8. Если начисление бонуса не удалось — активация откатывается, запись не создаётся.

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

Ошибки активации

Неудачные попытки не попадают в журнал активаций — они не создают запись. Возможные причины отклонения:

• Промокод не найден в организации
• Промо-кампания заархивирована или неактивна
• Срок действия кампании ещё не наступил или уже истёк
• Промокод недоступен в этом клубе
• Игрок уже использовал этот промокод
• Лимит активаций исчерпан

Если клиент жалуется, что код «не сработал», но в журнале активации нет — это нормально: одна из проверок выше не прошла.

Как работают фильтры и экспорт

Доступные фильтры

В верхней части раздела расположена панель фильтров. Можно комбинировать любое количество условий:

Фильтр	Назначение
От / До	Период активации по дате
Клиент	Фильтр по конкретному игроку
Все промокоды	Выбор одного промокода для детального анализа
Клубы	Ограничить выборку одним или несколькими клубами сети
Сумма бонуса	Диапазон суммы начисленного бонуса (от/до)

Типичные сценарии фильтрации

Анализ конкретной акции. Откройте промо-кампанию, выберите нужный промокод в фильтре — и увидите всех клиентов, которые его использовали, с датами и клубами.

Разбор обращения клиента. Установите фильтр «Клиент» → найдите нужного игрока → увидите всю его историю активаций. Это позволяет быстро подтвердить или опровергнуть слова клиента.

Контроль по клубу. Если нужно понять, как работают промокоды в конкретной точке сети, отфильтруйте по клубу и периоду. Можно сравнить активность между клубами.

Поиск аномалий. Фильтр «Сумма бонуса» позволяет найти активации с нетипично высоким бонусом — например, если промокод с большим номиналом был случайно распространён шире запланированного.

Экспорт

Кнопка «Экспорт» в правом верхнем углу выгружает все записи, попадающие под активный фильтр. Если фильтры не установлены — выгружается полная история. Экспорт удобен для:

• Передачи данных в Excel для финансового учёта
• Построения отчётов по эффективности акций
• Сверки с внешними системами лояльности
• Передачи данных маркетинговой команде

Права доступа

Раздел «Активации промокодов» доступен пользователям CRM с правом организации PROMO_CAMPAIGN_READ. Редактирование промокодов и кампаний требует дополнительного права PROMO_CAMPAIGN_WRITE. Оба права настраиваются в ролях пользователей на уровне организации.

Связь с другими разделами

Активации — это итог работы промо-кампаний. Полная цепочка в IZI выглядит так:

1. Промо-кампании — контейнер с настройками: название, период, список клубов, статус активности.
2. Промокоды — конкретные коды внутри кампании, каждый с суммой бонуса и опциональным лимитом активаций.
3. Активации (эта страница) — журнал фактических использований: кто, когда, где и какой код активировал.

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