Document measurement · 6 min read
How to Measure Document Engagement
A practical guide to measuring hosted PDF sessions, page turns, active time, downloads, and the parts browser PDF viewers hide.
Updated October 23, 2026 · Definitions and caveats are stated in the text.
Choose a viewer that can emit the events you need
A hosted document viewer can record a document-open event, page turns made through its own controls, bounded activity heartbeats, and clicks on its download button. These are observations from that viewer—not a complete record of what a reader did with a file after downloading it.
A browser's native PDF controls may handle scrolling or saving outside the page's own event hooks. A page view should therefore be described as a page turn recorded through the hosted viewer, not proof that every page was read.
Use real denominators for completion
Completion needs a known page count and an explicit session denominator. A defensible rule might count a viewer session as having reached the last page when the viewer's page controls report that page. If the PDF's page tree is compressed or otherwise unreadable to the page-count detector, the denominator is unknown and completion should be unavailable.
Keep opens, viewer sessions, page views, active seconds, and downloads as separate metrics. One person can reload or open a document more than once; a session count is not necessarily a unique-person count.
- Use private storage and opaque, revocable viewer tokens.
- Restrict file type and size, and remove stored bytes when the document is purged.
- Set expiry and retention to match the document's purpose.
Explain automation and access controls
Email security systems may fetch a shared document URL before a person views it. Keep automated-suspected requests distinguishable from likely reader sessions, but do not call a heuristic certain. A passcode or expiry can control access; neither proves who accessed the file.
If you export document analytics, minimize fields. A report generally needs counts and timestamps, not recipient email addresses, raw IP addresses, or full browser user-agent strings.
Questions
Can I tell whether someone read every page?
Not with certainty. The viewer can record page turns through its own controls, but native PDF actions and offline reading may not be visible.
Does a download count as a completed read?
No. A download-button click is a download request. Reading after download occurs outside the hosted viewer and is not measured here.