O Zenovay rastreia automaticamente quatro tipos de eventos de interação em qualquer site que carregue o script de rastreamento — sem código, sem configuração extra. Este artigo explica o que é registrado, o que não é, e onde encontrar os dados no dashboard.
Os quatro eventos capturados automaticamente
| Evento | O que o Zenovay registra | O que o Zenovay nunca registra |
|---|---|---|
| Progresso de vídeo (HTML5, YouTube, Vimeo) | URL de origem, provedor, marco (25 / 50 / 75 / 100 %), duração | Conteúdo do vídeo |
| Envio de formulário | ID do formulário, nome, URL de ação, número de campos | Valores digitados |
| Upload de arquivo | Tipo de arquivo (ex.: application/pdf), tamanho do arquivo | Conteúdo do arquivo |
| Clique | Seletor CSS, texto visível, URL de destino (para links) | Valores digitados |
Progresso de vídeo
Sempre que um visitante reproduz um <video> HTML5 na sua página, o Zenovay registra um marco ao cruzar 25 %, 50 %, 75 % e 100 % do clipe. Cada marco dispara uma vez por vídeo e por sessão.
Embeds de YouTube e Vimeo também funcionam — mas apenas se a sua página já carregar a API iframe do YouTube ou do Vimeo. O Zenovay nunca injeta esses SDKs no seu lugar. Se você incorporar um vídeo do YouTube sem a tag da API, apenas a detecção HTML5 se aplica (que não funciona em iframes cross-origin).
Transmissões ao vivo não produzem eventos de marco, portanto não aparecem em seus dados de vídeo.
Envio de formulário
A cada submissão de um <form> na sua página, o Zenovay registra o id, o name, a URL de action e a quantidade de campos. O evento dispara mesmo quando o seu código chama preventDefault() para tratar o submit em JavaScript (comum em apps de página única).
{
"form_id": "newsletter",
"form_name": "newsletter-form",
"form_action": "https://example.com/api/subscribe",
"field_count": 2
}
Os valores dos campos — o que o visitante digita — nunca são lidos nem transmitidos ao Zenovay.
Upload de arquivo
Quando um visitante seleciona um arquivo via <input type="file">, o Zenovay registra o tipo do arquivo (o tipo MIME reportado pelo navegador) e o tamanho em bytes. Um PDF de 10 MB, por exemplo, aparece assim:
{
"files": [
{ "type": "application/pdf", "size": 10485760 }
],
"count": 1
}
O conteúdo do arquivo nunca sai do navegador do visitante — o Zenovay só lê os metadados que o navegador já expõe pela interface File padrão.
Clique
Cliques em elementos <button>, <a href> (links), [role="button"] e <input type="submit"|"button"> são capturados automaticamente. Cliques em <div> e <span> genéricos não são — para manter os dados limpos e evitar contar duas vezes containers de layout. O Zenovay registra um seletor CSS curto que identifica o elemento, o texto visível (truncado) e a URL de destino, no caso de links.
{
"selector": "button#signup-cta",
"text": "Sign up free",
"href": null,
"tag": "BUTTON"
}
Como o Zenovay só escuta botões e links, nenhum texto de campos <input> (caixas de busca, campos de senha, etc.) é nunca capturado.
Progresso de vídeo (exemplo de payload)
{
"video_src": "https://example.com/intro.mp4",
"video_title": "Product intro",
"provider": "html5",
"milestone": 50,
"duration": 120,
"current_time": 60
}
provider é um de html5, youtube ou vimeo. milestone é um de 25, 50, 75 ou 100.
Onde encontrar esses dados
Acesse app.zenovay.com e selecione o site que deseja inspecionar.
Linha do tempo por visitante
- Abra o dashboard do seu site e selecione a aba Journeys (na seção Audience da barra lateral).
- Vá para a aba Users.
- Clique em qualquer linha da lista de usuários para abrir o painel de detalhes desse visitante — a linha do tempo carrega dentro dele.
Cada evento capturado automaticamente aparece como uma linha própria com um ícone dedicado:
| Ícone | Evento | O que você vê |
|---|---|---|
| Play | Progresso de vídeo | "Watched video" + duração + marco atingido |
| FileText | Envio de formulário | "Submitted form" + nome ou ID do formulário |
| Upload | Upload de arquivo | "Uploaded file" + tamanho em MB + tipo MIME |
| MousePointer | Clique | "Clicked: …" + texto visível do botão ou link |
Os eventos aparecem em ordem cronológica. A mesma visão está disponível em qualquer gráfico ou popover de globo que leve a um visitante específico.
Cards agregados na aba Analytics de cada site (Pro e superior)
Abra qualquer site do seu dashboard e fique na aba Analytics. Você encontrará dois cards novos para os eventos que o Zenovay captura automaticamente:
-
Video Performance — seus principais vídeos. Use as abas no topo do card para alternar entre:
- Plays — ordenado por número total de reproduções.
- Completion — ordenado por taxa de conclusão (com que frequência os visitantes atingem o marco de 100 %).
Cada linha exibe o vídeo, um favicon do domínio de origem e a contagem. Clique em Details para abrir um modal com a tabela completa e ordenável — todos os vídeos, todas as colunas, a ordem de sua escolha.
-
Form Performance — seus principais formulários. Use as abas no topo do card para alternar entre:
- Submits — ordenado por número total de envios.
- Rate — ordenado por taxa de envio (envios por visita).
Cada linha exibe o formulário, um favicon do domínio de origem e a contagem. O botão Details abre a mesma tabela completa e ordenável.
Os dois cards respeitam o seletor de período e quaisquer filtros ativos no topo da página.
Os planos Free veem um aviso de upgrade no lugar dos dados. Os planos Pro, Scale e Enterprise veem os dados na hora.
Dashboards públicos compartilhados
Se você compartilhar um dashboard por um link público, qualquer pessoa com o link vê os mesmos cards de Video Performance e Form Performance — visualizações compartilhadas não aplicam restrição de plano.
Solução de problemas: Não vejo nenhum dado
Alguns motivos comuns pelos quais os cards Video Performance e Form Performance permanecem vazios:
- Código de rastreamento novo — os eventos aparecem em poucos segundos após a primeira interação real, mas se seu site ainda não tem visitantes, os cards permancem vazios até a chegada de tráfego.
- Embed de YouTube / Vimeo sem sua API iframe — o Zenovay depende de eventos
postMessageque só fluem se sua página já carrega a API do player YouTube ou Vimeo. Se você incorporar um vídeo do YouTube com apenas uma tag<iframe>simples, os marcos não serão acionados. Adicione o script da API iframe do YouTube ou Vimeo à sua página para corrigir isso. Sec-GPC: 1(Global Privacy Control) está ativado para o visitante — os eventos continuam sendo registrados, mas a linha do visitante é marcada e excluída do enriquecimento comportamental. Os totais nos cards continuam sendo atualizados.- Plano Free — os cards mostram um aviso de upgrade em vez de dados em planos Free. Faça upgrade para Pro para visualizar.
Se nenhuma dessas opções se aplica e os cards permanecem vazios por mais de 10 minutos após uma interação conhecida, contate o suporte.
Garantias de privacidade
Duas coisas nunca saem do navegador do visitante:
- Os valores de formulário — o que as pessoas digitam nos seus campos (nomes, e-mails, buscas, qualquer coisa).
- O conteúdo dos arquivos — o que está realmente dentro de um arquivo enviado.
O Zenovay só vê os metadados que o navegador expõe por padrão: estrutura do formulário, tipos MIME e tamanhos de arquivo. O tracker também respeita o sinal Sec-GPC: 1 (Global Privacy Control) de ponta a ponta — quando o GPC está presente, nenhum enriquecimento comportamental é executado e o registro do visitante é marcado de acordo.
Para o detalhamento completo do que é ou não coletado, veja O Zenovay usa cookies? e a página Privacidade e conformidade.
Dá para desligar capturas individuais?
Essas quatro capturas rodam por padrão e hoje não existe um flag de opt-out por evento no dashboard. Se você precisa desativar alguma por uma exigência específica de conformidade (por exemplo, seu setor proíbe qualquer log de metadados de formulário), escreva para [email protected] — podemos limitar o ajuste ao seu código de rastreamento.