O rastreamento de downloads registra sempre que um visitante baixa um arquivo do seu site. O script de rastreamento captura esses eventos automaticamente assim que é instalado — sem necessidade de alterações de código, em todos os planos. Para visualizar os dados, abra o painel do seu website e selecione a aba Downloads, que é parte da função Download Analytics no Pro e superiores.
O que conta como download
O Zenovay registra um download quando um visitante aciona qualquer um dos seguintes elementos:
- Um link para um arquivo para download — um
<a href>cujo caminho de URL termina com uma extensão reconhecida:pdf,zip,exe,dmg,pkg,msi,apk,csv,xls,xlsx,doc,docx,ppt,pptx,mp4,mp3,wav,mov,avi,rar,7z,tar,gz,tgz,iso,debourpm. - Qualquer link
<a download>— independentemente da extensão do arquivo, se a âncora tiver o atributodownload, o Zenovay o trata como um download de arquivo. - Um download gerado por JavaScript (blob) — quando o seu código cria uma URL
blob:temporária e aciona uma caixa de diálogo para salvar.
Onde ver
Abra o painel do seu website e selecione a aba Downloads (sob o grupo Audience na barra lateral). Esta visualização é parte do Download Analytics, disponível nos planos Pro, Scale e Enterprise. A aba é visível apenas para proprietários e membros da equipe conectados — não é exibida em painéis públicos ou compartilhados, pois caminhos e nomes de arquivos podem expor estruturas internas que você talvez não queira compartilhar publicamente.
A aba exibe:
- Arquivos mais baixados — uma tabela ordenada por número de downloads, com número de baixadores únicos, tamanho do arquivo (quando disponível) e tempo médio de conclusão (quando mensurável).
- Downloads ao longo do tempo — um gráfico de áreas do volume de downloads para o período selecionado.
- Detalhamentos — downloads segmentados por tipo de dispositivo, país e fonte de tráfego.
- Conclusão de downloads — um resumo de quantos downloads foram confirmados como completos (aplica-se a downloads blob/fetch onde o tempo é mensurável, e a links gerenciados pelo navegador que informam um tamanho).
Intervalos de datas e retenção de dados
| Plano | Retenção de dados analíticos |
|---|---|
| Gratuito | 1 ano |
| Pro | 2 anos |
| Scale | 4 anos |
| Enterprise | Personalizado |
Tamanho do arquivo e tempo de conclusão
O tamanho do arquivo é exibido para downloads de mesma origem (arquivos servidos a partir do seu próprio domínio). Para arquivos de origem externa (hospedados em um CDN ou domínio de terceiros), o tamanho só está disponível quando o servidor de arquivos inclui cabeçalhos CORS permissivos — caso contrário, a coluna exibe "—".
O tempo de conclusão é mensurável apenas para downloads blob e fetch, onde o navegador delega a transferência ao JavaScript e o Zenovay pode observar quando ela termina. Para links de arquivo <a href> comuns, o navegador gerencia completamente a transferência em seu próprio gerenciador de downloads e não há como interceptar o sinal de conclusão — a coluna exibe "—" para essas linhas. Este é o comportamento esperado, não uma lacuna de rastreamento.
Como excluir um link específico
Se você tiver um link que atende aos critérios de download, mas não deseja que ele seja rastreado, adicione o atributo data-download à âncora:
<a href="/files/report.pdf" data-download>Baixar relatório (não rastreado)</a>
O Zenovay suprime o rastreamento de qualquer elemento <a> que contenha o atributo data-download.
Compatibilidade com navegadores
O rastreamento de downloads funciona no Chrome, Firefox e Safari.
Privacidade
O rastreamento de downloads usa o mesmo tracker que já está na sua página — não introduz novos cookies nem usa localStorage. Funciona no modo sem cookies, onde identificadores em memória com escopo de janela são usados em vez de armazenamento persistente. Visitantes que enviam um sinal Global Privacy Control ou Do Not Track não são rastreados por design e não aparecerão na aba.
Como testar
- Abra uma página do seu site que contenha um link para um arquivo para download.
- Clique no link para acionar um download.
- Faça login em
app.zenovay.com, abra o site e selecione a aba Downloads.
O download deve aparecer em alguns segundos. Se não aparecer, confirme que o script de rastreamento está instalado e que o link corresponde a uma das extensões ou atributos listados acima.