Sistema de puntos

Configura y usa el sistema de puntos canjeables.

Los puntos son una moneda virtual que tus usuarios ganan y gastan. Son independientes del sistema de XP (que es permanente y determina niveles).

PuntosXP
Se gastanSiNo
Determinan nivelNoSi
Se pueden perderSi (al gastar)No

Configuracion

  1. Ve a Puntos en la consola
  2. Activa el sistema de puntos
  3. Configura:
    • Nombre de la moneda — ej: "Monedas", "Estrellas"
    • Reglas de ganancia — cuantos puntos se otorgan por accion

Reglas de ganancia

AccionDescripcion
game_playJugar cualquier juego
game_winGanar un juego
code_redeemCanjear un codigo
customEvento custom (especifica eventName)

Cada regla tiene:

  • Cantidad — puntos a otorgar
  • Cooldown (opcional) — tiempo minimo entre otorgamientos
  • Cap diario (opcional) — maximo de veces por dia

Flujo tipico

Usuario juega → Gana juego → Recibe puntos + codigo
                                    ↓
              Canjea puntos por recompensa
                                    ↓
              Se descuentan puntos del saldo

Recompensas

Las recompensas son items que los usuarios pueden canjear con sus puntos:

  1. Ve a Recompensas en la consola
  2. Crea una recompensa con:
    • Nombre y descripcion
    • Costo en puntos
    • Stock (opcional)
    • Tipo de descuento y valor

Al canjear, se genera un codigo promo automaticamente.

SDK

// Consultar saldo
final balance = await SouthGamesSDK.getPointsBalance(
  externalUserId: 'user_123',
);

// Gastar
await SouthGamesSDK.spendPoints(
  externalUserId: 'user_123',
  amount: 100,
  reason: 'Canje por descuento',
);

Ver la referencia completa del SDK.