Бонусна система і фріспіни на рівні платформи

Вступ

Бонуси та фріспіни - центральний інструмент залучення та утримання гравців в онлайн-казино. Реалізація на рівні платформи вимагає гнучкого промо-рушія, точного обліку умов вейджера і окремого обліку «гаманців» для бонусних коштів. У цій статті детально розбираються ключові компоненти і процеси, що забезпечують повноцінну бонусну систему.

1. Архітектура промо-движка

1. Campaign Engine

Зберігає шаблони акцій (депозитні, бездепозитні, фріспіни) у вигляді записів з параметрами: тип бонусу, розмір, вейджер, термін дії, умови відіграшу.

Обробляє тригери: події «first\_ deposit», «session\_ start», «custom\_ event» (наприклад, досягнення turnover).

2. Workflow-сервіс

Моделює стан акції по користувачеві: `initiated` → `granted` → `in_wager` → `completed/expired`.

Дозволяє «гаряче» змінювати логіку через конфігурацію без деплоя коду.

2. Структура «гаманців» та облік балансу

1. Окремі гаманці

Real Wallet: реальні гроші гравця.

Bonus Wallet: нараховані бонуси і фріспіни, заблоковані до виконання умов вейджера.

2. Резервування коштів

При активації бонусу сума резервується на Bonus Wallet, недоступна для виведення, але бере участь у ставках.

3. Партіонування ставок

При кожній ставці платформа списує спочатку з Real Wallet, потім автоматично з Bonus Wallet по заданому порядку (configurable).

3. Умови вейджера і відіграш

1. Параметри вейджера

Коефіцієнт ('wager _ multiplier'), мінімальна і максимальна ставка при відіграші, виключені ігри.

2. Облік ставок

Ведеться лічильник необхідного обороту:

remaining_wager = wager_multiplier bonus_amount
on each spin:
if game_id not in excluded:
remaining_wager -= bet_amount

3. Тайм-аути і термін дії

Кожна акція має'valid _ from'і'valid _ to'для старту активації і автоматичного скасування невиконаного бонусу.

4. Фріспіни: механіка та інтеграція

1. Набір безкоштовних обертань

Зберігається в окремій сутності'freespin _ package'з кількістю, ставкою за замовчуванням і списком ігор.

2. Окремий лічильник

Клієнт отримує число «free\_ spins\_ remaining» і «free\_ spin\_ bet\_ amount».

3. Віддача результату

Результат фріспіна (виграш) спочатку йде в Bonus Wallet, підпорядкований вейджер-умовам (зазвичай lower multiplier).

4. API-взаємодія з движком

При старті кожного фриспіна движок запитує '/spin? mode=freespin&bet=…`; платформа повертає'session _ id','bet _ amount'і'remaining _ spins'.

5. Тригерні сценарії активації

Перший депозит: auto-grant при спрацьовуванні події'first _ deposit _ success'.

Re-engagement: після періоду бездіяльності ('inactive _ days> N') автоматично відправляється оффер фриспінів.

VIP-рівні: по досягненні turnover або депозиту вище порогу - персоналізовані бонуси.

6. Безпека та захист від зловживань

1. Антифрод-модулі

Перевірка мультиаккаунтингу, гео-блокування по IP, Device Fingerprinting.

2. Limit Checks

Обмеження максимального бонусу на IP/профіль, мінімальної середньої ставки в режимі відіграшу.

3. Audit Trail

Запис всіх операцій з бонусами і фриспінами в immutable логи з user\_ id, timestamp і операцією.

7. Моніторинг та звітність

1. Ключові метрики

`bonuses_granted_total`, `bonuses_redeemed_total`, `freespins_used`, `average_wager_completion_rate`.

2. Дашборди

У Grafana або BI: динаміка активацій бонусів по кампаніях, CR відіграшу, вплив на ARPU.

3. Експорт звітів

Автоматичне вивантаження CSV/PDF для маркетингу та фінансового відділу.

8. Інтеграція з CI/CD і TMS

Конфігурація промо-рушія як код: зберігання YAML/JSON-шаблонів акцій в репозиторії, автоматичний deploy через GitOps.

Використання TMS (Lokalise, Crowdin): для перекладу назв акцій і текстів опису без втручання розробників.

Висновок

Платформна бонусна система і механіка фріспінів вимагають чіткого розділення гаманців, гнучких workflow-рушіїв, точного обліку вейджера і захищеності від шахрайства. Правильно налаштовані тригери, звітність і архітектура «промо-рушія як код» забезпечують швидкий запуск нових акцій, прозорість розрахунків і зростання ключових показників утримання і LTV.

Caswino Promo