[GA4] Analytics event parameters

The following table lists most of the event parameters from automatically collected events, enhanced measurement events, and recommended events. Enhanced measurement events are collected automatically when enhanced measurement is enabled. The table includes a description of each event parameter and the dimension or metric you can use to see the event parameter in reports and explorations, if a dimension or metric is available.

Note: For more details on the specific data types for each parameter, see our developer reference documentation describing events and their parameters.
CategoryEvent parameterSourceTypeDescriptionDimension or metric
Appapp_versionAutomatically collected eventDimension: textThe mobile app's versionName (Android) or short bundle version (iOS) in which an event occurred.App version
Appcancellation_reasonAutomatically collected eventDimension: textThe reason a cancellation occurred.(None)
AppfatalAutomatically collected eventDimension: booleanWhether an exception was fatal.

Example value: False.

The event is sent when you integrate Firebase Crashlytics.

(None)
Appfirebase_errorAutomatically collected eventDimension: numberThe error code reported by the Firebase SDK.

Example value: 4.

Learn more about the error codes

(None)
Appfirebase_error_valueAutomatically collected eventDimension: textAdditional details corresponding to the error code reported by the Firebase SDK.

Learn more about the error codes

(None)
Appfirebase_screenManualDimension: textThe current screen’s name, as provided by the developer.

Learn how Google Analytics measures app screen views

Page title and screen name
Appfirebase_screen_classAutomatically collected eventDimension: textThe current screen’s class name.

Learn how Analytics measures screenviews

Page title and screen class
Appfirebase_screen_idAutomatically collected eventDimension: textA random identifier for the current screen.

Learn how Google Analytics measures app screen views

(None)
Appfree_trialAutomatically collected eventDimension: numberSignifies that an in-app purchase is a free trial.

Example value: 1.

Learn about the Play integration

(None)
Appmessage_device_timeAutomatically collected eventDimension: numberThe Firebase Cloud Messaging or Firebase In-App Messaging delivery epoch timestamp in UTC.(None)
Appmessage_idAutomatically collected eventDimension: textThe Firebase Cloud Messaging or Firebase In-App Messaging message identifier, which is unique per message campaign.(None)
Appmessage_nameAutomatically collected eventDimension: textThe Firebase Cloud Messaging or Firebase In-App Messaging message name.(None)
Appmessage_timeAutomatically collected eventDimension: numberThe Firebase Cloud Messaging message notification epoch timestamp in UTC.(None)
Appmessage_typeAutomatically collected eventDimension: textThe Firebase Cloud Messaging message notification type.(None)
Appprevious_app_versionAutomatically collected eventDimension: textFor the app_update event, the parameter signifies the previous application version.

Example value: 1.0.1.

(None)
Appprevious_first_open_countAutomatically collected eventMetric: numberThe number of times first_open was logged.(None)
Appprevious_os_versionAutomatically collected eventDimension: textFor the os_update event, the parameter signifies the previous OS version.

Example value: 4.4.2.

(None)
AppsubscriptionAutomatically collected eventMetric: numberSignifies that an in-app purchase is a subscription.

Example value: 1.

Learn about the Play integration

(None)
Appupdated_with_analyticsAutomatically collected eventMetric: numberSignifies that the first_open event was logged due to an update to a new version of the app that integrates Analytics.(None)
Attribution / Traffic sourcecampaign_contentAutomatically collected eventDimension: textThe ad content that was associated with the start of a session.First user manual ad content

Session manual ad content

Attribution / Traffic sourcecampaign_mediumAutomatically collected eventDimension: textThe method for acquiring users to your website or application.Medium

Source / medium

First user medium

First user source / medium

Session medium

Session source / medium

Attribution / Traffic sourcecampaign_sourceAutomatically collected eventDimension: textA representation of the publisher or inventory source from which traffic originated. For example, users who return to your website from Google Search show as "google" in the Session source dimension.Source

Source / medium

First user source

First user source / medium

Session source

Session source / medium

Attribution / Traffic sourcecampaign_termAutomatically collected eventDimension: textThe term that was associated with the start of a session. First user manual term

Session manual term

Ecommerce > Item scopedaffiliationRecommended eventDimension: textA product affiliation to designate a supplying company or brick and mortar store location.

Example value: Google Merchandise Store.

Item affiliation
Ecommerce > Item scopedcouponRecommended eventDimension: text

The coupon name or code associated with an event.

Example value: SUMMER_FUN.

Event-level and item-level coupon parameters are independent.

Item coupon
Ecommerce > Event scopedcouponRecommended eventDimension: text

The coupon name or code associated with an event.

Example value: SUMMER_FUN.

Event-level and item-level coupon parameters are independent.

Order coupon
Ecommerce > Item scopedcreative_nameRecommended eventDimension: textThe name of a creative used in a promotion. Example value: summer_banner.Item promotion creative name
Ecommerce > Item scopedcreative_slotRecommended eventDimension: textThe name of the promotional creative slot associated with an event. Example value: featured_app_1.Item promotion creative slot
Ecommerce > Event scopedcurrencyRecommended eventDimension: textThe currency used in an event, in 3-letter ISO 4217 format. For example, the currency used in a purchase.

Learn more about currencies

Currency
Ecommerce > Item scopeddiscountRecommended eventDimension: textThe value of a discount value associated with a purchased item.

Example value: 2.22.

Item discount amount
Ecommerce > Item scopedindexRecommended eventDimension: textThe index of the item in a list.

Example value: 5.

Item list position
Ecommerce > Item scopeditem_brandRecommended eventDimension: textThe brand of an item.

Example value: Google.

Item brand
Ecommerce > Item scopeditem_categoryRecommended eventDimension: textThe category of an item. If used as part of a category hierarchy or taxonomy, then this is the first category.

Example value: Apparel.

Item category
Ecommerce > Item scopeditem_category2Recommended eventDimension: textThe second hierarchical category in which you classified an item.

Example value: Adult.

Item category 2
Ecommerce > Item scopeditem_category3Recommended eventDimension: textThe third hierarchical category in which you classified an item.

Example value: Shirts.

Item category 3
Ecommerce > Item scopedItem_category4Recommended eventDimension: textThe fourth hierarchical category in which you classified an item.

Example value: Crew.

Item category 4
Ecommerce > Item scopedItem_category5Recommended eventDimension: textThe fifth hierarchical category in which you classified an item.

Example value: Short sleeve.

Item category 5
Ecommerce > Item scopeditem_idRecommended eventDimension: textThe ID that you specify for an item.

Example value: SKU_12345.

Item ID
Ecommerce > Item scopeditem_list_idRecommended eventDimension: textThe name of the list in which an item was presented to a user.

Example value: related_products.

Item list ID
Ecommerce > Item scopeditem_list_nameRecommended eventDimension: textThe ID of the list in which an item was presented to a user.

Example value: Related Products.

Item list name
Ecommerce > Item scopeditem_nameRecommended eventDimension: textThe name of the event that contains the parameter group.

Example value: purchase.

Item name
Ecommerce > Item scopeditem_variantRecommended eventDimension: textThe item variant or unique code or description (e.g., XS, S, M, L for size; Red, Blue, Green, Black for color) for additional item details or options.

Example value: green.

Item variant
Ecommerce > Item scopedlocation_idRecommended eventDimension: textThe physical location associated with the item (e.g. the physical store location).

It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used.

Example value: ChIJIQBpAG2ahYAR_6128GcTUEo.

Item location ID
Ecommerce > Item scopedpriceRecommended eventMetric: numberThe monetary price of an item, in units of the specified currency parameter. Local item price

Item revenue

Ecommerce > Item scopedpromotion_idRecommended eventDimension: textThe ID of the promotion associated with an event. Item promotion ID
Ecommerce > Item scopedpromotion_nameRecommended eventDimension: textThe name of the promotion associated with an event.Item promotion name
Ecommerce > Item scopedquantityRecommended eventMetric: number The item quantity.

Item quantity

Quantity

Ecommerce > Event scopedshippingRecommended eventDimension: numberThe shipping cost associated with a transaction.

Example value: 3.33

Shipping amount
Ecommerce > Event scopedshipping_tierRecommended eventDimension: textThe shipping tier selected for delivery of a purchased item.

Example value: Ground, Air, Next-day.

Shipping tier
Ecommerce > Event scopedtaxRecommended eventDimension: numberThe tax cost associated with a transaction.

Example value: 1.11

Tax amount
Ecommerce > Event scopedtransaction_idRecommended eventDimension: textThe unique identifier of a transaction.

Example value: T12345.

Transaction ID

Lifetime transactions

Ecommerce > Event scopedvalueRecommended eventDimension: textThe monetary value of the event.

Example value: 30.03.

Event value
EventvalueAutomatically collected eventMetric: numberThe value associated with an event.

Example value: 22.

Event value
Gamingachievement_idRecommended eventDimension: textThe ID of an achievement that was unlocked in a game.

Example value: achieved_level_10.

Achievement ID
GamingcharacterRecommended eventDimension: textThe name of a character in a game.

Example value: Wolverine.

Character
GaminglevelRecommended eventMetric: numberThe level of a character in a game.

Example value: 5.

Level
Gaminglevel_nameRecommended eventDimension: textThe name of the level in a game.

Example value: The journey begins...

(None)
GamingscoreRecommended eventMetric: numberThe score in a game.

Example value: 238174.

(None)
Gamingvirtual_currency_nameRecommended eventDimension: textThe name of a virtual currency.

Example value: Gems.

Virtual currency name
Generalfile_extensionEnhanced measurement eventDimension: textThe extension of a file download.

Example values: pdf, txt.

File extension
Generalfile_nameEnhanced measurement eventDimension: textThe page path of a file download.

Example value: myfile.pdf.

File name
Generalform_destinationEnhanced measurement eventDimension: textThe URL to which a form is being submitted.(None)
Generalform_idEnhanced measurement eventDimension: textThe HTML id attribution of the <form> DOM element.(None)
Generalform_nameEnhanced measurement eventDimension: textThe HTML name attribute of the <form> DOM element.(None)
Generalform_submit_textEnhanced measurement eventDimension: textThe text of the submit button, if present.(None)
Generalgroup_idRecommended eventDimension: textThe ID of a group.Group ID
GenerallanguageAutomatically collected eventDimension: textThe language setting of a user’s browser or device, displayed as the ISO 639 language code.

Example value: en-us.

Language
Generalpercent_scrolledEnhanced measurement eventDimension: textThe percentage down the page that the user scrolled.

Example value: 90.

Percent scrolled
Generalsearch_termEnhanced measurement eventDimension: textThe strings or keywords used in a search.Search term
GeneralsuccessRecommended eventDimension: booleanThe result of an operation. Specify 1 to indicate success and 0 to indicate failure.(None)
GeneralvisibleAutomatically collected eventDimension: booleanSet to 'true' if an embedded video is visible to the user.

Example value: 1.

Visible
Linklink_classesEnhanced measurement eventDimension: textThe HTML class attribute for an outbound link or file download.Link classes
Linklink_domainEnhanced measurement eventDimension: textThe destination domain of an outbound link or file download.

Example value: google.com

Link domain
Linklink_idEnhanced measurement eventDimension: textThe ID for an outbound link or file download.

Example value: abcdefg.

Link ID
Linklink_urlEnhanced measurement eventDimension: textThe full URL for an outbound link or file download.

Example value: https://www.google.com.

Link URL
LinkoutboundAutomatically collected eventDimension: textIndicates whether a click was on an outbound link.

Example value: 1.

Outbound
Page / Screencontent_groupConfigurationDimension: textThe content group associated with a page or screen.

Example value: videos.

Content group
Page / Screencontent_idRecommended eventDimension: textAn ID for an article of content that a user interacted with.

Example value: article-8704.

Content ID
Page / Screencontent_typeRecommended eventDimension: textThe type of content that a user interacted with.

Example value: article.

Content type
Page / Screenpage_locationAutomatically collected eventDimension: text The complete URL of the webpage that someone visited on your website.

For example, if someone visits www.googlemerchandisestore.com/Bags?theme=1, then the complete URL will populate the dimension.

Page location
Page / Screenpage_referrerAutomatically collected eventDimension: textThe referring URL, which is the user's previous URL and can be your website's domain or other domains.

Example value: http://example.com.

Page referrer
Page / Screenpage_titleAutomatically collected eventDimension: textThe HTML page title that you set on your website.

Example value: Home.

Note that the page_title parameter can be used to override the <title> HTML tag.

Page title

Page title and screen class

Page title and screen name

Platform / Devicescreen_resolutionAutomatically collected eventDimension: textThe resolution of a device, in the format (Width)x(Height).

Example value: 1024x768.

Screen resolution
Platform / Devicesystem_appAutomatically collected eventMetric: number(Android Only) Whether or not a first_open pertains to a system app.(None)
Platform / Devicesystem_app_updateAutomatically collected eventMetric: number(Android Only) Whether or not a first_open pertains to a system app update.(None)
Publisherad_formatPublisher integrationDimension: textThe format of an advertisement in an app.

Example values: Banner, Interstitial, Rewarded, Native.

Ad format
Publisherad_platformPublisher integrationDimension: textThe platform used to surface an advertisement in an app.

Example values: AppLovin, ironSource, MoPub.

(None)
Publisherad_sourcePublisher integrationDimension: textThe source network that served an advertisement.

Example values: AdColony, AdMob, Meta Audience Network, Mediated house ads.

Ad source
Publisherad_unit_idPublisher integrationDimension: textThe unique identifier for an ad unit.

Example value: 12345678.

(None)
Publisherad_unit_namePublisher integrationDimension: textThe name you choose for an ad unit.

Example value: banner_1234.

Ad unit
Publisherexposure_timeAutomatically collected eventMetric: numberThe amount of time a user is exposed to ads.

Example value: 12345678.

Ad exposure
Userengagement_time_msecAutomatically collected eventMetric: numberThe amount of time a user spends with your web page in focus or app screen in the foreground.

Example value: 23341.

Learn more about user engagement

Average engagement time

User engagement

Videovideo_current_timeEnhanced measurement eventMetric: numberThe current time in a video of the viewer.

Example value: 1234.

(None)
Videovideo_durationEnhanced measurement eventMetric: numberThe duration of a video.

Example value: 1234.

(None)
Videovideo_percentEnhanced measurement eventMetric: numberThe percentage of a video that a user watched.

Example value: 45.

(None)
Videovideo_providerEnhanced measurement eventDimension: textThe source of an embedded video.

Example value: youtube.

Video provider
Videovideo_titleEnhanced measurement eventDimension: textThe title of an embedded video.

Example value: Awesome play!

Video title
Videovideo_urlEnhanced measurement eventDimension: textThe url of an embedded video.

Example value: https://youtube.com/abcde.

Video URL
Search
Clear search
Close search
Main menu
8705853930055103527
true
Search Help Center
true
true
true
true
true
69256
false