Alocação e Limites de Visitas
Documentação técnica sobre como o sistema contabiliza visitas, a lógica de prioridade entre limites de conta e projeto, e o comportamento em caso de excedente.
O Intentyon utiliza um sistema híbrido de gerenciamento de cotas para permitir flexibilidade máxima na distribuição dos recursos do seu plano entre seus projetos.
Esta página documenta as regras de negócio que regem a contagem, a alocação e o bloqueio de tráfego.
Definição de "Visita"
Para fins de faturamento e limites, o Intentyon contabiliza Sessões Únicas.
- Janela de Sessão: Uma sessão é iniciada quando o usuário acessa o site.
- Contagem: Independente de quantas páginas o usuário visite ou quantos eventos dispare, isso conta como 1 Visita no seu saldo mensal.
- Reset: O contador de uso é zerado automaticamente no dia da renovação da sua assinatura (ciclo de faturamento do Stripe).
Modos de Operação
O sistema opera em dois modos distintos, definidos no nível da Conta de Usuário.
1. Limite da Conta (Compartilhado)
Este é o comportamento padrão.
- Lógica: Existe um único limite total de visitas (ex: 100.000) atrelado ao Plano.
- Consumo: Todos os projetos ativos debitam deste mesmo limite total.
- Bloqueio: Se o total de visitas de todos os projetos somados atingir o limite do plano, todos os projetos param de processar novos dados simultaneamente.
2. Limite Dedicado (Manual)
Disponível nos planos Pro e Business. Este modo ativa a verificação de limites no nível do Projeto individual.
- Lógica: O usuário define um limite específico (Alocação) para cada projeto.
- Consumo: O projeto debita do seu limite individual E do limite total global.
- Bloqueio:
- Se o projeto atingir seu limite individual: Apenas este projeto é pausado.
- Se a conta atingir o limite global: Todos os projetos são pausados (mesmo que não tenham atingido seus limites individuais).
Limite Híbrido: Mesmo no modo Manual, um projeto pode ser configurado para usar o "Limite total da Conta". Nesse caso, ele ignora alocações individuais e se comporta como no modo Compartilhado.
Hierarquia de Verificação (Algoritmo)
Quando uma visita chega na nossa API de Ingestão, o sistema executa a seguinte verificação de permissão em tempo real:
- Verificação Global: O uso total da conta excedeu o limite do plano?
- Sim: Rejeita a visita.
- Não: Continua.
- Verificação de Modo: A conta está em modo
MANUAL?- Não (Compartilhado): Aceita a visita.
- Sim: Verifica a configuração do projeto específico:
- O projeto usa o Limite total da conta?
- Sim: Aceita a visita.
- Não: Verifica se o uso do projeto excedeu a alocação manual.
- Excedeu: Rejeita a visita.
- Não Excedeu: Aceita a visita.
- O projeto usa o Limite total da conta?
Comportamento de Excedente (Overage)
O Intentyon opera com um modelo de Hard Cap (Limite Rígido) para proteger o usuário de custos imprevisíveis.
- Sem Cobrança Automática: Jamais cobramos taxas adicionais por visitas excedentes.
- Pausa de Ingestão: Quando um limite é atingido, a API de ingestão passa a retornar um status de bloqueio. O script no navegador do visitante recebe esse status e para de enviar novos eventos para aquela sessão.
- Impacto no Frontend: O script carrega de forma assíncrona e silenciosa. A interrupção do serviço ocorre no "backstage" e não gera erros visuais ou de performance para o visitante do seu site.
- Notificações: O sistema dispara e-mails automáticos quando o consumo atinge 80% e 100% das cotas.
Alteração de Limites
- Upgrades: Aumentam o limite global imediatamente. Projetos pausados voltam a funcionar instantaneamente.
- Realocação (Modo Manual): Você pode aumentar o limite de um projeto e diminuir de outro a qualquer momento. A alteração reflete em tempo real na API de ingestão.