[GA4] Enhanced measurement events

Discover how to enable and disable enhanced measurement events and learn more about which parameters are collected for each event.

Enhanced measurement lets you measure interactions with your content by enabling options (events) in the Google Analytics interface. No code changes are required. When you enable these options for a web data stream, your Google Analytics tag starts sending events right away.

Before turning on the enhanced measurement feature, be sure you understand each option and what enhanced data will be collected. You can also turn off specific measurement options in settings.

You're required to ensure that no personally identifiable information is collected.

Enable or disable enhanced measurement events

  1. In Admin, under Data collection and modification, click Data streams.
    Note: The previous link opens to the last Analytics property you accessed. You can change the property using the property selector. You must be an Editor or above at the property level to enable or disable enhanced measurement events.
  2. Click the name of your data stream.
  3. Under Enhanced measurement, slide the switch On to enable all options.
    Click Settings to edit individual options as needed.

Enable enhanced measurement slider

If you use the Google tag on your website, you also need to make sure that each event is enabled for automatic event detection for your Google tag. By default, all event types are enabled. Learn more about your Google tag settings

Events measurement and parameters

The following table explains when events are triggered, and which parameters are collected for each event. You can find enhanced data about each triggered event in the Events report within the Engagement topic. Click the event name in the report for more information on the event.

To understand each event parameter listed below and how each parameter updates a dimension or metric in Google Analytics, see Google Analytics event parameters.

Measurement option / event Triggered... Parameters

Page views

page_view

each time the page loads or the browser history state is changed by the active site

This event is collected automatically. You cannot turn off collection.

An advanced setting on this option controls whether the event is sent based on browser-history events. This measurement option listens for pushState, popState, and replaceState.

The event populates the Views metric. The parameters populate the following dimensions:

page_location (page URL), page_referrer (previous page URL)

Scrolls

scroll

the first time a user reaches the bottom of each page (i.e., when a 90% vertical depth becomes visible)

The event populates the Percent scrolled dimension.

engagement_time_msec

Outbound clicks

click

each time a user clicks a link that leads away from the current domain

By default, outbound click events will occur for all links leading away from the current domain. Links to domains configured for cross-domain measurement will not trigger outbound click events.

The parameters populate the following dimensions:

link_classes, link_domain, link_id, link_url, outbound (boolean)

Site search

view_search_results

each time a user is presented with a search results page, as indicated by the presence of a URL query parameter

By default, the event is triggered based on the presence of one of the following 5 query parameters in the URL:
  • q
  • s
  • search
  • query
  • keyword

You can optionally configure this event to look for other URL query parameters.

The search_term parameter populates the Search term dimension.

search_term, optionally ‘q_<additional key="">’ (where <additional key=""> matches an additional query parameter you specify to be collected under advanced settings).

Note: This event only sends the unique_search_term parameter when it has a value of 1 (i.e. when the string is unique to that session).

Video engagement

video_start

video_progress

video_complete

For YouTube embedded videos that have JS API support enabled, the following events are triggered:
  • video_start: when the video starts playing
  • video_progress: when the video progresses past 10%, 25%, 50%, and 75% duration time
  • video_complete: when the video ends

The parameters populate the following dimensions:

video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean)

File downloads

file_download

when a user clicks a link leading to a file (with a common file extension) of the following types:
  • document
  • text
  • executable
  • presentation
  • compressed file
  • video
  • audio

File extensions that match the following regex will trigger the event:

pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|
7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma

The parameters populate the following dimensions:

file_extension, file_name, link_classes, link_id, link_text, link_url

Form interactions

form_start

form_submit

'form_start': the first time a user interacts with a form in a session

'form_submit': when the user submits a form

You can use these two events to see how many users started to fill out a form and compare the information to users who submitted the form.

Note: You can only use the parameters in your reports if you create custom dimensions for them.

form_start

  • form_id: HTML id attribute of the <form> DOM element
  • form_name: HTML name attribute of the <form> DOM element
  • form_destination: URL to which the form is being submitted

form_submit

  • form_id: HTML id attribute of the <form> DOM element
  • form_name: HTML name attribute of the <form> DOM element
  • form_destination: URL to which the form is being submitted
  • form_submit_text: text of the submit button, if present

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Main menu
4850468873939260897
true
Search Help Center
true
true
true
true
true
69256
true
false