Интеграция основного продукта с заданиями QuickPass

Что такое задания QuickPass

Задания - это способ мотивировать пользователей активнее пользоваться основным продуктом. Пользователь видит задание типа "Сделай 5 ставок на сумму от 100 рублей за день", выполняет его и получает награду.

Принцип работы

1. Пользователь делает привычные действия в основном продукте (ставки, спины, игры)
2. Основной продукт отправляет событие в QuickPass в виде структурированного объекта (json, protobuf, ...)
3. QuickPass проверяет: есть ли у пользователя подходящие задания
4. Если есть - засчитывает прогресс, если задание выполнено - выдаёт награду
5. Пользователь видит прогресс и получает мотивацию продолжать играть

Что видит пользователь

В интерфейсе заданий

• Список доступных заданий с описанием и наградами
• Прогресс выполнения (например, "3 из 5 ставок сделано")
• Оставшееся время до окончания задания
• Полученные награды

Пример задания

"Сделай 5 ставок на сумму от 100 рублей за день"

• Пользователь активирует задание
• При каждой ставке ≥100 рублей основной продукт отправляет событие в QuickPass
• QuickPass засчитывает прогресс: 1/5, 2/5, 3/5, 4/5
• После 5-й ставки задание завершается, пользователь получает награду

Что нужно от команды основного продукта

Минимальные требования

1. Определить события - какие действия пользователей нужно отслеживать
2. Настроить отправку данных - при каждом событии отправлять в QuickPass структурированный объект
3. Согласовать награды - если планируется выдавать монеты/бонусы основного продукта через задания

Техническая реализация передачи данных

Формат события:

{
  "user_id": "12345",
  "event_type": "bet_placed",
  "timestamp": "2024-01-15T14:30:00Z",
  "amount": 250.00,
  "currency": "RUB",
  "game_type": "roulette",
  "outcome": "win",
  "bet_type": "red"
}

Способы передачи:

• REST API - HTTP POST запросы с JSON объектами
• Брокер сообщений - Kafka/RabbitMQ для высоконагруженных систем
• Webhook - для событий в реальном времени

Когда отправлять:

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

Типы событий, которые можно отслеживать на основном продукте

Игровые действия

• Ставки: размещение, выигрыш, проигрыш
• Рулетка: спины, выигрыши, конкретные типы ставок
• Слоты: игры, выигрыши, крупные выплаты
• Карточные игры: партии, победы, достижения
• и т.п.

Финансовые операции

• Депозиты: пополнения счёта
• Выводы: запросы на вывод средств
• Бонусы: активация промокодов

Социальные действия

• Профиль: заполнение, обновление данных
• Рефералы: приглашение друзей
• Активность: ежедневные заходы

Как QuickPass обрабатывает события

Что происходит при получении события

1. Проверка пользователя - есть ли он в системе QuickPass
2. Поиск активных заданий - какие задания у него запущены
3. Валидация условий - подходит ли событие под требования задания
4. Обновление прогресса - засчитывание выполненного действия
5. Проверка завершения - выполнено ли задание полностью
6. Выдача наград - начисление монет, предметов, бонусов

Правила засчитывания

• Засчитываются только действия после активации задания
• Если у задания есть минимальная сумма - меньшие ставки не считаются
• Повторные события (дубли) игнорируются
• Учитываются временные рамки (день/неделя/месяц)

Обработка наград основного продукта

Когда задание завершается и включает награду основного продукта:

1. QuickPass отправляет запрос на начисление:

{
  "user_id": "12345",
  "reward_type": "bonus_coins",
  "amount": 100,
  "task_id": 123,
  "reason": "Task completion reward"
}

2. Основной продукт обрабатывает запрос:

   • Проверяет существование пользователя
   • Начисляет бонус
   • Логирует операцию

3. Ответ QuickPass:

{
  "success": true,
  "transaction_id": "tx_789",
  "new_balance": 1500 // при необходимости
}

4. QuickPass уведомляет пользователя о полученных наградах

Аналитика и метрики

Ключевые показатели

• Процент пользователей, активирующих задания
• Среднее количество выполненных заданий на пользователя
• Влияние заданий на частоту игр и размер ставок
• Retention rate пользователей с активными заданиями
• Конверсия новичков через цепочки заданий

Мониторинг интеграции

• Количество обработанных событий в секунду
• Процент успешных доставок событий
• Время отклика QuickPass API
• Количество ошибок валидации событий