WebmasterID logoWebmasterID
Event tracking

The user_engagement event

user_engagement is the GA4 event that carries active engagement time. The SDK and tag send it periodically — and when the page or app goes to the background — to report how long the user was actively engaged via the engagement_time_msec parameter. It underpins engaged sessions, engagement rate, and average engagement time. It measures attention duration, never who the user is.

Verified against primary sources

What this means

user_engagement is sent by GA4 to report engagement time accumulated since the last such event, via engagement_time_msec. On the web the tag sends it when the page is hidden or unloaded; in apps the SDK sends it when the app goes to the background, plus periodically. Engaged sessions, engagement rate, and average engagement time are all computed from these reported durations.

Why timing of the event matters

Because user_engagement is sent on backgrounding (and periodically), an interaction that never backgrounds — a very short visit closed abruptly, or certain SPA flows — can under-report engagement time. Understanding that the metric depends on these dispatch points explains apparent gaps: the user was engaged, but the event that records it had not fired yet. The value is always a duration measured from visibility and focus, carrying no personal data.

How it appears in analytics and logs

Missing or sparse user_engagement events make engagement metrics look low; they are sent on backgrounding, so a tab never backgrounded may under-report.

Diagnostic use case

Understand where engaged-session and engagement-rate numbers come from by knowing user_engagement reports active foreground time periodically.

What WebmasterID can help detect

WebmasterID can derive active engagement time from first-party visibility signals, providing the same attention measure without cookies or cross-site tracking.

Common mistakes

Privacy and accuracy notes

user_engagement carries a duration (engagement_time_msec), not an identity. Active-time measurement needs visibility and focus signals, not personal data. This is educational, not legal advice.

Related pages

Sources and verification notes

Last reviewed 2026-06-24. Facts are checked against primary/official sources where available; uncertain specifics are marked “Data not yet verified” rather than guessed.