Campanas

Como crear y gestionar campanas de gamificacion.

Las campanas son el nucleo de SouthGames. Cada campana combina un juego con reglas de premios, fechas y segmentacion.

Crear una campana

1. Ve a Campanas en la consola
2. Haz clic en "Crear campana"
3. Configura:
   • Nombre — identifica la campana
   • Tipo de juego — spin wheel, scratch card, trivia, slot machine, o un juego del marketplace
   • Fechas — inicio y fin
   • Premios — configuracion de probabilidades y descuentos

Tipos de juego

Spin Wheel (Ruleta)

Configura segmentos con probabilidades y premios. Cada segmento puede ser ganador o perdedor.

Scratch Card (Raspadita)

El usuario raspa una tarjeta para revelar si gano. Configura la probabilidad de ganar.

Trivia

Preguntas con opciones multiples. El usuario gana si responde correctamente sobre un umbral.

Slot Machine (Tragamonedas)

Columnas con simbolos. Gana al obtener combinaciones ganadoras.

Marketplace

Juegos HTML5 de terceros instalados desde el marketplace. Se ejecutan en WebView.

Ciclo de vida

Codigos promocionales

Cuando un usuario gana, se genera automaticamente un codigo promo con:

• Tipo de descuento (porcentaje o monto fijo)
• Valor del descuento
• Usos maximos
• Fecha de expiracion (hereda de la campana)

Integracion

// 1. Listar campanas activas
final campaigns = await SouthGamesSDK.getCampaigns();

// 2. Mostrar al usuario y dejar que elija

// 3. Jugar
final play = await SouthGamesSDK.play(
  campaignId: campaigns.first.id,
  externalUserId: 'user_123',
);

// 4. Si gano, canjear
if (play.won && play.prizeCode != null) {
  final redeem = await SouthGamesSDK.redeem(code: play.prizeCode!);
  // Aplicar descuento en tu sistema
}