Rastreamento de downloads
Veja quais arquivos seus visitantes baixam, de quais dispositivos e países, e como os downloads evoluem ao longo do tempo — tudo capturado automaticamente, sem alterações de código.
Visão geral
O Zenovay registra automaticamente um evento download_start sempre que um visitante clica em um link para um arquivo para download no seu site. Os dados aparecem no seu painel em app → abra seu site → aba «Downloads».
A aba Downloads é visível apenas para proprietários e membros da equipe autenticados. Ela é intencionalmente ocultada em painéis compartilhados publicamente, pois as URLs e os nomes dos arquivos podem revelar caminhos internos.
O rastreamento de downloads faz parte do script de rastreamento do Zenovay. Ele funciona em conjunto com os Eventos auto-capturados — não é necessária nenhuma instalação ou configuração adicional.
O que é capturado automaticamente
Um evento download_start é disparado quando um visitante clica em qualquer um dos seguintes:
- Um link
<a>cujo caminho termina com uma extensão de arquivo 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, deb, rpm - Qualquer link
<a download>(independente da extensão do arquivo) - Um download de blob gerado por JavaScript (por ex., PDFs gerados dinamicamente)
Como o Zenovay usa navigator.sendBeacon, o evento é enviado de forma confiável mesmo quando o clique aciona um download de arquivo que navega o navegador para fora da página.
Não é necessária nenhuma alteração de código. Uma vez instalado o script de rastreamento do Zenovay, o rastreamento de downloads funciona automaticamente.
Tamanho do arquivo
- Para downloads de mesma origem (arquivos servidos a partir do mesmo domínio que o seu site), o Zenovay captura o tamanho do arquivo automaticamente.
- Para downloads de origem cruzada (arquivos em um domínio diferente), o tamanho do arquivo só é capturado quando a política CORS do servidor de arquivos permite. Quando o CORS não permite, a coluna Tamanho exibe «—».
Tempo de conclusão do download
O tempo de conclusão está disponível apenas para downloads em aplicação ou programáticos (fetch + blob) — por exemplo, um botão que busca um PDF e aciona um download de Blob em JavaScript.
Para links de arquivos comuns gerenciados pelo navegador (o padrão <a href> para um arquivo), o navegador controla toda a transferência. A plataforma web não fornece nenhuma API para medir o tempo de duração do download, portanto a coluna Tempo Médio exibe «—» para esses downloads. Esta é uma limitação genuína do navegador, não do Zenovay.
Se você precisar do tempo de conclusão de um arquivo, implemente o download usando fetch() e URL.createObjectURL(). O Zenovay poderá então medir toda a transferência.
Excluir links individuais
Adicione o atributo data-download a qualquer elemento âncora para excluí-lo completamente do rastreamento de downloads:
<!-- Este link NÃO será rastreado como download -->
<a href="/internal-report.pdf" data-download>Baixar relatório</a>Compatibilidade entre navegadores
O rastreamento de downloads funciona no Chrome, Firefox e Safari. Ele usa navigator.sendBeacon para enviar o evento, o que garante a entrega mesmo quando a navegação de download descarrega a página.
Privacidade
O rastreamento de downloads usa o tracker existente do Zenovay. Ele não adiciona novos cookies ou entradas no localStorage e funciona em modo sem cookies. Visitantes que enviam um sinal de Global Privacy Control ou Do Not Track não são rastreados, portanto seus downloads não aparecerão na aba Downloads — isso é intencional.
Limites por plano
| Plano | Eventos de download por site por dia |
|---|---|
| Free | 100 (limite flexível) |
| Pro | Ilimitado |
| Scale | Ilimitado |
| Enterprise | Ilimitado |
O limite do plano Free é um limite flexível. Eventos acima do limite diário não são contabilizados nos totais exibidos na aba Downloads para aquele dia.
Visualizar os dados de download
Abra o site no aplicativo e vá até a aba Downloads. A aba contém:
| Painel | O que exibe |
|---|---|
| Arquivos mais baixados | URL do arquivo, downloads, downloads únicos, tamanho, tempo médio de conclusão |
| Downloads ao longo do tempo | Tendência de volume de downloads para o intervalo de datas selecionado |
| Por dispositivo | Downloads detalhados por tipo de dispositivo |
| Por país | Downloads detalhados por país do visitante |
| Por fonte | Downloads detalhados por fonte de tráfego |
| Resumo de conclusão | Proporção de downloads com tempo de conclusão registrado em relação aos gerenciados pelo navegador |
Intervalo de datas
- Os intervalos de 7 dias e 30 dias estão disponíveis em todos os planos.
- O intervalo de 90 dias requer o plano Scale ou Enterprise.
Relacionado
- Eventos auto-capturados — outros eventos que o Zenovay captura automaticamente (vídeo, formulários, cliques)
- Eventos personalizados — dispare seus próprios eventos com
zenovay('track', ...) - Conformidade com privacidade — tratamento de GPC e Do Not Track