[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.
| Category | Event parameter | Source | Type | Description | Dimension or metric |
|---|---|---|---|---|---|
|
App
|
app_version | Automatically collected event | Dimension: text | The mobile app's versionName (Android) or short bundle version (iOS) in which an event occurred. | App version |
|
App
|
cancellation_reason | Automatically collected event | Dimension: text | The reason a cancellation occurred. | (None) |
|
App
|
fatal | Automatically collected event | Dimension: boolean | Whether an exception was fatal. Example value: False. The event is sent when you integrate Firebase Crashlytics . |
(None) |
|
App
|
firebase_error | Automatically collected event | Dimension: number | The error code reported by the Firebase SDK. Example value: 4. |
(None) |
|
App
|
firebase_error_value | Automatically collected event | Dimension: text | Additional details corresponding to the error code reported by the Firebase SDK. | (None) |
|
App
|
firebase_screen | Manual | Dimension: text | The current screen’s name, as provided by the developer. | Page title and screen name |
|
App
|
firebase_screen_class | Automatically collected event | Dimension: text | The current screen’s class name. | Page title and screen class |
|
App
|
firebase_screen_id | Automatically collected event | Dimension: text | A random identifier for the current screen. | (None) |
|
App
|
free_trial | Automatically collected event | Dimension: number | Signifies that an in-app purchase is a free trial. Example value: 1. |
(None) |
|
App
|
message_device_time | Automatically collected event | Dimension: number | The Firebase Cloud Messaging or Firebase In-App Messaging delivery epoch timestamp in UTC. | (None) |
|
App
|
message_id | Automatically collected event | Dimension: text | The Firebase Cloud Messaging or Firebase In-App Messaging message identifier, which is unique per message campaign. | (None) |
|
App
|
message_name | Automatically collected event | Dimension: text | The Firebase Cloud Messaging or Firebase In-App Messaging message name. | (None) |
|
App
|
message_time | Automatically collected event | Dimension: number | The Firebase Cloud Messaging message notification epoch timestamp in UTC. | (None) |
|
App
|
message_type | Automatically collected event | Dimension: text | The Firebase Cloud Messaging message notification type. | (None) |
|
App
|
previous_app_version | Automatically collected event | Dimension: text | For the app_update event, the parameter signifies the previous application version. Example value: 1.0.1. |
(None) |
|
App
|
previous_first_open_count | Automatically collected event | Metric: number | The number of times first_open was logged. | (None) |
|
App
|
previous_os_version | Automatically collected event | Dimension: text | For the os_update event, the parameter signifies the previous OS version. Example value: 4.4.2. |
(None) |
|
App
|
subscription | Automatically collected event | Metric: number | Signifies that an in-app purchase is a subscription. Example value: 1. |
(None) |
|
App
|
updated_with_analytics | Automatically collected event | Metric: number | Signifies that the first_open event was logged due to an update to a new version of the app that integrates Analytics. | (None) |
|
Attribution / Traffic source
|
campaign_content | Automatically collected event | Dimension: text | The ad content that was associated with the start of a session. | First user manual ad content Session manual ad content |
|
Attribution / Traffic source
|
campaign_medium | Automatically collected event | Dimension: text | The 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 source
|
campaign_source | Automatically collected event | Dimension: text | A 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 source
|
campaign_term | Automatically collected event | Dimension: text | The term that was associated with the start of a session. | First user manual term Session manual term |
|
Ecommerce > Item scoped
|
affiliation | Recommended event | Dimension: text | A product affiliation to designate a supplying company or brick and mortar store location. Example value: Google Merchandise Store. |
Item affiliation |
|
Ecommerce > Item scoped
|
coupon | Recommended event | Dimension: 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 scoped
|
coupon | Recommended event | Dimension: 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 scoped
|
creative_name | Recommended event | Dimension: text | The name of a creative used in a promotion. Example value: summer_banner. | Item promotion creative name |
|
Ecommerce > Item scoped
|
creative_slot | Recommended event | Dimension: text | The name of the promotional creative slot associated with an event. Example value: featured_app_1. | Item promotion creative slot |
|
Ecommerce > Event scoped
|
currency | Recommended event | Dimension: text | The currency used in an event, in 3-letter ISO 4217 format. For example, the currency used in a purchase. | Currency |
|
Ecommerce > Item scoped
|
discount | Recommended event | Dimension: text | The value of a discount value associated with a purchased item. Example value: 2.22. |
Item discount amount |
|
Ecommerce > Item scoped
|
index | Recommended event | Dimension: text | The index of the item in a list. Example value: 5. |
Item list position |
|
Ecommerce > Item scoped
|
item_brand | Recommended event | Dimension: text | The brand of an item. Example value: Google. |
Item brand |
|
Ecommerce > Item scoped
|
item_category | Recommended event | Dimension: text | The 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 scoped
|
item_category2 | Recommended event | Dimension: text | The second hierarchical category in which you classified an item. Example value: Adult. |
Item category 2 |
|
Ecommerce > Item scoped
|
item_category3 | Recommended event | Dimension: text | The third hierarchical category in which you classified an item. Example value: Shirts. |
Item category 3 |
|
Ecommerce > Item scoped
|
Item_category4 | Recommended event | Dimension: text | The fourth hierarchical category in which you classified an item. Example value: Crew. |
Item category 4 |
|
Ecommerce > Item scoped
|
Item_category5 | Recommended event | Dimension: text | The fifth hierarchical category in which you classified an item. Example value: Short sleeve. |
Item category 5 |
|
Ecommerce > Item scoped
|
item_id | Recommended event | Dimension: text | The ID that you specify for an item. Example value: SKU_12345. |
Item ID |
|
Ecommerce > Item scoped
|
item_list_id | Recommended event | Dimension: text | The name of the list in which an item was presented to a user. Example value: related_products. |
Item list ID |
|
Ecommerce > Item scoped
|
item_list_name | Recommended event | Dimension: text | The ID of the list in which an item was presented to a user. Example value: Related Products. |
Item list name |
|
Ecommerce > Item scoped
|
item_name | Recommended event | Dimension: text | The name of the event that contains the parameter group. Example value: purchase. |
Item name |
|
Ecommerce > Item scoped
|
item_variant | Recommended event | Dimension: text | The 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 scoped
|
location_id | Recommended event | Dimension: text | The 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 scoped
|
price | Recommended event | Metric: number | The monetary price of an item, in units of the specified currency parameter. | Local item price Item revenue |
|
Ecommerce > Item scoped
|
promotion_id | Recommended event | Dimension: text | The ID of the promotion associated with an event. | Item promotion ID |
|
Ecommerce > Item scoped
|
promotion_name | Recommended event | Dimension: text | The name of the promotion associated with an event. | Item promotion name |
|
Ecommerce > Item scoped
|
quantity | Recommended event | Metric: number | The item quantity. | Item quantity Quantity |
|
Ecommerce > Event scoped
|
shipping | Recommended event | Dimension: number | The shipping cost associated with a transaction. Example value: 3.33 |
Shipping amount |
|
Ecommerce > Event scoped
|
shipping_tier | Recommended event | Dimension: text | The shipping tier selected for delivery of a purchased item. Example value: Ground, Air, Next-day. |
Shipping tier |
|
Ecommerce > Event scoped
|
tax | Recommended event | Dimension: number | The tax cost associated with a transaction. Example value: 1.11 |
Tax amount |
|
Ecommerce > Event scoped
|
transaction_id | Recommended event | Dimension: text | The unique identifier of a transaction. Example value: T12345. |
Transaction ID Lifetime transactions |
|
Ecommerce > Event scoped
|
value | Recommended event | Dimension: text | The monetary value of the event. Example value: 30.03. |
Event value |
|
Event
|
value | Automatically collected event | Metric: number | The value associated with an event. Example value: 22. |
Event value |
|
Gaming
|
achievement_id | Recommended event | Dimension: text | The ID of an achievement that was unlocked in a game. Example value: achieved_level_10. |
Achievement ID |
|
Gaming
|
character | Recommended event | Dimension: text | The name of a character in a game. Example value: Wolverine. |
Character |
|
Gaming
|
level | Recommended event | Metric: number | The level of a character in a game. Example value: 5. |
Level |
|
Gaming
|
level_name | Recommended event | Dimension: text | The name of the level in a game. Example value: The journey begins... |
(None) |
|
Gaming
|
score | Recommended event | Metric: number | The score in a game. Example value: 238174. |
(None) |
|
Gaming
|
virtual_currency_name | Recommended event | Dimension: text | The name of a virtual currency. Example value: Gems. |
Virtual currency name |
|
General
|
file_extension | Enhanced measurement event | Dimension: text | The extension of a file download. Example values: pdf, txt. |
File extension |
|
General
|
file_name | Enhanced measurement event | Dimension: text | The page path of a file download. Example value: myfile.pdf. |
File name |
|
General
|
form_destination | Enhanced measurement event | Dimension: text | The URL to which a form is being submitted. | (None) |
|
General
|
form_id | Enhanced measurement event | Dimension: text | The HTML id attribution of the <form> DOM element. | (None) |
|
General
|
form_name | Enhanced measurement event | Dimension: text | The HTML name attribute of the <form> DOM element. | (None) |
|
General
|
form_submit_text | Enhanced measurement event | Dimension: text | The text of the submit button, if present. | (None) |
|
General
|
group_id | Recommended event | Dimension: text | The ID of a group. | Group ID |
|
General
|
language | Automatically collected event | Dimension: text | The language setting of a user’s browser or device, displayed as the ISO 639 language code
. Example value: en-us. |
Language |
|
General
|
percent_scrolled | Enhanced measurement event | Dimension: text | The percentage down the page that the user scrolled. Example value: 90. |
Percent scrolled |
|
General
|
search_term | Enhanced measurement event | Dimension: text | The strings or keywords used in a search. | Search term |
|
General
|
success | Recommended event | Dimension: boolean | The result of an operation. Specify 1 to indicate success and 0 to indicate failure. | (None) |
|
General
|
visible | Automatically collected event | Dimension: boolean | Set to 'true' if an embedded video is visible to the user. Example value: 1. |
Visible |
|
Link
|
link_classes | Enhanced measurement event | Dimension: text | The HTML class attribute for an outbound link or file download. | Link classes |
|
Link
|
link_domain | Enhanced measurement event | Dimension: text | The destination domain of an outbound link or file download. Example value: google.com |
Link domain |
|
Link
|
link_id | Enhanced measurement event | Dimension: text | The ID for an outbound link or file download. Example value: abcdefg. |
Link ID |
|
Link
|
link_url | Enhanced measurement event | Dimension: text | The full URL for an outbound link or file download. Example value: https://www.google.com. |
Link URL |
|
Link
|
outbound | Automatically collected event | Dimension: text | Indicates whether a click was on an outbound link. Example value: 1. |
Outbound |
|
Page / Screen
|
content_group | Configuration | Dimension: text | The content group
associated with a page or screen. Example value: videos. |
Content group |
|
Page / Screen
|
content_id | Recommended event | Dimension: text | An ID for an article of content that a user interacted with. Example value: article-8704. |
Content ID |
|
Page / Screen
|
content_type | Recommended event | Dimension: text | The type of content that a user interacted with. Example value: article. |
Content type |
|
Page / Screen
|
page_location | Automatically collected event | Dimension: 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 / Screen
|
page_referrer | Automatically collected event | Dimension: text | The 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 / Screen
|
page_title | Automatically collected event | Dimension: text | The HTML page title that you set on your website. Example value: Home. Note that the |
Page title Page title and screen class Page title and screen name |
|
Platform / Device
|
screen_resolution | Automatically collected event | Dimension: text | The resolution of a device, in the format (Width)x(Height). Example value: 1024x768. |
Screen resolution |
|
Platform / Device
|
system_app | Automatically collected event | Metric: number | (Android Only) Whether or not a first_open pertains to a system app. | (None) |
|
Platform / Device
|
system_app_update | Automatically collected event | Metric: number | (Android Only) Whether or not a first_open pertains to a system app update. | (None) |
|
Publisher
|
ad_format | Publisher integration | Dimension: text | The format of an advertisement in an app. Example values: Banner, Interstitial, Rewarded, Native. |
Ad format |
|
Publisher
|
ad_platform | Publisher integration | Dimension: text | The platform used to surface an advertisement in an app. Example values: AppLovin, ironSource, MoPub. |
(None) |
|
Publisher
|
ad_source | Publisher integration | Dimension: text | The source network that served an advertisement. Example values: AdColony, AdMob, Meta Audience Network, Mediated house ads. |
Ad source |
|
Publisher
|
ad_unit_id | Publisher integration | Dimension: text | The unique identifier for an ad unit. Example value: 12345678. |
(None) |
|
Publisher
|
ad_unit_name | Publisher integration | Dimension: text | The name you choose for an ad unit. Example value: banner_1234. |
Ad unit |
|
Publisher
|
exposure_time | Automatically collected event | Metric: number | The amount of time a user is exposed to ads. Example value: 12345678. |
Ad exposure |
|
User
|
engagement_time_msec | Automatically collected event | Metric: number | The amount of time a user spends with your web page in focus or app screen in the foreground. Example value: 23341. |
Average engagement time User engagement |
|
Video
|
video_current_time | Enhanced measurement event | Metric: number | The current time in a video of the viewer. Example value: 1234. |
(None) |
|
Video
|
video_duration | Enhanced measurement event | Metric: number | The duration of a video. Example value: 1234. |
(None) |
|
Video
|
video_percent | Enhanced measurement event | Metric: number | The percentage of a video that a user watched. Example value: 45. |
(None) |
|
Video
|
video_provider | Enhanced measurement event | Dimension: text | The source of an embedded video. Example value: youtube. |
Video provider |
|
Video
|
video_title | Enhanced measurement event | Dimension: text | The title of an embedded video. Example value: Awesome play! |
Video title |
|
Video
|
video_url | Enhanced measurement event | Dimension: text | The url of an embedded video. Example value: https://youtube.com/abcde. |
Video URL |
| Try your keywords on Google Web Search . | |||||
