Que erros na configuração de eventos custam dias de resolução de problemas às equipas? Eventos duplicados que contam a mesma ação duas vezes. Eventos configurados para as páginas erradas. Parâmetros que captam valores errados. Nomes incoerentes que geram confusão. Eventos que disparam na altura errada ou nem disparam. Estes erros são comuns porque configurar eventos é complexo. Mas também se podem prevenir. Perceber o que corre mal ajuda-te a evitá-lo.
Este artigo cobre os erros mais comuns e como os prevenir.
Eventos duplicados
O erro mais comum é criar o mesmo evento duas vezes com nomes diferentes. Um programador cria "purchase". Outro cria "purchase_conversion". Agora estás a registar a mesma ação duas vezes. Os relatórios mostram dois eventos. As equipas discutem qual está certo.
Previne duplicados consultando o teu registo de eventos antes de criar. Este evento já existe? Se sim, usa o evento existente. Se não, cria-o com a convenção de nomes combinada.
Se descobrires duplicados, elimina um de imediato. Duplicados ativos poluem os teus dados.
Eventos configurados para as páginas erradas
Configuras um evento de envio de formulário. Testas no formulário de contacto. Funciona. Publicas. Mas ele dispara em todas as páginas, não só nas de contacto. A configuração do evento é demasiado ampla.
Previne isto testando em várias páginas. Testa a página onde o evento deve disparar. Testa as páginas onde não deve. Verifica que só dispara onde pretendes.
Documenta onde cada evento deve disparar. Se mais tarde notares que dispara noutro sítio, apanhaste um erro de configuração.
Parâmetros que captam valores errados
Um evento de compra tem um parâmetro que devia captar o valor da compra. Mas capta o preço do produto. É parecido, mas não é o mesmo. Os dados estão errados.
Previne isto testando os parâmetros com valores conhecidos. Faz uma compra de $50. Verifica que o parâmetro mostra $50. Não $45. Não $55. Exatamente $50.
Documenta de onde cada parâmetro vai buscar os dados. "O valor da compra vem do campo purchase_amount da camada de dados." Uma documentação clara evita trocas.
Nomes de eventos incoerentes
Um evento chama-se "purchase". Outro "Purchase". Outro "purchase_event". O mesmo evento tem três nomes. Os relatórios mostram três eventos separados. O resultado é confusão.
Previne isto com convenções de nomes coerentes. Tudo em minúsculas. Sem espaços. Sublinhados entre palavras. Um único padrão de nomes. Aplica-o a todos os eventos.
Documenta o teu padrão de nomes. Partilha-o com todos os que criam eventos. Faz da coerência a regra.
Eventos que não disparam
Configuras um evento. Publicas. Nada acontece. Não há eventos nos relatórios. O evento não está a disparar de todo.
As razões comuns incluem uma configuração errada do gatilho (o evento devia disparar quando alguém clica num botão específico, mas o gatilho procura o elemento errado), uma configuração errada da página (o evento devia disparar numa página específica, mas o caminho da página mudou) ou problemas de tempo (o evento dispara antes de a camada de dados ser preenchida).
Previne isto testando bem antes de publicar. Verifica a configuração do gatilho. Verifica o caminho da página. Verifica o tempo. Testa no ambiente de testes. Não publiques eventos por testar.
Eventos que disparam demasiadas vezes
Configuras um evento para disparar quando alguém clica num botão. Mas dispara vinte vezes por clique. O disparo duplicado distorce os teus dados.
As razões comuns incluem vários ouvintes para o mesmo evento (o gestor de tags e o teu website disparam o mesmo evento) ou a propagação de eventos (um clique num elemento filho dispara também o evento do elemento pai).
Previne isto percebendo o teu gatilho. Testa com cuidado. Procura duplicados. Acompanha a taxa de disparo dos eventos. Se estiver invulgarmente alta, investiga.
Valores de parâmetros em falta ou errados
Um evento de compra deve captar o valor da compra. Mas o parâmetro está vazio. Ou capta o valor errado. A qualidade dos dados sofre.
As razões comuns incluem a camada de dados por preencher (o evento dispara antes de a camada de dados ter informação), um erro de mapeamento do parâmetro (o parâmetro procura o campo errado da camada de dados) ou valores fixos no código (um parâmetro tem um valor fixo em vez de ir buscar dados dinâmicos).
Previne isto verificando que a camada de dados está preenchida antes de os eventos dispararem. Testa os parâmetros com dados reais. Verifica se o mapeamento está certo. Usa dados dinâmicos, não valores fixos.
Não testar em produção
Testaste a fundo no ambiente de testes. Os eventos funcionam na perfeição. Publicas em produção. Os utilizadores dizem logo que os eventos não funcionam. O ambiente de testes é diferente da produção de formas que não esperavas.
Previne isto testando em produção com uma pequena percentagem do tráfego. Começa com 10%. Vigia os erros. Se tudo funcionar, sobe para 50%. Depois 100%. Testes de produção em pequena escala apanham problemas específicos do ambiente.
Não acompanhar os eventos depois de publicar
Publicas os eventos. Passas ao projeto seguinte. Três semanas depois, alguém repara que um evento deixou de disparar. Perdeste três semanas de dados.
Previne isto acompanhando os eventos de forma contínua. Define alertas. Se um evento não disparar durante uma hora, avisa alguém. Verifica a taxa de disparo dos eventos todas as semanas. Repara em mudanças inesperadas. Apanha os problemas cedo.
Perguntas frequentes
Como detetamos eventos duplicados?
Documenta todos os eventos num registo de eventos. Antes de criares um evento, consulta o registo. Se existir algo semelhante, reutiliza-o. Auditorias regulares à tua lista de eventos apanham os duplicados que te escaparam. Com o criador de websites da WEMASY, podes configurar isto diretamente no teu website.
Um evento dispara, mas a qualidade dos dados é fraca. Como o depuramos?
Verifica cada componente. O evento está a disparar? Usa os relatórios em tempo real. O gatilho está certo? Usa as ferramentas de programador. Os parâmetros estão a ser captados? Verifica os valores. Isola o componente que está errado. Corrige-o. Testa de novo.
Temos um evento avariado em produção. Devemos apagá-lo ou desativá-lo?
Desativa, não apagues. Desativar mantém os dados históricos. Apagar remove o evento por completo. Podes querer analisar os dados de antes de o evento avariar. Guarda os dados. Limita-te a desativar o evento daqui para a frente.
Como prevenimos erros de configuração?
Usa uma configuração de eventos padronizada. Cria um modelo. Todos os eventos usam a mesma estrutura. A padronização reduz a variação. Menos variação significa menos erros.
Qual é o pior erro na configuração de eventos?
Publicar eventos por testar em produção. Os eventos por testar falham em silêncio. Não notas durante dias. Entretanto, já perdeste dados. Testa sempre antes da produção.
Como recuperamos de erros na configuração de eventos?
Reage depressa. Quando notares um erro, corrige-o de imediato. Desativa o evento avariado. Corrige a configuração. Testa. Publica de novo. Quanto mais depressa reagires, menos dados maus recolhes.