Integração das missões com sistema de bónus e CRM

As missões só funcionam quando a recompensa é previsível e a comunicação conduz o jogador passo a passo. Então, o núcleo é um laço de Missão Engine ↔ Bônus/Wallet ↔ CRM/CDP, além de RG/KYC e antifrode. Abaixo, um esquema completo de integração com modelos de dados e práticas testadas.

1) Objetivos de integração

Aumento do envolvimento e ARPPU (net): missões → progresso → prémios → novas sessões/depósitos.

Controle de margem: orçamento-pula, caps, «valor do bónus» por ativo/pago.

Personalização: missões e prêmios de segmentos CRM/CDP.

Complaens: KYC/RG-gate, regras geo, auditoria.

A/B, pós-efeito, canibalização.

2) Arquitetura de fluxo

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

2. Missão Engine: verificação de condições, contagem de pontos/estatais, desencadeadores de prémios.

3. Reward Orquestrador: orçamento-cheque, RG/KYC, criação de 'reward _ task'.

4. Bónus/Wallet: dinheiro, bónus-dinheiro (vager), fretes, cupons; webhooks/SDK.

5. CRM/CDP: segmentos, campanhas de desencadeamento, limites de frequência, listras de suprimento.

6. Analytics/DWH: eventos crus, vitrines, incensos, dashboards.

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

3) Modelo de dados e 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`

Exemplo 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 prêmios: missões → sistema de bónus

Tipo de missão	Recompensa básica	Restrições/bandeiras
Rotação/apostas	Bónus-dinheiro € x	`wagering=10–20`, `expiry=72h`
Ganho/desenho animado. Frisas N por jogo	Jogo/provedor, aposta, prazo, geo-restrições
Depósito	Armazenamento em dinheiro/armazenamento	KYC L2 +, limites RG
Cadeia T1... Tn	Prémios Lut (tipos/raridade)	Proporção de «raros», orçamento-kap
Ação social	Cupons/FS	Nas jurisdições permitidas

A regra de escolha é: missões de massa - prêmios de baixo custo (FS/bónus-dinheiro), «terminadores «/cadeias profundas - parte do cachê de confiança.

5) Reward Orquestrador: orçamento, RG/KYC, Idempotação

Idempotidade: chave 'reward _ task _ id' + 'X-Request-Id' para chamadas externas.

Orçamentos: pool 'season _ sprint', 'onboarding', 'reengage'; soft/hard cap; circuit-breaker 90%.

KYC/RG-gates: dinheiro> € X - apenas L2 +, quando o 'cool _ off' está ativo em 'held'.

Auditoria: Registro WORM dos Corpos de Saída

Exemplo de '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) Integração com carteira/serviço bónus

Webhook de saída (exemplo):


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"
}

A resposta do parceiro é: '200 <«bônus _ id»:» b _ 331», «status «:» issued» a.s' n' reward _ task. succeeded`.

Erros 5xx → retrai com o mesmo 'X-Request-Id'; 4xx → DLQ + processamento manual.

7) Ligação com CRM/CDP

7. 1. Segmentação

Estágio: D0-D7, R7-R30, Core P30.

Monetização: insolventes/NPP/RPP/high-value.

Comportamento: completadores T1/T2/T3, «presos», «quase-alcançado».

Risco: bandeiras RG, status KYC.

7. 2. Desencadeadores de campanha

On-mission: «restam 120 pontos», «+ 2 posições» - in-app/push.

Post-mission: «Bónus ativado/expira em 12 horas».

Winback: não começou a missão 48 h → oferta pessoal (se permitido).

Supressão: em 'cool _ off '/self-exclusion nenhum promo.

7. 3. Regras de frequência

Max 1 push/4 h, 1 email/24 h por missão; capping pelo canal e em geral.

Quiet hours local, duplo opta-in/out.

8) Dados Pipeline em CRM

Vitrine CDP 'missão _ funtel _ daily':

`eligible`, `viewed`, `joined`, `started`, `t1..tn`, `completed`, `rewarded`.
Tempos antes de T1/T2/...; status de bônus; 'per _ eur'; 'net _ arppu'.

Exemplo de descarga no segmento «quase-alcançado»:

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) Antifrode e «fair play»

Caps: pontos/aposta, pontos/min/hora/dia; limite de microspetores repetitivos.

Os sinais são headless, proxy, duplicados 'device _ fp'.

Filtros comportamentais: dispersão mínima de apostas; «perfeito» pattern → hold.

Prémios:> € X e posição top - emissão adiada para KYC.

Limitações CRM: não incentivar «agricultores de óculos»; suppression по fraud-score.

10) Economia de prêmios e controle de margens

Indicadores-chave:

`Prize & Bonus Cost per Active` / `per Payor`
`ΔARPPU (net)` = ARPPU − (Prize+Bonus per payor)
'Net Uplift' = Receita Incorporativa - Valor (prêmios + operações + frod)

Orçamento-monitoramento (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) Testes de integração A/B

Unidade: usuário, sticky-assignment, esticamento (payer/geo/plataforma).

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

Guardrails: queixas/1k, fraud-flags, RG, alertas SRM.

CUPED: pré-valor (ARPPU/pontos da semana passada) para reduzir a dispersão.

Interdição: liderbordes separados/normalização de óculos.

12) Pattern Ux que «cobre» missões, bônus e CRM

Uma tela é um objetivo, regras claras, progressos visíveis.

O feedback imediato é «+ 10 pontos» e o crachá de progresso.

A visibilidade dos prémios é o que já foi recebido, o que vai queimar, o que vai acontecer.

Haydline, «convidamos» para participar, não pressionamos para o depósito.

Localização: textos, moedas, prazos, jurisdições.

13) Dashboards (diárias)

1. Vórtice de missões: Reach → Join → Start → T1/T2/... → Complete → Rewarded.

2. Comunicações: send/open/click, opt-out, per-channel capping.

3. Monetização: SE ARPPU (net), Avg Deposit, Paying Share.

4. Custo: Prize/Bónus Cost%, Net Uplift, orçamento-pula.

5. Qualidade: DLQ, retais, erros HMAC, latency p95, bandeiras de frod, triggers RG.

6. Segmentos: novo/mid-core/high-value; web/iOS/Android; geo.

14) Folha de cheque de lançamento

Esquema de eventos, versioning, contratos de webhooks (HMAC, TTL, Idempotação).
Mupping missões → tipos de prémios + orçamentos/capas.
KYC/RG-gate, hold-and-review grandes prémios.
Integração de carteira/serviço bónus (sandbox → prod), retrai/DLQ.
Segmentos CRM/CDP, desencadeadores e regras de suprimento, limites de frequência.
Dashboard SLO e economia; alert SRM/DLQ/orçamento.
A/B, CUPED, liderbordes separados.
Runbook incidentes: reinstalação de eventos, emissão manual, «congelamento» de regras.

15) Mini-mala (sintético)

Lançaram-se «Onboarding 7 Dias», «Springs de Fim de Semana», «Return 14 Dias».

Prêmios: T1/T2 - FS/bónus-dinheiro; Os finalistas fazem parte do cachê.

CRM: desencadeadores «quase-alcançado», «bónus vencido», quiet-hours, capping.

6 semanas, 2 marcas, holdout 15%.

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

Solução: zoom, ampliação de «cauda longa» de microprizes e textos locais no CRM.

A integração das missões com o sistema de bónus e CRM é uma única máquina: eventos e regras, orçamento-controle, carteira/bónus, personalização e comunicações seguras. Construa-a na idempotação, no KYC/RG-gates, nos segmentos de CRM e na economia transparente - e as missões serão estáveis para trazer uma margem neta, em vez de «comer».