Uma vez que o tracker do Zenovay esteja carregado na sua página, ele expõe uma função global window.zenovay(). Ela usa uma API de estilo comando: o primeiro argumento é o comando ('track', 'identify', 'goal', 'revenue', …), seguido por argumentos específicos do comando. Use o comando track para registrar qualquer coisa que não seja um pageview — cliques, envios de formulário, eventos de negócio.
A chamada mais simples
window.zenovay('track', 'cta_clicked');
Isso envia um único evento sem propriedades. Ele aparecerá na aba Analytics do seu dashboard em ~30 segundos.
Com propriedades
window.zenovay('track', 'cta_clicked', {
cta_label: 'Iniciar trial gratuito',
page_section: 'hero',
variant: 'B'
});
Os valores de propriedade podem ser strings, números ou booleanos. Objetos aninhados e arrays não são suportados — achate-os no ponto de chamada.
Eventos de revenue
Para compras, use o comando dedicado revenue. Ele leva o montante e a moeda diretamente:
window.zenovay('revenue', 29.00, 'USD');
Isso registra uma conversão de revenue que preenche sua aba Revenue. Se você omitir a moeda, ela padrão para USD.
Se você preferir anexar contexto extra, você também pode disparar um evento ordinário e incluir o montante e a moeda como propriedades:
window.zenovay('track', 'purchase', {
revenue: 29.00,
currency: 'USD',
product_id: 'pro-annual'
});
Identificando um usuário
Quando um visitante faz login, vinculem a sessão à sua conta com o comando identify:
window.zenovay('identify', 'user_42', {
email: '[email protected]',
plan: 'pro'
});
Você também pode passar um único objeto se preferir:
window.zenovay('identify', {
user_id: 'user_42',
email: '[email protected]',
plan: 'pro'
});
Após essa chamada, o perfil do visitante é armazenado e os eventos subsequentes são associados a essa identidade.
Convenções de nomenclatura de propriedades
Use snake_case (page_section, não pageSection). O dashboard agrupa propriedades alfabeticamente — uma nomenclatura consistente facilita filtros.
O tracker já captura automaticamente o contexto como URL, referenciador, tamanho de tela, navegador, SO e localização aproximada, portanto você não precisa enviá-los por si mesmo.
Limites por plano
Eventos personalizados contam para sua cota mensal de eventos:
| Plano | Eventos mensais |
|---|---|
| Free | 10.000 |
| Pro | 100.000 |
| Scale | 1.000.000 |
| Enterprise | Personalizado |
Armadilhas comuns
- Chamar antes do tracker carregar — envolva as chamadas numa verificação
if (window.zenovay), ou enfileire-as antes do script ser executado. O tracker repete qualquer coisa que você enviar parawindow.zenovay.q:window.zenovay = window.zenovay || function(){(window.zenovay.q = window.zenovay.q || []).push(arguments)}; window.zenovay('track', 'cta_clicked'). - Enviar PII como propriedade — e-mails, nomes e telefones não devem ser enviados como propriedades de evento personalizado. Use o comando
identifypara dados de conta em vez disso. - Modo cookieless +
identify()— no modo cookieless, a chamada identify ainda funciona para a página atual, mas o link é resetado no próximo carregamento de página (sem armazenamento persistente).