Eventos personalizados e metas

Como funciona

Use eventos para resultados concluídos, como cadastro, envio de lead ou checkout iniciado. A chamada final de track() deve ocorrer no navegador, depois que o servidor confirmar o sucesso. Não registre o clique inicial: OAuth pode ser cancelado, validação pode falhar e pagamentos podem ser recusados.

1. O visitante inicia a ação.
2. O aplicativo conclui e confirma o sucesso ao navegador.
3. O navegador chama track() uma vez.
4. Você cria uma meta com exatamente o mesmo nome.

Helper reutilizável

export function trackRevenueUI(eventName) {
  const send = () => window.revenueUI?.track(eventName);
  if (window.revenueUI?.ready) return send();
  window.addEventListener("revenueui:ready", send, { once: true });
}

Nomes começam com letra, usam minúsculas, números e _, e têm até 32 caracteres. page_view e page_engagement são reservados. Não há propriedades personalizadas; nunca coloque dados pessoais no nome.

Integração no cliente

JavaScript, TypeScript, React, Vue, Nuxt, Angular e SvelteKit devem chamar o helper após a resposta bem-sucedida. No Next.js App Router, um Server Action retorna sucesso e um Client Component envia o evento. Evite efeitos de montagem, que podem repetir no desenvolvimento ou ao revisitar uma rota.

"use client";
export function SignupForm() {
  async function handleSubmit(formData: FormData) {
    const result = await createAccount(formData);
    if (result.success) trackRevenueUI("signup_completed");
  }
  return <form action={handleSubmit}>{/* campos */}</form>;
}

Express deve retornar o resultado ao navegador. Laravel, Django e Rails podem gravar um valor flash único após a transação, redirecionar e enviar pelo navegador com codificação JSON segura. Código somente no servidor não carrega automaticamente a identidade de atribuição.

Evite duplicatas

Escolha um único caminho de sucesso. Em rotas revisitáveis, guarde um token de conclusão opaco e curto em sessionStorage; não use e-mail ou identificador pessoal. A deduplicação do navegador protege a análise, não substitui idempotência no servidor.

Crie e verifique a meta

No detalhe do site, abra visitantes por meta, selecione Adicionar meta, informe um nome legível e o evento exato, como signup_completed. Os nomes diferenciam maiúsculas e minúsculas e as conclusões contam após a criação da meta.

Teste um sucesso e uma falha. Confirme o evento e o visitante, recarregue a página de sucesso para verificar que não duplica e valide que cancelamentos não enviam nada.