Track file downloads
Track when users download files like PDFs, ZIPs, images, or other assets from your website using Vision custom events.
Using data attributes
Add data-vision-event attributes to your download links:
<a
href="/files/report.pdf"
data-vision-event="file-download"
data-vision-event-file="report.pdf"
>
Download Report (PDF)
</a>Each click will record an event named file-download with a file property containing the filename.
Tracking all downloads automatically
Use this script to automatically track clicks on any link pointing to common file types:
<script>
document.addEventListener("DOMContentLoaded", function () {
const fileExtensions =
/\.(pdf|zip|tar|gz|rar|doc|docx|xls|xlsx|ppt|pptx|csv|mp3|mp4|dmg|exe|iso)$/i;
document.querySelectorAll("a[href]").forEach(function (a) {
if (fileExtensions.test(a.href) && !a.getAttribute("data-vision-event")) {
var filename = a.href.split("/").pop().split("?")[0];
a.setAttribute("data-vision-event", "file-download");
a.setAttribute("data-vision-event-file", filename);
}
});
});
</script>This finds all links to downloadable files and adds tracking attributes automatically, without modifying each link by hand.
Viewing download data
- Navigate to your website in Vision.
- Click on Events to see the
file-downloadevent and its counts. - Click on Event data to view a breakdown by the
fileproperty, showing which files are downloaded most.
Tips
- Use consistent event names (e.g., always
file-download) so all downloads are grouped together. - Use the
fileproperty to distinguish between different files rather than creating a separate event name for each file. - If downloads are served from a different domain (like a CDN), the tracking still works since the event fires on the click, not the destination.