Nomes e estrutura de eventos: organiza o teu sistema de eventos

Aprende a dar nomes coerentes aos eventos e a organizá-los em grupos, com documentação, para que o teu rastreio continue claro à medida que cresces.

Rascunho

Como deves dar nome aos teus eventos? "purchase" ou "purchase_conversion"? "button_click" ou "click_button"? "form_submit" ou "submit_form"? Os nomes parecem um detalhe, mas se errares, o rastreio vira um caos. Uma pessoa chama "purchase" a um evento. Outra chama "conversion" a um evento parecido. Agora tens rastreio duplicado com nomes diferentes. Os relatórios mostram números contraditórios. As equipas discutem qual é o número certo. Bons nomes evitam isto. Nomes coerentes significam que todos sabem o que cada evento faz.

Este artigo explica como dar nomes aos eventos e como estruturá-los para que o teu sistema de rastreio se mantenha organizado à medida que cresces.

O que são nomes e estrutura de eventos

Dar nome a um evento é como o etiquetas. "purchase", "form_submit", "video_play". A estrutura é como organizas os eventos. Que eventos pertencem ao mesmo grupo? Como os categorizas? Bons nomes e uma boa estrutura mantêm o rastreio organizado.

Maus nomes são assim. Uma pessoa cria "purchase". Outra cria "buy". Outra cria "transaction". A mesma coisa tem três nomes diferentes. Os teus relatórios mostram três eventos separados. As equipas não sabem em que número confiar.

Bons nomes seguem convenções coerentes. Todos os eventos de compra chamam-se "purchase". Todos os eventos de formulários começam por "form_". Todos os eventos de envolvimento começam por "engagement_". Coerência significa clareza.

Cria uma convenção de nomes

Define como vais dar nome a todos os eventos. Inclui uma categoria. "conversion_purchase". "conversion_signup". "engagement_video_play". A categoria vem primeiro. O evento específico vem depois.

Usa sublinhados ou camelCase de forma coerente. Tudo em minúsculas com sublinhados. camelCase. Escolhe um e mantém-no. Maiúsculas e minúsculas inconsistentes confundem.

Mantém os nomes curtos, mas descritivos. "purchase" é melhor do que "user_completes_purchase_transaction". "form_submit" é melhor do que "form_submission_event_trigger". Os nomes devem ser claros sem serem longos demais.

Agrupa eventos relacionados

Decide que eventos estão relacionados. Os eventos de compra ficam juntos. Os eventos de formulários ficam juntos. Os eventos de navegação ficam juntos. Agrupa os eventos relacionados na documentação e no painel.

Usa prefixos para mostrar o agrupamento. "conversion_purchase". "conversion_signup". Ambos começam por "conversion". Quem lê o nome percebe que medem conversões.

Nos relatórios, organiza os eventos por grupo. Tem um painel de eventos de conversão. Um painel de eventos de envolvimento. Um painel de eventos de erro. A organização ajuda as equipas a encontrar o que precisam.

Cria uma hierarquia de eventos

Alguns eventos são mais importantes do que outros. A compra é crítica. Os envios de formulários são importantes. Os scrolls na página são secundários. Cria uma hierarquia.

Documenta que eventos são críticos. Quais são importantes. Quais são apenas desejáveis. Os eventos críticos são testados com mais rigor. Os eventos importantes são revistos com regularidade. Os eventos secundários têm uma monitorização básica.

Usa esta hierarquia para distribuir recursos. Dedica mais tempo a garantir que os eventos críticos funcionam. Dedica menos tempo aos eventos secundários.

Documenta as definições dos eventos

Para cada evento, documenta o que é. Quando dispara? Que dados recolhe? Quando alguém novo entra na equipa, lê a tua documentação e percebe o sistema.

Inclui exemplos. "O evento purchase dispara quando alguém conclui uma compra. Recolhe o valor da encomenda, a categoria do produto e o ID do utilizador. Exemplo: o evento purchase dispara com os valores $49.99, electronics, user123."

A documentação evita eventos duplicados. Antes de criar um evento novo, alguém consulta a documentação. Se já existir algo semelhante, reutiliza-o.

Alinha os eventos com os objetivos de negócio

Os teus eventos devem corresponder a objetivos de negócio. Se o teu objetivo são vendas, tens eventos de compra. Se o teu objetivo são leads, tens eventos de inscrição. Se o teu objetivo é o envolvimento, tens eventos de envolvimento.

Associa cada evento a um objetivo de negócio. "Este evento mede o nosso objetivo de vendas." "Este evento mede a geração de leads." "Este evento mede o envolvimento." O alinhamento ajuda as equipas a perceber porque é que os eventos existem.

Revê os eventos todos os trimestres. Os eventos que estás a registar continuam alinhados com os objetivos de negócio? Se o teu negócio mudar, talvez precises de eventos novos. Elimina os eventos que não importam.

Perguntas frequentes

Os nomes dos eventos devem estar no singular ou no plural?

No singular. "purchase", não "purchases". "form_submit", não "form_submits". O singular é mais claro. "purchase" é uma única ocorrência da ação. Nomes no singular evitam confusão. Com o criador de websites da WEMASY, podes configurar isto diretamente no teu website.

Quantos eventos devemos nomear e registar?

Começa pelos eventos críticos. Compra, inscrição, envio de formulário. Acrescenta os eventos importantes. Reproduções de vídeo, ações de envolvimento. Acrescenta os eventos secundários. Scrolls, cliques. A maioria dos websites acaba com 10 a 30 eventos. Mais do que isso e perdes o foco.

Temos eventos antigos com maus nomes. Devemos renomeá-los?

Não. Renomear estraga os dados históricos. Daqui para a frente, usa boas convenções de nomes. Para os dados históricos, cria um documento de correspondência. "Nome antigo: purchase_complete. Nome novo: conversion_purchase." A correspondência ajuda as equipas a perceber que os dois nomes se referem à mesma coisa.

Devemos incluir o nome da página no nome do evento?

Não. A informação da página são dados associados ao evento, não o nome do evento. Um evento dispara quando alguém clica num botão. A página em que está é contexto, não o nome do evento. Mantém os nomes dos eventos genéricos.

Como tratamos eventos que disparam em várias páginas?

Usa o mesmo nome de evento, seja qual for a página. "form_submit" dispara em todas as páginas com formulários. A informação da página é associada como dados do evento. Esta simplificação significa que tens um evento em vez de dez.

Devemos aninhar os eventos ou mantê-los numa estrutura plana?

Mantém-nos planos ao nível dos nomes. Usa categorias nos prefixos. "conversion_purchase", "engagement_video_play". Uma estrutura plana com prefixos é mais clara do que estruturas aninhadas. A maioria das equipas usa nomes planos com prefixos de categoria.

Põe isto em prática
no teu próprio site.

Começa grátis com a WEMASY e cria o teu site em poucos minutos.