Pular para o conteúdo

O plano de rastreamento de eventos para startups

Um plano de rastreamento de eventos é a especificação viva de cada evento que você registra — o nome, as propriedades, quando ele é acionado e quem é o responsável. Para uma startup, comece pequeno: os oito a dez eventos que mapeiam o seu funil do cadastro à ativação e à receita. Acrescente mais só quando uma pergunta real precisar deles.

Atualizado em 7 min de leituraPor fromHello

O essencial

  1. Um plano de rastreamento é uma especificação viva, não um documento feito uma vez: nome, propriedades, gatilho e responsável para cada evento.

  2. Comece com 8–10 eventos ao longo de cadastro → ativação → receita. Acrescente um evento só quando uma pergunta real precisar dele.

  3. Escolha uma convenção de nomes (object_action, por exemplo subscription_started) e nunca a quebre — o desvio mata as análises sem fazer barulho.

  4. Decida quem é o responsável pelo plano e onde os dados ficam (first-party, auto-hospedado ou SaaS) antes da primeira chamada track().

O que é um plano de rastreamento

Um plano de rastreamento é um documento único que lista todos os eventos que o seu produto registra, as propriedades associadas a cada um, o momento exato em que ele é acionado e a pessoa responsável por ele. É o contrato entre o código que emite os dados e os painéis que os leem. Trate-o como uma especificação viva que muda com o produto, não como um documento que você escreve uma vez e esquece. Para a versão em uma linha, veja plano de rastreamento; este guia mostra como montar um.

Quatro termos que compõem um plano de rastreamento, da menor unidade (um evento) à especificação que rege todas elas.

Por que um plano é melhor que o rastreamento improvisado

Sem um plano, o rastreamento vai se acumulando. Um engenheiro registra signup, outro registra Sign Up, um terceiro registra user_registered — três nomes para uma ação, e todo funil que passa pelo cadastro se divide ou quebra sem aviso. Isso é desvio, e é o principal motivo para as análises deixarem de ser confiáveis. Um plano fixa o vocabulário antes de o código ir para produção, para que os números que você puxar daqui a seis meses ainda signifiquem o que você pensa. Eventos limpos e consistentes também são a base de um roadmap de experimentação — não dá para medir um teste por uma métrica que você registra de três jeitos diferentes.

Nomeie os eventos como object_action e não abra exceção

A convenção que a maioria das ferramentas de análise recomenda é object_action: o objeto e depois o que aconteceu com ele — subscription_started, invite_sent, checkout_completed. Segment, Amplitude e PostHog descrevem, cada um, uma variante (o Segment usa “Object Action”, o PostHog snake_case em minúsculas, a Amplitude um substantivo mais um verbo no passado). A capitalização exata importa bem menos do que escolher uma e nunca quebrá-la. Duas regras concentram a maior parte do valor: mantenha o tempo verbal consistente e nunca monte nomes de eventos dinamicamente — um evento chamado plan_${name}_upgraded cria um evento por cliente e não dá para consultá-lo.

Os 8–10 eventos que mapeiam o seu funil

Resista à tentação de rastrear tudo. Comece com o punhado de eventos que acompanham um usuário do primeiro contato ao pagamento — cadastro, ativação e receita — e instrumente bem esses eventos antes de ganhar profundidade. Abaixo está um conjunto inicial para um SaaS B2B típico; renomeie os eventos com os substantivos do seu produto. Cada um vira uma linha do seu plano e, juntos, formam o seu primeiro conjunto de dados first-party — a matéria-prima de cada funil, coorte e curva de retenção que você vai construir. Onde cada evento é instrumentado — no navegador ou no servidor — é uma decisão à parte: rastreamento server-side vs. client-side trata dessa divisão.

EventoQuando é acionadoPor que importa
account_createdO usuário conclui o cadastro e o registro existeTopo do funil; o denominador de toda taxa de conversão
onboarding_startedO usuário entra no fluxo de primeiro usoSepara os cadastros que começam a configuração dos que vão embora
activation_reachedO usuário atinge o momento aha que você definiu (por exemplo, o primeiro projeto compartilhado)O evento inicial mais preditivo; valide-o, não o presuma
feature_usedUm recurso central é usado, com a propriedade feature_nameProfundidade do engajamento; insumo para segmentos e retenção
invite_sentO usuário convida um colegaIndicador antecedente de expansão e engajamento duradouro no B2B
trial_startedComeça um período de teste ou um plano gratuitoAbre o funil de receita; ancora a taxa de conversão do teste para o pago
subscription_startedO usuário passa para um plano pagoO momento da receita; liga o trabalho de growth ao dinheiro
subscription_cancelledO usuário cancela um plano pagoSinal de churn; alimenta a reconquista e a análise de retenção

As propriedades carregam o detalhe; os responsáveis mantêm tudo limpo

Mantenha os eventos poucos e genéricos; jogue os detalhes para as propriedades. Em vez de um evento separado para cada plano, registre subscription_started com as propriedades plan_name e amount_usd — um único evento, bem descrito, continua consultável. Mantenha enxuto o conjunto de propriedades de cada evento — um punhado que você realmente consulta vale mais que dezenas que você nunca usa. Depois, defina a responsabilidade: na maioria das equipes pequenas, ela fica com um Growth Engineer ou com quem entrega a instrumentação, e todo evento novo deve passar por essa pessoa para que o plano e o código nunca se afastem. Por fim, saiba onde os eventos vão parar. Enviá-los para uma ferramenta de análise hospedada ou uma CDP é rápido, mas coloca os seus dados comportamentais nos servidores de outra empresa; mantê-los first-party — Postgres auto-hospedado, o seu próprio data warehouse — mantém esses dados com você, que é o dilema central entre código aberto e SaaS nas ferramentas de engajamento.

FAQ

Perguntas frequentes

  • Quantos eventos uma startup deve rastrear?

    Comece com oito a dez — os eventos que mapeiam cadastro, ativação e receita — e acrescente mais só quando uma pergunta específica precisar deles. Rastrear tudo de saída cria ruído que você precisa manter e raramente consulta. É mais fácil acrescentar depois um evento bem nomeado do que desembaraçar cem eventos inconsistentes.

  • Qual é a melhor convenção de nomes para eventos?

    object_action (o substantivo e depois o que aconteceu) é a mais recomendada: subscription_started, invite_sent. Segment, Amplitude e PostHog publicam, cada um, uma variante. A melhor convenção é aquela que você aplica com consistência — a capitalização e o tempo verbal importam menos do que nunca quebrar a regra nem gerar nomes dinamicamente.

  • Qual é a diferença entre um evento e uma propriedade?

    Um evento é a ação (subscription_started); uma propriedade é um detalhe sobre essa ação (plan_name, amount_usd). Mantenha os eventos poucos e genéricos e jogue os detalhes para as propriedades, para que um evento bem descrito continue consultável em vez de se fragmentar em dezenas de quase duplicatas.

  • Os dados de rastreamento devem ficar em uma ferramenta SaaS ou auto-hospedados?

    Os dois funcionam. Uma ferramenta de análise hospedada ou uma CDP é mais rápida para começar; a auto-hospedagem (o seu próprio Postgres ou data warehouse) mantém os dados comportamentais na sua infraestrutura e evita a dependência do fornecedor. Para uma equipe técnica que trata os dados de clientes como first-party, a auto-hospedagem costuma ser a melhor escolha no longo prazo. Decida antes de instrumentar, porque migrar eventos depois é doloroso.

fromHello é um software de automação de marketing de código aberto: mensagens acionadas pelo que as pessoas fazem.

O fromHello Cloud está disponível em acesso antecipado pela lista de espera.

Acesso antecipado

fromHello Cloud

Ninguém empreende para ficar pequeno.

O acesso antecipado ao fromHello Cloud é liberado em etapas. O onboarding é assistido: ajudamos você a configurar tudo e a trazer seus contatos.

Vamos avisar você por e-mail quando sua vaga for liberada. Sem spam.

Ainda não quer entrar? Ver no GitHub