Eventos capturados automaticamente

O Zenovay registra automaticamente quatro tipos de eventos de interação em cada site rastreado. Você não precisa adicionar nenhum código nem chamar zenovay('track', ...) — o script de rastreamento cuida das quatro capturas por padrão.

O que é capturado

Como cada captura funciona

1. Progresso de vídeo

Para qualquer elemento <video> na página, o Zenovay escuta o evento timeupdate e emite um evento video_progress quando o visitante cruza as marcas de 25 %, 50 %, 75 % e 100 %. Os marcos são deduplicados por vídeo e por sessão, então cada um dispara no máximo uma vez.

Os iframes do YouTube e do Vimeo são suportados via postMessage — o Zenovay escuta mensagens de mudança de estado vindas de youtube.com, youtube-nocookie.com e player.vimeo.com. Isso funciona apenas se a página hospedeira já carregar a API iframe do YouTube ou do Vimeo. O Zenovay não inclui esses SDKs no bundle.

Transmissões ao vivo (em que duration === Infinity) emitem somente play e ended — sem marcos, já que não há uma duração fixa a medir.

{
"video_src": "https://example.com/intro.mp4",
"video_title": "Apresentação do produto",
"provider": "html5",
"milestone": 50,
"duration": 120,
"current_time": 60
}

provider é "html5", "youtube" ou "vimeo". milestone é 25, 50, 75 ou 100. duration e current_time são expressos em segundos.

2. Envio de formulário

O Zenovay anexa um listener de fase de captura aos eventos submit em cada <form>. O evento dispara mesmo quando o handler da página chama preventDefault(). Campos registrados:

• form_id — o id do elemento <form>
• form_name — o atributo name do elemento <form>
• form_action — a URL do atributo action
• field_count — o número de campos nomeados no formulário

Os valores digitados nunca são lidos nem transmitidos.

{
"form_id": "newsletter",
"form_name": "newsletter-form",
"form_action": "https://example.com/api/subscribe",
"field_count": 2
}

Qualquer campo pode ser null se o atributo HTML correspondente não estiver definido no elemento do formulário.

3. Upload de arquivo

Quando um visitante seleciona um arquivo via <input type="file">, o Zenovay emite um evento file_upload com o tipo MIME e o tamanho em bytes de cada arquivo:

{
"files": [
  { "type": "application/pdf", "size": 10485760 }
],
"count": 1
}

O conteúdo dos arquivos nunca é lido nem transmitido — somente os metadados que o navegador já expõe pela interface File.

4. Clique

Cliques em elementos <button>, <a href>, [role="button"], <input type="submit"> e <input type="button"> disparam um evento click. Cliques em <div> ou <span> genéricos não são capturados — apenas elementos interativos. Campos registrados:

• selector — um seletor CSS curto que identifica o elemento (limitado a 200 caracteres)
• text — o texto visível do elemento (truncado em 80 caracteres)
• href — a URL de destino, apenas para links
• tag — o nome da tag do elemento ("BUTTON", "A", "INPUT")

O Zenovay não captura cliques em campos <input> do tipo texto, e-mail ou senha, então os valores digitados nunca são registrados — o tracker não tem listener anexado a esses elementos.

{
"selector": "button#signup-cta",
"text": "Cadastre-se grátis",
"href": null,
"tag": "BUTTON"
}

Onde visualizar esses dados

• Por visitante: abra Journeys (na seção Behavior da barra lateral) → clique em qualquer visitante → a aba Timeline mostra cada evento capturado com seu próprio ícone (Play, FileText, Upload, MousePointer).
• Agregado (Pro+): a aba Analytics inclui dois widgets — Video Performance (principais vídeos por taxa de conclusão) e Form Performance (principais formulários por quantidade de envios). Planos Free veem um aviso de upgrade.
• Dashboards públicos compartilhados: qualquer pessoa com uma URL de share token vê os mesmos widgets — visualizações compartilhadas não aplicam restrição de plano.

Privacidade

Valores de formulário, conteúdo de arquivos e valores digitados nunca saem do navegador. O Zenovay registra apenas metadados que o navegador já expõe (estrutura do formulário, tipo MIME, tamanho do arquivo).

O tracker 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 detalhes completos sobre o que é ou não coletado, consulte Conformidade de privacidade.

Desativar capturas individuais

Essas quatro capturas rodam por padrão. Hoje não existe um flag de opt-out por evento; se você precisa desativar alguma por questões de conformidade, escreva para [email protected] — podemos limitar o ajuste ao seu código de rastreamento.

Tópicos relacionados

• Custom Events — disparar seus próprios eventos com zenovay('track', ...)
• Conformidade de privacidade — postura LGPD / GDPR / CCPA e suporte ao GPC
• Goals — converter eventos capturados em metas de conversão