More in Product analytics
- Autocapture and the AI event inbox
- Build a funnel that explains drop-off
- Identify users across web, app and mini-programs
- What is autocapture, and how does it work?
- How do I review and accept events in the inbox?
- What are unplanned events, and how do I manage them?
- When should I use a funnel instead of a goal or path?
- How do I build a funnel?
- How do I read where a funnel drops off?
- What is identified mode, and should I turn it on?
- How do I call login to identify a user?
- How is one person merged across devices?
- How does identity work on apps and mini-programs?
- How do I track clicks on outbound links?
- How do I track form submissions?
- How do I track custom events?
- How do I track button clicks?
- How do I create a heatmap?
- How do I track scroll depth?
- How do I track ecommerce purchases and revenue?
- How do I set up goals and track conversions?
- How do I query my data with SQL?
- How do I create a custom metric?
- How do I analyze accounts with groups?
- How do I connect AI agents with MCP?
- How do I ask the AI assistant about my data?
- How do I create user segments?
- How do I run an RFM analysis?
- How do I record and watch session replays?
- How do I analyze user paths?
- How do I build a retention report?
- How do I analyze how an event is distributed?
- How do I create a tracking plan?
- How do I view a user’s profile and activity?
- How do I read the lifecycle report (new, returning, resurrecting, dormant)?
- How do I compare attribution models for a conversion?
- All guides in this category
Still have a question?
Could not find it? A person reads every message, usually within a few hours on business days.
Chat with usShort answer
TapCub tracks downloads automatically: a click on a link ending in a common document, archive or installer extension is recorded as a file download event. Dynamic download URLs are not matched; send a custom event for those.
It is on by default
The TapCub script records a click on a link whose path ends in a common document, archive or installer extension, such as .pdf, .zip or .dmg, as a file download (__download). No code is needed.
Where to see it
Open Web analyticsEvents. File downloads appear with a readable label next to your own events. Open the row to see its properties, such as the file link. To count one file as a conversion, add an event goal with a property condition in Web analyticsGoals.
What is not counted
Downloads are matched by the file extension in the link only.
- Dynamic download links such as
/download?id=42or a link that redirects to a file are not counted. - Files opened directly from another site or an email do not pass through your page, so there is no click to record.
For dynamic links, send your own event when the download starts:
tapcub.track('file_download', { file: 'pricing-guide' });Event naming rules are in the developer docs.
Turn it off
Add data-downloads="false" to the script tag. If downloads are turned off in project settings, the collector drops them even if the script sends them.
Confirm it works
Do the action yourself on the live site, then open Web analyticsRealtime: the event appears within a few seconds. Totals and properties are in Web analyticsEvents.
See also: track outbound links, track custom events and event tracking.
Did this answer your question?
We use your answers to fix and expand this page.
Couldn’t send. Please try again in a minute.
Thanks for the feedback. We’ll use it to improve this page.You’ve already sent feedback on this page. Thanks.