Ir al contenido principal
Zenovay
Pro Plan5 minutesPrincipiante

¿Cómo rastrea Zenovay las descargas de archivos en mi sitio web?

Zenovay registra automáticamente las descargas de archivos cuando los visitantes hacen clic en enlaces de descarga — sin cambios de código. Aquí te explicamos qué se rastrea, dónde verlo y cómo excluir un enlace específico.

downloadsfile-trackingtracker-api
Última actualización:

El rastreo de descargas registra cada vez que un visitante descarga un archivo de tu sitio. El script de rastreo captura estos eventos automáticamente apenas está instalado — sin necesidad de cambios de código, en todos los planes. Para ver los datos, abre el panel de tu sitio web y selecciona la pestaña Downloads, que es parte de la función Download Analytics en Pro y superiores.

Qué cuenta como descarga

Zenovay registra una descarga cuando un visitante activa cualquiera de los siguientes elementos:

  • Un enlace a un archivo descargable — un <a href> cuya ruta de URL termina en una extensión reconocida: 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 o rpm.
  • Cualquier enlace <a download> — independientemente de la extensión del archivo, si el anclaje tiene el atributo download, Zenovay lo trata como una descarga de archivo.
  • Una descarga generada por JavaScript (blob) — cuando tu código crea una URL blob: temporal y activa un diálogo de guardado.

Dónde verlo

Abre el panel de tu sitio web y selecciona la pestaña Downloads (bajo el grupo Audience en la barra lateral). Esta vista es parte de Download Analytics, disponible en los planes Pro, Scale y Enterprise. La pestaña solo es visible para propietarios y miembros del equipo que han iniciado sesión — no se muestra en paneles públicos o compartidos, ya que las rutas y nombres de archivos pueden exponer estructuras internas que quizás no desees compartir públicamente.

La pestaña muestra:

  • Archivos más descargados — una tabla ordenada por número de descargas, con número de descargadores únicos, tamaño del archivo (cuando está disponible) y tiempo medio de finalización (cuando es medible).
  • Descargas a lo largo del tiempo — un gráfico de áreas del volumen de descargas para el período seleccionado.
  • Desgloses — descargas segmentadas por tipo de dispositivo, país y fuente de tráfico.
  • Finalización de descargas — un resumen de cuántas descargas se confirmaron como completas (se aplica a descargas blob/fetch donde el tiempo es medible, y a enlaces gestionados por el navegador que reportan un tamaño).

Rangos de fechas y retención de datos

PlanRetención de datos analíticos
Gratuito1 año
Pro2 años
Scale4 años
EnterprisePersonalizado

Tamaño del archivo y tiempo de finalización

El tamaño del archivo se muestra para descargas del mismo origen (archivos servidos desde tu propio dominio). Para archivos de origen externo (alojados en un CDN o un dominio de terceros), el tamaño solo está disponible si el servidor de archivos incluye cabeceras CORS permisivas — de lo contrario la columna muestra "—".

El tiempo de finalización solo es medible para descargas blob y fetch, donde el navegador delega la transferencia a JavaScript y Zenovay puede observar cuándo termina. Para los enlaces de archivo <a href> ordinarios, el navegador gestiona completamente la transferencia en su propio gestor de descargas y no hay forma de interceptar la señal de finalización — la columna muestra "—" para esas filas. Este es el comportamiento esperado, no una brecha de rastreo.

Cómo excluir un enlace específico

Si tienes un enlace que cumple los criterios de descarga pero no quieres que sea rastreado, añade el atributo data-download al anclaje:

<a href="/files/report.pdf" data-download>Descargar informe (no rastreado)</a>

Zenovay suprime el rastreo de cualquier elemento <a> que lleve el atributo data-download.

Compatibilidad con navegadores

El rastreo de descargas funciona en Chrome, Firefox y Safari.

Privacidad

El rastreo de descargas usa el mismo tracker que ya está en tu página — no introduce nuevas cookies ni usa localStorage. Funciona en modo sin cookies, donde se usan identificadores en memoria limitados a la ventana en lugar de almacenamiento persistente. Los visitantes que envían una señal Global Privacy Control o Do Not Track no son rastreados por diseño y no aparecerán en la pestaña.

Cómo probarlo

  1. Abre una página de tu sitio que contenga un enlace a un archivo descargable.
  2. Haz clic en el enlace para activar una descarga.
  3. Inicia sesión en app.zenovay.com, abre ese sitio web y selecciona la pestaña Downloads.

La descarga debería aparecer en unos pocos segundos. Si no la ves, confirma que el script de rastreo está instalado y que el enlace corresponde a una de las extensiones o atributos listados arriba.

Artículos relacionados

¿Fue útil este artículo?