Google Analytics 4 Field Reference
Sample
https://connectors.windsor.ai/googleanalytics4?api_key=[your API key]&date_preset=last_7d&fields=source,medium,campaign,transactionrevenue&_renderer=csv
Custom dimensions and metrics
Besides the list of fields presented below, users can request custom predefined dimensions and metrics. They can retrieve the names of the existing fields by running:
https://connectors.windsor.ai/googleanalytics4/fields?api_key=[your API key]
Once the names of each dimension and metric have been retrieved, users can request them just like with any other field. For instance,
https://connectors.windsor.ai/googleanalytics4?api_key=[your API key]&date_preset=last_7d&fields=account_id,account_name,sessions,[custom_dimension],[custom_metric]
It is worth noting that there are two types of fields: Dimensions and Metrics.
- Dimensions are summaries which contain text, such as: account id, account name, campagin, etc.
- Metrics are values which return a numeric value, such as: clicks, conversions, spend, etc.
In order to retrieve the custom fields, you must provide at least one metric. For example, if you want to fetch date, custom_dimension1, you need to select one metric (i.e: sessions). Moreover, if you want to fetch a metric, you do not need to have a dimension in the request which means that you can request date,custom_metric1 directly.
To test if metrics and dimensions are compatible, you can use the Google Analytics explorer: https://ga-dev-tools.web.app/ga4/dimensions-metrics-explorer/
Fields
| ID | Type | Name | Description | Report |
|---|---|---|---|---|
| account_id | TEXT | Account ID | The Account ID | Account |
| account_name | TEXT | Account Name | The Account Name | Account |
| achievement_id | TEXT | Achievement ID | The achievement ID in a game for an event. Populated by the event parameter 'achievement_id'. | Game Event |
| active1_day_users | NUMERIC | 1-day active users | The number of distinct active users on your site or app within a 1 day period. The 1 day period includes the last day in the report's date range. Note: this is the same as Active Users. | Basic |
| active28_day_users | NUMERIC | 28-day active users | The number of distinct active users on your site or app within a 28 day period. The 28 day period includes the last day in the report's date range. | Basic |
| active7_day_users | NUMERIC | 7-day active users | The number of distinct active users on your site or app within a 7 day period. The 7 day period includes the last day in the report's date range. | Basic |
| active_users | NUMERIC | Active Users | Primary user metric in GA4: The number of distinct users who visited your site or app. | Basic |
| ad_format | TEXT | Ad format | Describes the way ads looked and where they were located. Typical formats include 'Interstitial', 'Banner', 'Rewarded', and 'Native advanced'. | Ads |
| ad_source_name | TEXT | Ad source | The source network that served the ad. Typical sources include 'AdMob Network', 'Liftoff', 'Facebook Audience Network', and 'Mediated house ads'. | Ads |
| ad_unit_exposure | NUMERIC | Ad unit exposure | The time that an ad unit was exposed to a user, in milliseconds. | Ads |
| ad_unit_name | TEXT | Ad unit | The name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users. | Ads |
| add_to_carts | NUMERIC | Add to carts | The number of times users added items to their shopping carts. | Ecommerce |
| advertiser_ad_clicks | NUMERIC | Ads clicks | Total number of times users have clicked on an ad to reach the property. Includes clicks from linked integrations like linked Search Ads 360 advertisers. Also includes uploaded clicks from data import. | Advertiser Ad |
| advertiser_ad_cost | NUMERIC | Ads cost | The total amount you paid for your ads. Includes costs from linked integrations like linked Google Ads accounts. Also includes uploaded cost from data import; to learn more, see [Import cost data](https://support.google.com/analytics/answer/10071305). | Advertiser Ad |
| advertiser_ad_cost_per_click | NUMERIC | Ads cost per click | Ads cost per click is ad cost divided by ad clicks and is often abbreviated CPC. | Advertiser Ad |
| advertiser_ad_impressions | NUMERIC | Ads impressions | The total number of impressions. Includes impressions from linked integrations like linked Display & Video 360 advertisers. Also includes uploaded impressions from data import. | Advertiser Ad |
| age | TEXT | Age | User age brackets. | User |
| app_version | TEXT | App version | The app's versionName (Android) or short bundle version (iOS). | Account |
| audience_id | TEXT | Audience id | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. | User |
| audience_name | TEXT | Audience name | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. | User |
| average_purchase_revenue | NUMERIC | Average purchase revenue | The average purchase revenue in the transaction group of events. | Event |
| average_purchase_revenue_per_paying_user | NUMERIC | ARPPU | Average revenue per paying user (ARPPU) is the total purchase revenue per active user that logged a purchase event. The summary metric is for the time period selected. | Event |
| average_purchase_revenue_per_user | NUMERIC | Average purchase revenue per user | The average purchase revenue per active user is the total purchase revenue per active user that logged any event. The summary metric is for the time period selected. | Event |
| average_revenue_per_user | NUMERIC | ARPU | Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings. | Event |
| average_session_duration | NUMERIC | Average session duration | The average duration (in seconds) of users' sessions. | Event |
| bounce_rate | NUMERIC | Bounce rate | The percentage of sessions that were not engaged ((Sessions Minus Engaged sessions) divided by Sessions). This metric is returned as a fraction; for example, 0.2761 means 27.61% of sessions were bounces. | Session Source |
| branding_interest | TEXT | Interests | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. For example, 'Shoppers', 'Lifestyles & Hobbies/Pet Lovers', or 'Travel/Travel Buffs/Beachbound Travelers'. | User |
| browser | TEXT | Browser | The browsers used to view your website. | Device |
| campaign | TEXT | Campaign (alias for Campaign name) | The marketing campaign name for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | Session Source |
| campaign_id | TEXT | Campaign ID | The identifier of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | Event Source |
| campaign_name | TEXT | Campaign name | The marketing campaign name for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | Session Source |
| cart_to_view_rate | NUMERIC | Cart-to-view rate | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). This metric is returned as a fraction; for example, 0.1132 means 11.32% of users who viewed a product also added the same product to their cart. | Ecommerce |
| character | TEXT | Character | The player character in a game for an event. Populated by the event parameter 'character'. | File Download |
| checkouts | NUMERIC | Checkouts | The number of times users started the checkout process. This metric counts the occurrence of the 'begin_checkout' event. | Ecommerce |
| city | CITY | City | The city from which the user activity originated. | Geo |
| cityid | TEXT | City ID | The geographic ID of the city from which the user activity originated, derived from their IP address. | Geo |
| cohort | TEXT | Cohort | The cohort's name in the request. A cohort is a set of users who started using your website or app in any consecutive group of days. If a cohort name is not specified in the request, cohorts are named by their zero based index: cohort_0, cohort_1, etc. | Cohort |
| cohort_active_users | NUMERIC | Cohort active users | The number of users in the cohort who are active in the time window corresponding to the cohort nth day/week/month. For example for the row where cohortNthWeek = 0001, this metric is the number of users (in the cohort) who are active in week 1. | Cohort |
| cohort_nth_day | TEXT | Daily cohort | Day offset relative to the firstSessionDate for the users in the cohort. For example, if a cohort is selected with the start and end date of 2020-03-01, then for the date 2020-03-02, cohortNthDay will be 0001. | Cohort |
| cohort_nth_month | TEXT | Monthly cohort | Month offset relative to the firstSessionDate for the users in the cohort. Month boundaries align with calendar month boundaries. For example, if a cohort is selected with the start and end date in March 2020, then for any date in April 2020, cohortNthMonth will be 0001. | Cohort |
| cohort_nth_week | TEXT | Weekly cohort | Week offset relative to the firstSessionDate for the users in the cohort. Weeks start on Sunday and end on Saturday. For example, if a cohort is selected with the start and end date in the range 2020-11-08 to 2020-11-14, then for the dates in the range 2020-11-15 to 2020-11-21, cohortNthWeek will be 0001. | Cohort |
| cohort_total_users | NUMERIC | Cohort total users | The total number of users in the cohort. This metric is the same value in every row of the report for each cohort. Because cohorts are defined by a shared acquisition date, cohortTotalUsers is the same as cohortActiveUsers for the cohort's selection date range. For report rows later than the ochort's selection range, it is typical for cohortActiveUsers to be smaller than cohortTotalUsers. This difference represents users from the cohort that were not active for the later date. cohortTotalUsers is commonly used in the metric expression cohortActiveUsers/cohortTotalUsers to compute a user retention fraction for the cohort. The relationship between activeUsers and totalUsers is not equivalent to the relationship between cohortActiveUsers and cohortTotalUsers. | Cohort |
| content_group | TEXT | Content group | A category that applies to items of published content. Populated by the event parameter 'content_group'. | Content |
| content_id | TEXT | Content ID | The identifier of the selected content. Populated by the event parameter 'content_id'. | Content |
| content_type | TEXT | Content type | The category of the selected content. Populated by the event parameter 'content_type'. | Content |
| continent | TEXT | Continent | The continent from which the user activity originated. For example, 'Americas' or 'Asia'. | Geo |
| continentid | TEXT | Continent ID | The geographic ID of the continent from which the user activity originated, derived from their IP address. | Geo |
| conversions | NUMERIC | Conversions | The count of conversion events. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default. To learn more, see | Event |
| cost_per_conversion | NUMERIC | Cost per conversion | Cost per conversion is ad cost divided by conversions. | Advertiser Ad |
| country | COUNTRY | Country | The country from which the user activity originated. | Geo |
| country_id | TEXT | Country ID | The geographic ID of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. | Geo |
| crash_affected_users | NUMERIC | Crash-affected users | The number of users that logged a crash in this row of the report. For example if the report is time series by date, this metrics reports total users with at least one crash on this date. Crashes are events with the name "app_exception". | Basic |
| crash_free_users_rate | NUMERIC | Crash-free users rate | The number of users without crash events (in this row of the report) divided by the total number of users. This metric is returned as a fraction; for example, 0.9243 means 92.43% of users were crash-free. | Basic |
| date | DATE | Date | The date of the event, formatted as YYYYMMDD. | Time |
| date_hour | TEXT | Date + hour (YYYYMMDDHH) | The combined values of date and hour formatted as YYYYMMDDHH. | Time |
| date_hour_minute | TEXT | Date hour and minute | The combined values of date, hour, and minute formatted as YYYYMMDDHHMM. | Time |
| dau_per_mau | NUMERIC | DAU / MAU | The rolling percent of 30-day active users who are also 1-day active users. This metric is returned as a fraction; for example, 0.113 means 11.3% of 30-day active users were also 1-day active users. | Basic |
| dau_per_wau | NUMERIC | DAU / WAU | The rolling percent of 7-day active users who are also 1-day active users. This metric is returned as a fraction; for example, 0.082 means 8.2% of 7-day active users were also 1-day active users. | Basic |
| day | TEXT | Day | The day of the month, a two-digit number from 01 to 31. | Time |
| day_of_week | TEXT | Day of week | The day of the week. It returns values in the range [0,6] with Sunday as the first day of the week. | Time |
| default_channel_group | TEXT | Default channel group | The conversion's default channel group is based primarily on source and medium. An enumeration which includes 'Direct', 'Organic Search', 'Paid Social', 'Organic Social', 'Email', 'Affiliates', 'Referral', 'Paid Search', 'Video', and 'Display'. | Session Source |
| device | TEXT | Device | The branded device name (examples are Galaxy S10 or P30 Pro). | Device |
| device_model | TEXT | Device model | The mobile device model (example: iPhone 10,6). | Device |
| devicecategory | TEXT | Device category | The type of device - Desktop, Tablet, or Mobile. | Device |
| ecommerce_purchases | NUMERIC | Ecommerce purchases | The number of times users completed a purchase. This metric counts 'purchase' events; this metric does not count 'in_app_purchase' and subscription events. | Ecommerce |
| engaged_sessions | NUMERIC | Engaged sessions | The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views. | Basic |
| engagement_rate | PERCENT | Engagement rate | The percentage of engaged sessions (Engaged sessions divided by Sessions). This metric is returned as a fraction; for example, 0.7239 means 72.39% of sessions were engaged sessions. | Basic |
| event_campaign | TEXT | Campaign (Conversion event scope) | The name of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | Event Source |
| event_count | NUMERIC | Event count | The count of events. | Event |
| event_count_per_user | NUMERIC | Event count per user | The average number of events per user (Event count divided by Active users). | Event |
| event_name | TEXT | Event name | The name of the event. | Event |
| event_value | NUMERIC | Event value | The sum of the event parameter named 'value'. | Event |
| events_per_session | NUMERIC | Events per session | The average number of events per session (Event count divided by Sessions). | Event |
| file_extension | TEXT | File extension | The extension of the downloaded file (for example, 'pdf' or 'txt'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'file_extension'. | Outbound Link |
| file_name | TEXT | File name | The page path of the downloaded file (for example, '/menus/dinner-menu.pdf'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'file_name'. | File Download |
| first_session_date | TEXT | First session date | The date the user's first session occurred, formatted as YYYYMMDD. | User |
| first_time_purchaser_conversion_rate | NUMERIC | First-time purchaser conversion | The percentage of active users who made their first purchase. This metric is returned as a fraction; for example, 0.092 means 9.2% of active users were first time purchasers. | Ecommerce |
| first_time_purchasers | NUMERIC | First time purchasers | The number of users that completed their first purchase event. | Ecommerce |
| first_time_purchasers_per_new_user | NUMERIC | First-time purchasers per new user | The average number of first time purchasers per new user. | Ecommerce |
| first_user_campaign_id | TEXT | First user campaign ID | Identifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | User Source |
| first_user_campaign_name | TEXT | First user campaign | Name of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | User Source |
| first_user_default_channel_group | TEXT | First user default channel group | The default channel group that first acquired the user. Default channel group is based primarily on source and medium. An enumeration which includes 'Direct', 'Organic Search', 'Paid Social', 'Organic Social', 'Email', 'Affiliates', 'Referral', 'Paid Search', 'Video', and 'Display'. | User Source |
| first_user_google_ads_account_name | TEXT | First user Google Ads account name | The Account name from Google Ads that first acquired the user. | User Source |
| first_user_google_ads_ad_group_id | TEXT | First user Google Ads ad group ID | The Ad Group Id in Google Ads that first acquired the user. | User Source |
| first_user_google_ads_ad_group_name | TEXT | First user Google Ads ad group name | The Ad Group Name in Google Ads that first acquired the user. | User Source |
| first_user_google_ads_ad_network_type | TEXT | First user Google Ads ad network type | The advertising network that first acquired the user. An enumeration which includes 'Google search', 'Search partners', 'Google Display Network', 'Youtube Search', 'Youtube Videos', 'Cross-network', 'Social', and '(universal campaign)'. | User Source |
| first_user_google_ads_campaign_id | TEXT | First user Google Ads campaign ID | Identifier of the Google Ads marketing campaign that first acquired the user. | User Source |
| first_user_google_ads_campaign_name | TEXT | First user Google Ads campaign | Name of the Google Ads marketing campaign that first acquired the user. | User Source |
| first_user_google_ads_campaign_type | TEXT | First user Google Ads campaign type | The campaign type of the Google Ads campaign that first acquired the user. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max. To learn more, see | User Source |
| first_user_google_ads_creative_id | TEXT | First user Google Ads creative ID | The ID of the Google Ads creative that first acquired the user. Creative IDs identify individual ads. | User Source |
| first_user_google_ads_customer_id | TEXT | First user Google Ads customer ID | The Customer ID from Google Ads that first acquired the user. Customer IDs in Google Ads uniquely identify Google Ads accounts. | User Source |
| first_user_google_ads_keyword | TEXT | First user Google Ads keyword text | The matched keyword that first acquired the user. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers. To learn more about Keywords, see | User Source |
| first_user_google_ads_query | TEXT | First user Google Ads query | The search query that first acquired the user. | User Source |
| first_user_manual_ad_content | TEXT | First user manual ad content | The ad content that first acquired the user. Populated by the utm_content parameter. | User Source |
| first_user_manual_term | TEXT | First user manual term | The term that first acquired the user. Populated by the utm_term parameter. | User Source |
| first_user_medium | TEXT | First user medium | The medium that first acquired the user to your website or app. | User Source |
| first_user_source | TEXT | First user source | The source that first acquired the user to your website or app. | User Source |
| first_user_source_medium | TEXT | First user source / medium | The combined values of the dimensions 'firstUserSource' and 'firstUserMedium'. | User Source |
| first_user_source_platform | TEXT | First user source platform | The source platform that first acquired the user. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch. | User Source |
| full_page_url | TEXT | Full page URL | The hostname, page path, and query string for web pages visited; for example, the fullPageUrl portion of https://www.example.com/store/contact-us?query_string=true is www.example.com/store/contact-us?query_string=true. | Content |
| gender | TEXT | Gender | User gender. | User |
| google_ads_account_name | TEXT | Google Ads account name | The Account name from Google Ads for the campaign that led to the conversion event. Corresponds to customer.descriptive_name in the Google Ads API. | |
| google_ads_ad_group_id | TEXT | Google Ads ad group ID | The ad group id attributed to the conversion event. | Event Source |
| google_ads_ad_group_name | TEXT | Google Ads ad group name | The ad group name attributed to the conversion event. | Event Source |
| google_ads_ad_network_type | TEXT | Google Ads ad network type | The advertising network type of the conversion. An enumeration which includes 'Google search', 'Search partners', 'Google Display Network', 'Youtube Search', 'Youtube Videos', 'Cross-network', 'Social', and '(universal campaign)'. | Event Source |
| google_ads_campaign_id | TEXT | Google Ads campaign ID | The campaign ID for the Google Ads campaign attributed to the conversion event. | Event Source |
| google_ads_campaign_name | TEXT | Google Ads campaign | The campaign name for the Google Ads campaign attributed to the conversion event. | Event Source |
| google_ads_campaign_type | TEXT | Google Ads campaign type | The campaign type for the Google Ads campaign attributed to the conversion event. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max. To learn more, see | Event Source |
| google_ads_creative_id | TEXT | Google Ads creative ID | The ID of the Google Ads creative attributed to the conversion event. Creative IDs identify individual ads. | Event Source |
| google_ads_customer_id | TEXT | Google Ads customer ID | The Customer ID from Google Ads for the campaign that led to conversion event. Customer IDs in Google Ads uniquely identify Google Ads accounts. | Event Source |
| google_ads_keyword | TEXT | Google Ads keyword text | The matched keyword that led to the conversion event. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers. To learn more about Keywords, see | Event Source |
| google_ads_query | TEXT | Google Ads query | The search query that led to the conversion event. | Event Source |
| group_id | TEXT | Group ID | The player group ID in a game for an event. Populated by the event parameter 'group_id'. | Game Event |
| hostname | TEXT | Hostname | Includes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com. | Account |
| hour | TEXT | Hour | The two-digit hour of the day that the event was logged. This dimension ranges from 0-23 and is reported in your property's timezone. | Time |
| is_conversion_event | TEXT | Is conversion event | The string 'true' if the event is a conversion. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default. To learn more, see | Event |
| item_affiliation | TEXT | Item affiliation | The name or code of the affiliate (partner/vendor; if any) associated with an individual item. Populated by the 'affiliation' item parameter. | Ecommerce |
| item_brand | TEXT | Item brand | Brand name of the item. | Ecommerce |
| item_category | TEXT | Item category | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category. | Ecommerce |
| item_category2 | TEXT | Item category 2 | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 2. | Ecommerce |
| item_category3 | TEXT | Item category 3 | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category 3. | Ecommerce |
| item_category4 | TEXT | Item category 4 | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category 4. | Ecommerce |
| item_category5 | TEXT | Item category 5 | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category 5. | Ecommerce |
| item_id | TEXT | Item ID | The ID of the item. | Ecommerce |
| item_list_click_events | NUMERIC | Item-list click events | The number of times users clicked an item when it appeared in a list. This metric counts the occurrence of the 'select_item' event. | Ecommerce |
| item_list_click_through_rate | NUMERIC | Item list click through rate | The number of users who selected a list(s) divided by the number of users who viewed the same list(s). This metric is returned as a fraction; for example, 0.2145 means 21.45% of users who viewed a list also selected the same list. | Ecommerce |
| item_list_id | TEXT | Item list ID | The ID of the item list. | Ecommerce |
| item_list_name | TEXT | Item list name | The name of the item list. | Ecommerce |
| item_list_view_events | NUMERIC | Item-list view events | The number of times the item list was viewed. This metric counts the occurrence of the 'view_item_list' event. | Ecommerce |
| item_name | TEXT | Item name | The name of the item. | Ecommerce |
| item_promotion_click_through_rate | NUMERIC | Item promotion click through rate | The number of users who selected a promotion(s) divided by the number of users who viewed the same promotion(s). This metric is returned as a fraction; for example, 0.1382 means 13.82% of users who viewed a promotion also selected the promotion. | Ecommerce |
| item_promotion_creative_name | TEXT | Item promotion creative name | The name of the item-promotion creative. | Ecommerce |
| item_promotion_id | TEXT | Item promotion ID | The ID of the item promotion. | Ecommerce |
| item_promotion_name | TEXT | Item promotion name | The name of the promotion for the item. | Ecommerce |
| item_revenue | NUMERIC | Item revenue | The total revenue from items only. Item revenue is the product of its price and quantity. Item revenue excludes tax and shipping values; tax & shipping values are specified at the event and not item level. | Ecommerce |
| item_variant | TEXT | Item variant | The specific variation of a product. e.g., XS, S, M, L for size; or Red, Blue, Green, Black for color. Populated by the 'item_variant' parameter. | Ecommerce |
| item_view_events | NUMERIC | Item view events | The number of times the item details were viewed. The metric counts the occurrence of the 'view_item' event. | Ecommerce |
| items_added_to_cart | NUMERIC | Items added to cart | The number of units added to cart for a single item. This metric counts the quantity of items in 'add_to_cart' events. | Ecommerce |
| items_checked_out | NUMERIC | Items checked out | The number of units checked out for a single item. This metric counts the quantity of items in 'begin_checkout' events. | Ecommerce |
| items_clicked_in_list | NUMERIC | Items clicked in list | The number of units clicked in list for a single item. This metric counts the quantity of items in 'select_item' events. | Ecommerce |
| items_clicked_in_promotion | NUMERIC | Items clicked in promotion | The number of units clicked in promotion for a single item. This metric counts the quantity of items in 'select_promotion' events. | Ecommerce |
| items_purchased | NUMERIC | Items purchased | The number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events. | Ecommerce |
| items_viewed | NUMERIC | Items viewed | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. | Ecommerce |
| items_viewed_in_list | NUMERIC | Items viewed in list | The number of units viewed in list for a single item. This metric counts the quantity of items in 'view_item_list' events. | Ecommerce |
| items_viewed_in_promotion | NUMERIC | Items viewed in promotion | The number of units viewed in promotion for a single item. This metric counts the quantity of items in 'view_promotion' events. | Ecommerce |
| landing_page | TEXT | Landing page | The page path associated with the first pageview in a session. | Content |
| landing_page_plus_query_string | TEXT | Landing page + query string | The page path + query string associated with the first pageview in a session. | Content |
| language | TEXT | Language | The language setting of the user's browser or device. e.g. English | Device |
| language_code | TEXT | Language code | The language setting (ISO 639) of the user's browser or device. e.g. 'en-us' | Device |
| level | TEXT | Level | The player's level in a game. Populated by the event parameter 'level'. | Game Event |
| link_classes | TEXT | Link classes | The HTML class attribute for an outbound link. For example if a user clicks a link '', this dimension will return 'center'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_classes'. | Outbound Link |
| link_domain | TEXT | Link domain | The destination domain of the outbound link. For example if a user clicks a link '', this dimension will return 'youtube.com'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_domain'. | Outbound Link |
| link_id | TEXT | Link ID | The HTML id attribute for an outbound link or file download. For example if a user clicks a link '', this dimension will return 'socialLinks'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_id'. | Outbound Link |
| link_text | TEXT | Link text | The link text of the file download. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_text'. | Outbound Link |
| link_url | TEXT | Link URL | The full url for an outbound link or file download. For example if a user clicks a link '', this dimension will return 'https://www.youtube.com/results?search_query=analytics'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_url'. | Outbound Link |
| manual_ad_content | TEXT | Manual ad content | The ad content attributed to the conversion event. Populated by the utm_content parameter. | Event Source |
| manual_term | TEXT | Manual term | The term attributed to the conversion event. Populated by the utm_term parameter. | Event Source |
| medium | TEXT | Medium | The medium attributed to the conversion event. | Session Source |
| method | TEXT | Method | The method by which an event was triggered. Populated by the event parameter 'method'. | Event |
| minute | TEXT | Minute | The two-digit minute of the hour that the event was logged. This dimension ranges from 0-59 and is reported in your property's timezone. | Time |
| mobile_device_branding | TEXT | Device brand | Manufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile). | Device |
| mobile_device_model | TEXT | Mobile model | The mobile device model name (examples: iPhone X or SM-G950F). | Device |
| month | TEXT | Month | The month of the event, a two digit integer from 01 to 12. | Time |
| new_vs_returning | TEXT | New / returning | New users have 0 previous sessions, and returning users have 1 or more previous sessions. This dimension returns two values: 'new' or 'returning'. | User |
| newusers | NUMERIC | New users | The web page titles used on your site. | Basic |
| nth_day | TEXT | Nth day | The number of days since the start of the date range. | Time |
| nth_hour | TEXT | Nth hour | The number of hours since the start of the date range. The starting hour is 0000. | Time |
| nth_minute | TEXT | Nth minute | The number of minutes since the start of the date range. The starting minute is 0000. | Time |
| nth_month | TEXT | Nth month | The number of months since the start of a date range. The starting month is 0000. | Time |
| nth_week | TEXT | Nth week | A number representing the number of weeks since the start of a date range. | Time |
| nth_year | TEXT | Nth year | The number of years since the start of the date range. The starting year is 0000. | Time |
| operating_system | TEXT | Operating system | The operating systems used by visitors to your app or website. Includes desktop and mobile operating systems such as Windows and Android. | Device |
| operating_system_version | TEXT | OS version | The operating system versions used by visitors to your website or app. For example, Android 10's version is 10, and iOS 13.5.1's version is 13.5.1. | Device |
| operating_system_with_version | TEXT | Operating system with version | The operating system and version. For example, Android 10 or Windows 7. | Device |
| order_coupon | TEXT | Order coupon | Code for the order-level coupon. | Ecommerce |
| organic_google_search_average_position | NUMERIC | Organic google search average position | The average ranking of your website URLs for the query reported from Search Console. For example, if your site's URL appears at position 3 for one query and position 7 for another query, the average position would be 5 (3+7/2). This metric requires an active Search Console link. | Other |
| organic_google_search_click_through_rate | NUMERIC | Organic google search click through rate | The organic Google Search click through rate reported from Search Console. Click through rate is clicks per impression. This metric is returned as a fraction; for example, 0.0588 means about 5.88% of impressions resulted in a click. This metric requires an active Search Console link. | Other |
| organic_google_search_clicks | NUMERIC | Organic google search clicks | The number of organic Google Search clicks reported from Search Console. This metric requires an active Search Console link. | Other |
| organic_google_search_impressions | NUMERIC | Organic google search impressions | The number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link. | Other |
| outbound | TEXT | Outbound | Returns 'true' if the link lead to a site is not a part of the property’s domain. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'outbound'. | Outbound Link |
| page_location | TEXT | Page location | The protocol, hostname, page path, and query string for web pages visited; for example, the pageLocation portion of https://www.example.com/store/contact-us?query_string=true is https://www.example.com/store/contact-us?query_string=true. Populated by the event parameter 'page_location'. | Content |
| page_path | TEXT | Page path | The portion of the URL between the hostname and query string for web pages visited; for example, the pagePath portion of https://www.example.com/store/contact-us?query_string=true is /store/contact-us. | Content |
| page_path_plus_query_string | TEXT | Page path + query string | The portion of the URL following the hostname for web pages visited; for example, the pagePathPlusQueryString portion of https://www.example.com/store/contact-us?query_string=true is /store/contact-us?query_string=true. | Content |
| page_referrer | TEXT | Page referrer | The full referring URL including the hostname and path. This referring URL is the user's previous URL and can be this website's domain or other domains. Populated by the event parameter 'page_referrer'. | Content |
| pagetitle | TEXT | Page title | The web page titles used on your site. | Content |
| percent_scrolled | TEXT | Percent scrolled | The percentage down the page that the user has scrolled (for example, '90'). Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'percent_scrolled'. | Content |
| platform | TEXT | Platform | The platform on which your app or website ran; for example, web, iOS, or Android. To determine a stream's type in a report, use both platform and streamId. | Account |
| platform_device_category | TEXT | Platform / device category | The platform and type of device on which your website or mobile app ran. (example: Android / mobile) | Device |
| promotion_clicks | NUMERIC | Promotion clicks | The number of times an item promotion was clicked. This metric counts the occurrence of the 'select_promotion' event. | Ecommerce |
| promotion_views | NUMERIC | Promotion views | The number of times an item promotion was viewed. This metric counts the occurrence of the 'view_promotion' event. | Ecommerce |
| publisher_ad_clicks | NUMERIC | Publisher ad clicks | The number of ad_click events. | Ads |
| publisher_ad_impressions | NUMERIC | Publisher ad impressions | The number of ad_impression events. | Ads |
| purchase_revenue | NUMERIC | Purchase revenue | The sum of revenue from purchases made in your app or site. Purchase revenue sums the revenue for these events: 'purchase', 'ecommerce_purchase', 'in_app_purchase', 'app_store_subscription_convert', and 'app_store_subscription_renew'. Purchase revenue is specified by the 'value' parameter in tagging. | Event |
| purchase_to_view_rate | NUMERIC | Purchase-to-view rate | The number of users who purchased a product(s) divided by the number of users who viewed the same product(s). This metric is returned as a fraction; for example, 0.128 means 12.8% of users that viewed a product(s) also purchased the same product(s). | Event |
| purchaser_conversion_rate | NUMERIC | Purchaser conversion | The percentage of active users who made 1 or more purchase transactions. This metric is returned as a fraction; for example, 0.412 means 41.2% of users were purchasers. | Event |
| region | REGION | Region | The geographic region from which the user activity originated, derived from their IP address. | Geo |
| return_on_ad_spend | NUMERIC | Return on ad spend | Return On Ad Spend (ROAS) is total revenue divided by advertiser ad cost. | Event |
| screen_page_views | NUMERIC | Views | The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted. (screen_view + page_view events). | Basic |
| screen_page_views_per_session | NUMERIC | Views per session | The number of app screens or web pages your users viewed per session. Repeated views of a single page or screen are counted. (screen_view + page_view events) / sessions. | Basic |
| screen_page_views_per_user | NUMERIC | Views per user | The number of app screens or web pages your users viewed per active user. Repeated views of a single page or screen are counted. (screen_view + page_view events) / active users. | Basic |
| screen_resolution | TEXT | Screen resolution | The screen resolution of the user's monitor. For example, 1920x1080. | Basic |
| scrolled_users | NUMERIC | Scrolled users | The number of unique users who scrolled down at least 90% of the page. | Basic |
| search_term | TEXT | Search term | The term searched by the user. For example if the user visits '/some-page.html?q=some-term', this dimension returns 'some-term'. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'search_term'. | Content |
| session_campaign_id | TEXT | Session campaign ID | The marketing campaign id for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. | Session Source |
| session_conversion_rate | NUMERIC | Session conversion rate | The percentage of sessions in which any conversion event was triggered. | Session Source |
| session_default_channel_group | TEXT | Session default channel group | The session's default channel group is based primarily on source and medium. An enumeration which includes 'Direct', 'Organic Search', 'Paid Social', 'Organic Social', 'Email', 'Affiliates', 'Referral', 'Paid Search', 'Video', and 'Display'. | Session Source |
| session_google_ads_account_name | TEXT | Session Google Ads account name | The Account name from Google Ads that led to the session. Corresponds to customer.descriptive_name in the Google Ads API. | Session Source |
| session_google_ads_ad_group_id | TEXT | Session Google Ads ad group ID | The Ad Group Id in Google Ads for a session. | Session Source |
| session_google_ads_ad_group_name | TEXT | Session Google Ads ad group name | The Ad Group Name in Google Ads for a session. | Session Source |
| session_google_ads_ad_network_type | TEXT | Session Google Ads ad network type | The advertising network that led to the session. An enumeration which includes 'Google search', 'Search partners', 'Google Display Network', 'Youtube Search', 'Youtube Videos', 'Cross-network', 'Social', and '(universal campaign)'. | Session Source |
| session_google_ads_campaign_id | TEXT | Session Google Ads campaign ID | The Campaign ID for the Google Ads Campaign that led to this session. | Session Source |
| session_google_ads_campaign_name | TEXT | Session Google Ads campaign | The Campaign name for the Google Ads Campaign that led to this session. | Session Source |
| session_google_ads_campaign_type | TEXT | Session Google Ads campaign type | The campaign type for the Google Ads campaign that led to this session. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max. To learn more, see | Session Source |
| session_google_ads_creative_id | TEXT | Session Google Ads creative ID | The ID of the Google Ads creative that lead to a session on your website or app. Creative IDs identify individual ads. | Session Source |
| session_google_ads_customer_id | TEXT | Session Google Ads customer ID | The Customer ID from Google Ads that led to the session. Customer IDs in Google Ads uniquely identify Google Ads accounts. | Session Source |
| session_google_ads_keyword | TEXT | Session Google Ads keyword text | The matched keyword that led to the session. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers. To learn more about Keywords, see | Session Source |
| session_google_ads_query | TEXT | Session Google Ads query | The search query that led to the session. | Session Source |
| session_manual_ad_content | TEXT | Session manual ad content | The ad content that led to a session. Populated by the utm_content parameter. | Session Source |
| session_manual_term | TEXT | Session manual term | The term that led to a session. Populated by the utm_term parameter. | Session Source |
| session_sa360_ad_group_name | TEXT | Session SA360 ad group name | The Ad Group name from Search Ads 360 that led to this session. | Session Source |
| session_sa360_campaign_id | TEXT | Session SA360 campaign ID | The Campaign ID from Search Ads 360 that led to this session. | Session Source |
| session_sa360_campaign_name | TEXT | Session SA360 campaign | The Campaign name from Search Ads 360 that led to this session. | Session Source |
| session_sa360_creative_format | TEXT | Session SA360 creative format | The type of creative in Search Ads 360 that led to this session. For example, 'Responsive search ad' or 'Expanded text ad'. To learn more, see [GA4 Traffic Source Dimensions](https://support.google.com/analytics/answer/9143382#traffic-source). | Session Source |
| session_sa360_engine_account_id | TEXT | Session SA360 engine account ID | The ID of the engine account in SA360 that led to this session. | Session Source |
| session_sa360_engine_account_name | TEXT | Session SA360 engine account name | The name of the engine account in SA360 that led to this session. | Session Source |
| session_sa360_engine_account_type | TEXT | Session SA360 engine account type | The type of the engine account in Search Ads 360 that led to this session. For example, 'google ads', 'bing', or 'baidu'. | Session Source |
| session_sa360_keyword | TEXT | Session SA360 keyword text | The search engine keyword from Search Ads 360 that led to this session. | Session Source |
| session_sa360_medium | TEXT | Session SA360 medium | The search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'. | Session Source |
| session_sa360_query | TEXT | Session SA360 query | The search query from Search Ads 360 that led to this session. | Session Source |
| session_sa360_source | TEXT | Session SA360 source | The source of the traffic from Search Ads 360 that led to this session. For example, 'example.com' or 'google'. | Session Source |
| session_source_medium | TEXT | Session source / medium | The combined values of the dimensions 'sessionSource' and 'sessionMedium'. | Session Source |
| session_source_platform | TEXT | Session source platform | The source platform of the session's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch. | Session Source |
| sessions | NUMERIC | Sessions | The number of sessions that began on your site or app (event triggered: session_start). | Session Source |
| sessions_per_user | NUMERIC | Sessions per user | The average number of sessions per user (Sessions divided by Active Users). | Session Source |
| shipping_amount | NUMERIC | Shipping amount | Shipping amount associated with a transaction. Populated by the 'shipping' event parameter. | Ecommerce |
| shipping_tier | TEXT | Shipping tier | The shipping tier (e.g. Ground, Air, Next-day) selected for delivery of the purchased item. Populated by the 'shipping_tier' event parameter. | Ecommerce |
| signed_in_with_user_id | TEXT | Signed in with user ID | The string 'yes' if the user signed in with the User-ID feature. To learn more about User-ID, see | User |
| source | TEXT | Source | The source attributed to the conversion event. | Session Source |
| source_medium | TEXT | Source / medium | The combined values of the dimensions 'source' and 'medium'. | Event Source |
| source_platform | TEXT | Source platform | The source platform of the conversion event's campaign. Please do not depend on this field returning 'Manual' for traffic that uses UTMs; this field will update from returning 'Manual' to returning '(not set)' for an upcoming feature launch. | Event Source |
| stream_id | TEXT | Stream ID | The numeric data stream identifier for your app or website. | Account |
| stream_name | TEXT | Stream name | The data stream name for your app or website. | Account |
| tax_amount | NUMERIC | Tax amount | Tax amount associated with a transaction. Populated by the 'tax' event parameter. | Ecommerce |
| test_data_filter_id | TEXT | Test data filter ID | The numeric identifier of a data filter in testing state. You use data filters to include or exclude event data from your reports based on event-parameter values. To learn more, see | Account |
| test_data_filter_name | TEXT | Test data filter name | The name of data filters in testing state. You use data filters to include or exclude event data from your reports based on event-parameter values. To learn more, see | Account |
| total_ad_revenue | NUMERIC | Total ad revenue | The total advertising revenue from both Admob and third-party sources. | Event |
| total_purchasers | NUMERIC | Total purchasers | The number of users that logged purchase events for the time period selected. | Ecommerce |
| totalrevenue | NUMERIC | Total revenue | The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue). | Event |
| totalusers | NUMERIC | Total users | The number of distinct users who have logged at least one event, regardless of whether the site or app was in use when that event was logged. | Basic |
| transactionid | TEXT | Transaction ID | The ID of the ecommerce transaction. | Ecommerce |
| transactionrevenue | NUMERIC | Transaction revenue (alias for Total revenue) | The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue). | Event |
| transactions | NUMERIC | Transactions | The count of transaction events with purchase revenue. Transaction events are in_app_purchase, ecommerce_purchase, purchase, app_store_subscription_renew, app_store_subscription_convert, and refund. | Event |
| transactions_per_purchaser | NUMERIC | Transactions per purchaser | The average numer of transactions per purchaser. | Event |
| unified_page_path_screen | TEXT | Page path and screen class | The page path (web) or screen class (app) on which the event was logged. | Content |
| unified_page_screen | TEXT | Page path + query string and screen class | The page path and query string (web) or screen class (app) on which the event was logged. | Content |
| unified_screen_class | TEXT | Page title and screen class | The page title (web) or screen class (app) on which the event was logged. | Content |
| unified_screen_name | TEXT | Page title and screen name | The page title (web) or screen name (app) on which the event was logged. | Content |
| user_conversion_rate | NUMERIC | User conversion rate | The percentage of users who triggered any conversion event. | Event |
| user_engagement_duration | NUMERIC | User engagement | The total amount of time (in seconds) your website or app was in the foreground of users' devices. | Basic |
| users | NUMERIC | Users | Alias for active_users. | User |
| video_provider | TEXT | Video provider | The source of the video (for example, 'youtube'). Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_provider'. | Video |
| video_title | TEXT | Video title | The title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_title'. | Video |
| video_url | TEXT | Video URL | The url of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_url'. | Video |
| virtual_currency_name | TEXT | Virtual currency name | The name of a virtual currency with which the user is interacting. i.e. spending or purchasing gems in a game. Populated by the 'virtual_currency_name' event parameter. | Game Event |
| visible | TEXT | Visible | Returns 'true' if the content is visible. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'visible'. | Content |
| wau_per_mau | NUMERIC | WAU / MAU | The rolling percent of 30-day active users who are also 7-day active users. This metric is returned as a fraction; for example, 0.234 means 23.4% of 30-day active users were also 7-day active users. | Basic |
| week | TEXT | Week | The week of the event, a two-digit number from 01 to 53. Each week starts on Sunday. January 1st is always in week 01. The first and last week of the year have fewer than 7 days in most years. Weeks other than the first and the last week of the year always have 7 days. For years where January 1st is a Sunday, the first week of that year and the last week of the prior year have 7 days. | Time |
| year | TEXT | Year | The four-digit year of the event e.g. 2020. | Time |
| today | DATE | Today | Today's date |