Integración de misiones con sistema de bonificación y CRM

Las misiones sólo funcionan cuando la recompensa se otorga previsiblemente y la comunicación lleva al jugador de paso a paso. Por lo tanto, el núcleo es un ligamento del Motor de Misión ↔ Bonus/Wallet ↔ CRM/CDP, más RG/KYC y antifraude. A continuación, un esquema de integración listo con plantillas de datos y prácticas probadas.

1) Objetivos de integración

Crecimiento del compromiso y ARPPU (net): misiones → progreso → recompensas → repeticiones de sesiones/depósitos.

Control de margen: presupuesto-pools, caps, «valor del bono» en activo/pagador.

Personalización: misiones y premios por segmento CRM/CDP.

Cumplimiento: KYC/RG-gates, geo-reglas, auditoría.

Medida: A/B, post-efecto, canibalización.

2) Arquitectura de flujo

1. Event Ingest: `bet`, `win`, `deposit`, `mission_progress`, `mission_complete`.

2. Motor de misión: verificación de condiciones, puntuación/estado, desencadenantes de recompensas.

3. Reward Orchestrator: presupuesto-cheque, RG/KYC, creación de 'reward _ task'.

4. Bonus/Wallet: caché, bonus cache (vager), giros gratis, cupones; webhooks/SDK.

5. CRM/CDP: segmentos, campañas de activación, límites de frecuencia, hojas de suppression.

6. Analytics/DWH: eventos crudos, vitrinas, aumento, dashboards.

7. Anti-Fraud & RG: caps, heurísticas/ML, hold-and-review.

3) Modelo de datos y eventos

Eventos (mínimo):

`mission_view / join / progress / complete`
`points_awarded {rule_id, amount, caps}`
`reward_task. created / succeeded / failed / held`
`wallet_credit / bonus_issued / freespins_issued`
`kyc_status_changed / rg_event`
`crm_send / crm_open / crm_click / crm_unsub`

Ejemplo de 'mission _ complete':

json
{
"event": "mission_complete",  "ts": "2025-10-24T10:17:12Z",  "user": {"id":"u_123", "geo":"TR", "platform":"ios", "payer_flag":true},  "mission": {"id":"m_4521", "type":"turnover", "segment":"mid_core"},  "progress": {"value": 1000, "window":"2025-10-24"},  "context": {"session_id":"s_778"}
}

4) Mapa de premios: misiones → sistema de bonificación

Tipo de misión	Premio básico	Restricciones/banderas
Volumen de negocios/tasas	Bonus caché € x	`wagering=10–20`, `expiry=72h`
Ganar/multiplicar. Friends N por juego	Juego/proveedor, apuesta, plazo, geo-restricciones
Depósito	Caché/caché sin conductor	KYC L2 +, límites de RG
Cadena T1...Tn	Recompensas de botín (tipos/rareza)	Porcentaje de «raros», presupuesto-cap
Acción social	Cupones/FS	En las jurisdicciones en las que se permite

Regla de selección: misiones masivas - recompensas de bajo costo (FS/bonus cache), «finishers «/cadenas profundas - parte de una caché sin conductor para la confianza.

5) Reward Orchestrator: presupuesto, RG/KYC, idempotencia

Idempotencia: clave 'reward _ task _ id' + 'X-Request-Id' para llamadas externas.

Presupuestos: grupos 'season _ sprint', 'onboarding', 'reenvío'; soft/hard cap; circuit-breaker 90%.

KYC/RG-gates: caché> € X - sólo L2 +, con 'cool _ off' de recompensa activa en 'held'.

Auditoría: registro WORM de cuerpos salientes.

Ejemplo 'reward _ task. created`:

json
{
"type":"reward_task. created",  "reward_task_id":"rt_9a7",  "user_id":"u_123",  "origin":{"mission_id":"m_4521","threshold":"final"},  "reward":{"type":"bonus_cash","amount":5,"currency":"EUR","wagering":15,"expiry":"2025-10-27T00:00:00Z"},  "pool_id":"season_sprint",  "status":"pending"
}

6) Integración con monedero/servicio de bonificación

Webhook saliente (ejemplo):


POST /wallet/bonus. issue
X-Request-Id: rid_7f5...
X-Timestamp: 1730061700
X-Signature: sha256=...

{
"user_id":"u_123",  "bonus": {"type":"bonus_cash","amount":5,"currency":"EUR","wagering":15,"expiry":"2025-10-27T00:00:00Z"},  "reason":"mission:m_4521"
}

La respuesta del socio es: '200 {"bonus_id":"b_331", "status ":" issued"} '→ 'reward _ task. succeeded`.

Errores de 5xx → retrés con el mismo 'X-Request-Id'; 4xx → DLQ + mecanizado manual.

7) Ligamento con CRM/CDP

7. 1. Segmentación

Escenario: D0-D7 (onboarding), R7-R30 (re-engage), Core P30.

Monetización: no válido/NPP/RPP/alto valor.

Comportamiento: los finalistas de T1/T2/T3, «atrapados», «casi-alcanzado».

Riesgo: banderas RG, estado KYC.

7. 2. Desencadenantes de campañas

On-mission: «quedan 120 puntos», «+ 2 posiciones» - in-app/push.

Post-misión: «el bono se activa/expira en 12 horas».

Winback: no comenzó la misión de 48 h → una oferta personal (si se permite).

Suppression: con 'cool _ off '/self-exclusion no promo.

7. 3. Reglas de frecuencia

Max 1 push/4 h, 1 email/24 h por misión; capping a través del canal y en general.

Quiet hours por hora local, doble opt-in/out.

8) Datos de pipeline en CRM

El escaparate de CDP 'mission _ funnel _ daily':

`eligible`, `viewed`, `joined`, `started`, `t1..tn`, `completed`, `rewarded`.
Los tiempos antes de T1/T2/...; estado de bonificación; 'costo _ eur'; 'net _ arppu'.

Ejemplo de descarga en un segmento «casi alcanzado»:

sql
SELECT user_id
FROM mission_funnel_daily
WHERE mission_id =:m
AND started = true
AND completed = false
AND points_to_next <= 150
AND last_seen_at > now() - interval '24 hour'
AND rg_ok = true;

9) Antifraude y «fair play»

Caps: puntos/apuesta, puntos/min/hora/día; Límite de microprocesadores repetitivos.

Esas señales son: headless, proxy, duplicados 'device _ fp'.

Filtros de comportamiento: variación mínima de las apuestas; patrones «perfectos» → hold.

Premios:> € X y los primeros puestos - entrega aplazada a KYC.

Restricciones de CRM: no estimular a los «agricultores de gafas»; suppression по fraud-score.

10) Economía de recompensas y control de márgenes

Indicadores clave:

`Prize & Bonus Cost per Active` / `per Payor`
`ΔARPPU (net)` = ARPPU − (Prize+Bonus per payor)
'Net Uplift' = Ingresos incrementales − Valor (premios + operaciones + frodo)

Presupuesto-seguimiento (sketch):

sql
SELECT pool_id,    SUM(value) AS spent,    MAX(budget) AS limit,    SUM(value)/MAX(budget) AS fill
FROM reward_ledger
WHERE date(created_at)=current_date
GROUP BY pool_id;

11) Pruebas de integración A/B

Unidad: usuario, sticky-assignment, estratificación (payer/geo/plataforma).

Primary: participation_net, completion, `ΔARPPU (net)`.

Guardrails: quejas/1k, fraud-flags, RG-activación, alertas SRM.

CUPED: pre-valor (ARPPU/puntos de la semana pasada) para reducir la varianza.

Interferencia: tablas de liderazgo separadas/normalización de puntos.

12) Patrones UX que «tejen» misiones, bonos y CRM

Una pantalla es un objetivo: reglas claras, progreso visible.

Retroalimentación inmediata: «+ 10 puntos» y una etiqueta de progreso.

Visibilidad de los premios: lo que ya se ha recibido, lo que se quemará, lo que sigue.

Gaidline por redacción: «invitamos» a participar, no presionamos el depósito.

Localización: textos, monedas, plazos, jurisdicciones.

13) Dashboards (diario)

1. Embudo de misión: Reach → Join → Start → T1/T2/... → Complete → Rewarded.

2. Comunicaciones: nat/open/click, opt-out, capping per-channel.

3. Monetización: Δ ARPPU (net), Depósito de Avg, Compartir de pago.

4. Costo: Premio/Bono Costo%, Net Uplift, presupuesto-pools.

5. Calidad: DLQ, retraídas, errores HMAC, latency p95, banderas de frod, disparadores RG.

6. Segmentos: principiante/mid-core/alto-valor; web/iOS/Android; geo.

14) Lista de comprobación de inicio

Esquema de eventos, versioning, contratos webhooks (HMAC, TTL, idempotencia).
Mapping misiones → tipos de premios + presupuestos/capers.
KYC/RG-gates, hold-and-review de grandes premios.
Integración de monedero/servicio de bonificación (sandbox → prod), retrai/DLQ.
Segmentos CRM/CDP, disparadores y reglas de suppression, límites de frecuencia.
Dashboards SLO y economía; alertas SRM/DLQ/presupuesto.
Plan A/B, CUPED, líderes separados.
Runbook de incidentes: rejuvenecimiento de eventos, dispensación manual, «congelación» de reglas.

15) Mini caso (sintético)

Lanzados: "Onboarding 7 days", "Sprints' de fin de semana," Return 14 days ".

Premios: T1/T2 - FS/Bonus Cache; Los terminadores son parte de la caché sin conductor.

CRM: desencadenantes «casi-alcanzado», «el bono expira», quiet-hours, capping.

6 semanas, 2 marcas, holdout 15%.

Resultados: participation_net 24% → 33% (+ 9 p.p.), completion 42% → 56% (+ 14 p.p.), Δ ARPPU (net) + 2,8 €; Prize&Bonus/Active +€0,8; DLQ <0,07%; fraud-flags <1% PF.

Solución: escalar, aumentar la «cola larga» de microprises y textos locales en CRM.

La integración de las misiones con el sistema de bonificación y CRM es una sola máquina: eventos y reglas, presupuesto-control, billetera/bonos, personalización y comunicaciones seguras. Construyéndolo sobre la idempotencia, las gatitas KYC/RG, los segmentos de CRM y la economía transparente - y las misiones traerán un aumento neto constante en lugar de «comer» el margen.