[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.
| 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://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 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. | |||||