Sistema de gerenciamento de afiliação (plug-ins)

Introdução

O sistema de gerenciamento de afiliação (plug-in AFF) permite que os parceiros atraiam jogadores e recebam uma comissão da sua atividade. O módulo AFF incorporado à plataforma fornece a geração de referências referais, rastreamento de registros e depósitos, cálculo automático de recompensas, multi-tier estrutura de comissões e relatórios detalhados.

1. Geração e rastreamento de referências referais

«affiliateId» e um conjunto de referências referais da vista são criados para cada parceiro

```
https: //casino. example. com/?aff=abc123
```
Cookia- e sessão-tracking: Quando você acessa um link no cookie, é salvo 'aff = abc123' em configurable TTL (30 a 90 dias).
Servidor-side atribute: Se um jogador é registrado fora do cookie, fallback por IP e marcas promocionais UTM.

2. Módulo de cálculo de comissão

1. Tipos de recompensa:
  • Revenue share: porcentagem da GGR (geralmente 20 a 40%).
  • CPA: taxa de inscrição fixa + primeiro depósito.
  • HybrID: combinação CPA e RS.
  • 2. Programa Multi-tier:
    • Tier 1, refilmagens diretas.
    • Tier 2 +: Refilmagens de refino com comissão reduzida (5-10%).
    • 3. Período de cálculo: diariamente/semanalmente/mensalmente, dependendo do acordo.
    • 4. Automação:
      • `POST /affiliate/compute? period = 2025-07 'executa job de cálculo.
      • Transações ACID: pagamento no Ledger Service, criação de uma solicitação payout.

      3. API e Integração Webhook

      REST API:
      • `GET /affiliate/{id}/stats? from = & to = '→ de registro, depósitos, GGR, comissão.
      • 'POST/affiliate/diante de um aplicativo de pagamento de adereços → criar um pagamento para os adereços especificados.
      • Webhooks:
        • Eventos: 'player. registered`, `player. deposited`, `affiliate. commission. awarded`.
        • Payload contém «affiliateId», «playerId», somas e apostas.

        4. Relatórios e interfaces

        Dashboard Associado:
        • Mostra em tempo real: novos jogadores, valores de depósito, GGR, taxas de pagamento, status de pagamento.
        • Filtros por períodos, países, fontes de tráfego (UTM).
        • Exportar CSV/PDF no horário e mediante solicitação.
        • Acesso API para BI: integração com sistemas externos via secure REST.

        5. Anti-fraud e proteção do sistema

        Detection:
        • Bloquear self-referral (same IP/device).
        • Velocity checks: Mais de N de inscrição por minuto a partir de um token.
        • Blacklist/Whitelist:
          • Painel de controle manual.
          • Logs de auditoria:
            • Registro imutável de todos os eventos de rastreamento e cálculo no armazenamento WORM.

            6. Escalabilidade e resistência a falhas

            Arquitetura de microsserviço: AFF-Service separado do core, escalável em função da carga de tracking.
            Message Broker (Kafka):
            • Processamento de eventos de registro e depósitos em tempo real.
            • Cache Layer (Redis):
              • Lookup 'affiliateId' rápido por 'playerId' e UTM.
              • High Availability:
                • Kubernetes com HPA para AFF-Service e Líder Service, Sentinel-clusters Redis.

                7. Segurança e Complacência

                Autenticação: OAuth2 para associados, chave API com limite IP.
                Criptografia: TLS para todos os canais, armazenamento de segredos Vault.
                GDPR/CCPA: Direito de remoção de dados do parceiro e dos jogadores, possibilidade de anonymize.

                Conclusão

                O sistema integrado de gerenciamento de afiliação fornece aos parceiros uma ferramenta completa para atrair e monetizar o tráfego, desde links exclusivos e tracking até o cálculo automático de comissões multi-tier, real-time e proteção contra fraudes. A arquitetura de microsserviço escalável e a integração API garantem que a rede de parceiros cresça sem perdas de desempenho e segurança.