This article is about Google Analytics 4 properties. Refer to the Universal Analytics section if you're still using a Universal Analytics property, which will stop processing data on July 1, 2023 (October 1, 2023 for Analytics 360 properties).

[GA4] Enhanced measurement events

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 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

  1. Sign in to Google Analytics..
  2. Click Admin, and navigate to the property you want to edit.
  3. In the Property column, click Data Streams > Web.
  4. 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 and parameters

The following table explains when events are triggered, and which parameters are collected for each event. You can find 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.

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.

No parameters are collected

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 performs a site search, 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 parameters in the URL:
  • q
  • s
  • search
  • query
  • keyword

You can optionally configure this option to look for search terms in other 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)

Video engagement

video_start

video_progress

video_complete

For 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_domain, 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

Note: You can only use these 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?

Need more help?

Sign in for additional support options to quickly solve your issue

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
69256
false
false