Intentyon
Docs
Por que minha regra não dispara?

Por que minha regra não dispara?

Um guia para diagnosticar e corrigir regras de qualificação que parecem não estar funcionando.

Você configurou um Evento, salvou, entrou no site para testar... e nada aconteceu. O contador de qualificações continua em zero.

Não se preocupe. O Intentyon opera com lógica binária estrita: ou a condição foi atendida, ou não foi. Se o evento não disparou, existe uma razão lógica.

Este guia ajuda você a identificar o culpado.

1. O Culpado #1: Seletor CSS Incorreto

Em 90% dos casos de regras de interação (Clique, Visualização, Formulário), o problema é o Seletor CSS.

O Problema dos IDs Dinâmicos

Muitas plataformas modernas (Shopify, Wix, ClickFunnels) geram IDs aleatórios que mudam a cada carregamento da página.

  • Hoje: #botao-compra-123
  • Amanhã: #botao-compra-456

Se você configurou o Intentyon para olhar para #botao-compra-123, a regra quebrará amanhã.

A Solução:

  1. Evite IDs que terminam em números aleatórios.
  2. Use Classes (ex: .btn-primary) que costumam ser estáveis.
  3. Use a nossa ferramenta de Verificação dentro do editor de regras. Se a verificação automática falhar repetidamente, é um sinal de que o seletor está mudando ou não existe.

2. Lógica Muito Restritiva (O Problema do "E")

Ao combinar regras, preste atenção na Lógica Geral do evento.

Se você selecionou "CUMPRIR TODAS (AND)", o visitante precisa gabaritar a prova.

  • Sua Regra: Tempo Ativo > 120s E Scroll > 90%.
  • O Visitante: Ficou 3 minutos (180s) mas só rolou até 50% da página.
  • Resultado: Não Qualificado.

Como Diagnosticar: Verifique o Painel de Oportunidades. Se você vê que a regra de Tempo tem muitos dados, mas a de Scroll tem poucos, é o Scroll que está "matando" a sua qualificação. Considere baixar a exigência ou mudar a lógica para "OU".

3. Use o Modo de Depuração (Debug Mode)

O Intentyon possui um modo de diagnóstico "secreto" que mostra exatamente o que o script está vendo em tempo real.

  1. Abra seu site em uma nova aba.
  2. Adicione ?debug=true ao final da URL.
    • Exemplo: www.minhaloja.com.br/produto-x?debug=true
  3. Abra o Console do Desenvolvedor:
    • Clique com o botão direito na página > Inspecionar.
    • Clique na aba Console.
  4. Interaja com o site.

O que procurar: Você verá mensagens coloridas com a tag [INTENTYON].

  • Ao carregar:
    • [INTENTYON] Configuração carregada... (Confirma que o script está ativo).
    • [INTENTYON] Listeners globais anexados. (Confirma que ele está pronto para ouvir cliques).
  • Ao clicar em um elemento:
    • [INTENTYON] Clique configurado detectado para o seletor: '#meu-botao'
    • Se você clicar e essa mensagem NÃO aparecer, seu Seletor CSS está errado.

4. Atraso no Processamento (Latência)

Lembre-se que o Intentyon processa dados em duas etapas:

  1. Ingestão: Imediata. O script envia o dado.
  2. Qualificação (Worker): Assíncrona. Nosso servidor processa as regras e decide se o visitante qualificou.

Embora geralmente leve segundos, em momentos de alto tráfego na internet, pode haver um atraso de alguns minutos entre a ação no site e o aparecimento do "+1" no dashboard.

Dica: Se você está testando, aguarde pelo menos 5 a 10 minutos antes de achar que algo está quebrado.

5. Testando em Abas Anônimas

Se você está testando a regra de Recorrência de Visitas ou Visualizações de Página, lembre-se que o seu navegador já tem um histórico "sujo" (você entra no seu próprio site todo dia).

Para um teste limpo:

  1. Abra uma Janela Anônima (Incognito).
  2. Isso simula um "Novo Visitante" com histórico zerado.
  3. Realize as ações.
  4. Feche a aba (para garantir que o lote final de dados seja enviado).
Problemas ComunsCentral de Suporte