Промокоды в IZI: создание и настройка

Промокоды в IZI: как создать и настроить

Промокоды в IZI — инструмент разового поощрения: игрок вводит уникальный текстовый код в мобильном приложении или на кассе и сразу получает фиксированную сумму на бонусный баланс (виртуальный счёт, с которого можно оплатить часть стоимости сессий и услуг клуба). В отличие от программы бонусов при пополнении, промокод работает без пополнения — достаточно просто ввести код. Каждый промокод живёт внутри промо-кампании: кампания задаёт название, период действия и список клубов, промокоды внутри неё — конкретные коды, суммы и лимиты. Один игрок может активировать один и тот же промокод ровно один раз; повторная попытка заблокируется системой автоматически.

Как промокоды связаны с кампанией

Промокод нельзя создать вне кампании — это намеренное ограничение архитектуры. Кампания выполняет роль контейнера:

• задаёт период действия (даты начала и окончания): промокод не активируется раньше startsAt и после endsAt
• определяет список клубов: если кампания ограничена конкретными клубами, промокоды из неё будут работать только в них
• объединяет промокоды в один отчётный блок: в истории активаций, экспорте CSV и аналитике коды группируются по кампании

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

Поля промокода

Поле	Обязательное	Что задаёт
Код промокода	Да	Уникальная строка (например, SUMMER25). Автоматически приводится к верхнему регистру. Нельзя изменить после создания.
Размер бонусов	Да	Фиксированная сумма в валюте клуба, которая зачисляется на бонусный баланс игрока при активации. Должна быть больше 0.
Максимальное количество использований	Нет	Общий лимит активаций всеми игроками. Если оставить пустым — код можно использовать неограниченное число раз.

Об уникальности кода

IZI проверяет уникальность кода без учёта регистра в пределах организации. Если в организации уже есть активный промокод SUMMER25, создать ещё один summer25 не получится (ошибка «Промокод с таким кодом уже существует в организации»). При этом если старый промокод архивирован — новый с тем же значением создать можно.

Валюта и клубы

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

Создание промокода: пошагово

1. Откройте Организация → Маркетинг → Промо-кампании.
2. Выберите нужную кампанию и перейдите в раздел Промокоды.
3. Нажмите «Новый промокод» — откроется диалог создания.
4. Введите Код промокода — например, WELCOME2025. Код сразу отображается в верхнем регистре.
5. Введите Размер бонусов — сумму в валюте клуба.
6. При необходимости введите Максимальное количество использований. Оставьте пустым для неограниченного числа активаций.
7. Нажмите «Создать».

После создания промокод сразу становится доступным для активации игроками (при условии что кампания активна и текущая дата попадает в период действия).

Что нельзя изменить после создания

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

Статусы и жизненный цикл промокода

В таблице промокодов кампании каждый код отображается с полями:

• Код — текстовое значение
• Кампания — название родительской кампании
• Размер бонусов — сумма в валюте
• Доступно в клубах — «Во всех клубах» или перечень названий
• Использовано / Максимум — текущее число активаций и лимит (или «Без ограничений»)

Статус промокода определяется автоматически:

Ситуация	Что видит игрок при попытке активации
Кампания неактивна	Ошибка: промокод неактивен
Текущая дата раньше startsAt	Ошибка: промокод ещё не начал действовать
Текущая дата позже endsAt	Ошибка: промокод истёк
Клуб не входит в разрешённый список	Ошибка: промокод недоступен в данном клубе
Достигнут лимит активаций	Ошибка: достигнут максимум активаций
Игрок уже активировал этот код	Ошибка: промокод уже активирован этим игроком
Промокод архивирован	Промокод не найден

Архивирование и восстановление

Действие «Архивировать» выполняет мягкое удаление (soft delete): промокод исчезает из активного списка, но все ранее созданные активации сохраняются в истории. Код перестаёт быть доступен игрокам.

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

Просмотр истории активаций

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

• дата и время активации
• клиент (игрок)
• клуб, в котором была активация
• промокод
• начисленная сумма бонуса

Доступна фильтрация по клубу, периоду дат, конкретному промокоду, клиенту и диапазону суммы бонуса. Список можно экспортировать.

Уровень доступа к разделу управляется правами организации PROMO_CAMPAIGN_READ (просмотр) и PROMO_CAMPAIGN_WRITE (создание и редактирование).

Типичные сценарии использования

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

Партнёрский код. Создайте именной код (например, PARTNER_NAME) с лимитом использований. Передайте код партнёру для распространения. В истории активаций можно отфильтровать по этому коду и увидеть, сколько игроков пришло.

Ограниченная акция. Создайте кампанию с endsAt через 7 дней. Промокоды внутри автоматически перестанут работать после истечения срока — не нужно вручную деактивировать каждый.

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

Бонус при пополнении и промокоды — разные инструменты, но оба пополняют один и тот же бонусный баланс игрока. Промокод подходит для разовых акций и партнёрских программ; бонус при пополнении — для систематической программы лояльности на каждое пополнение. В IZI их можно комбинировать без конфликтов.