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

IDTypeNameDescriptionReport
account_idTEXTAccount IDThe Account IDAccount
account_nameTEXTAccount NameThe Account NameAccount
achievement_idTEXTAchievement IDThe achievement ID in a game for an event. Populated by the event parameter 'achievement_id'.Game Event
active1_day_usersNUMERIC1-day active usersThe 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_usersNUMERIC28-day active usersThe 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_usersNUMERIC7-day active usersThe 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_usersNUMERICActive UsersPrimary user metric in GA4: The number of distinct users who visited your site or app.Basic
ad_formatTEXTAd formatDescribes the way ads looked and where they were located. Typical formats include 'Interstitial', 'Banner', 'Rewarded', and 'Native advanced'.Ads
ad_source_nameTEXTAd sourceThe source network that served the ad. Typical sources include 'AdMob Network', 'Liftoff', 'Facebook Audience Network', and 'Mediated house ads'.Ads
ad_unit_exposureNUMERICAd unit exposureThe time that an ad unit was exposed to a user, in milliseconds.Ads
ad_unit_nameTEXTAd unitThe 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_cartsNUMERICAdd to cartsThe number of times users added items to their shopping carts.Ecommerce
advertiser_ad_clicksNUMERICAds clicksTotal 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_costNUMERICAds costThe 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_clickNUMERICAds cost per clickAds cost per click is ad cost divided by ad clicks and is often abbreviated CPC.Advertiser Ad
advertiser_ad_impressionsNUMERICAds impressionsThe total number of impressions. Includes impressions from linked integrations like linked Display & Video 360 advertisers. Also includes uploaded impressions from data import.Advertiser Ad
ageTEXTAgeUser age brackets.User
app_versionTEXTApp versionThe app's versionName (Android) or short bundle version (iOS).Account
audience_idTEXTAudience idThe 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_nameTEXTAudience nameThe 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_revenueNUMERICAverage purchase revenueThe average purchase revenue in the transaction group of events.Event
average_purchase_revenue_per_paying_userNUMERICARPPUAverage 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_userNUMERICAverage purchase revenue per userThe 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_userNUMERICARPUAverage 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_durationNUMERICAverage session durationThe average duration (in seconds) of users' sessions.Event
bounce_rateNUMERICBounce rateThe 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_interestTEXTInterestsInterests 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
browserTEXTBrowserThe browsers used to view your website.Device
campaignTEXTCampaign (alias for Campaign name)The marketing campaign name for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.Session Source
campaign_idTEXTCampaign IDThe identifier of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.Event Source
campaign_nameTEXTCampaign nameThe marketing campaign name for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.Session Source
cart_to_view_rateNUMERICCart-to-view rateThe 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
characterTEXTCharacterThe player character in a game for an event. Populated by the event parameter 'character'.File Download
checkoutsNUMERICCheckoutsThe number of times users started the checkout process. This metric counts the occurrence of the 'begin_checkout' event.Ecommerce
cityCITYCityThe city from which the user activity originated.Geo
cityidTEXTCity IDThe geographic ID of the city from which the user activity originated, derived from their IP address.Geo
cohortTEXTCohortThe 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_usersNUMERICCohort active usersThe 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_dayTEXTDaily cohortDay 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_monthTEXTMonthly cohortMonth 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_weekTEXTWeekly cohortWeek 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_usersNUMERICCohort total usersThe 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_groupTEXTContent groupA category that applies to items of published content. Populated by the event parameter 'content_group'.Content
content_idTEXTContent IDThe identifier of the selected content. Populated by the event parameter 'content_id'.Content
content_typeTEXTContent typeThe category of the selected content. Populated by the event parameter 'content_type'.Content
continentTEXTContinentThe continent from which the user activity originated. For example, 'Americas' or 'Asia'.Geo
continentidTEXTContinent IDThe geographic ID of the continent from which the user activity originated, derived from their IP address.Geo
conversionsNUMERICConversionsThe 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_conversionNUMERICCost per conversionCost per conversion is ad cost divided by conversions.Advertiser Ad
countryCOUNTRYCountryThe country from which the user activity originated.Geo
country_idTEXTCountry IDThe 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_usersNUMERICCrash-affected usersThe 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_rateNUMERICCrash-free users rateThe 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
dateDATEDateThe date of the event, formatted as YYYYMMDD.Time
date_hourTEXTDate + hour (YYYYMMDDHH)The combined values of date and hour formatted as YYYYMMDDHH.Time
date_hour_minuteTEXTDate hour and minuteThe combined values of date, hour, and minute formatted as YYYYMMDDHHMM.Time
dau_per_mauNUMERICDAU / MAUThe 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_wauNUMERICDAU / WAUThe 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
dayTEXTDayThe day of the month, a two-digit number from 01 to 31.Time
day_of_weekTEXTDay of weekThe day of the week. It returns values in the range [0,6] with Sunday as the first day of the week.Time
default_channel_groupTEXTDefault channel groupThe 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
deviceTEXTDeviceThe branded device name (examples are Galaxy S10 or P30 Pro).Device
device_modelTEXTDevice modelThe mobile device model (example: iPhone 10,6).Device
devicecategoryTEXTDevice categoryThe type of device - Desktop, Tablet, or Mobile.Device
ecommerce_purchasesNUMERICEcommerce purchasesThe 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_sessionsNUMERICEngaged sessionsThe number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.Basic
engagement_ratePERCENTEngagement rateThe 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_campaignTEXTCampaign (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_countNUMERICEvent countThe count of events.Event
event_count_per_userNUMERICEvent count per userThe average number of events per user (Event count divided by Active users).Event
event_nameTEXTEvent nameThe name of the event.Event
event_valueNUMERICEvent valueThe sum of the event parameter named 'value'.Event
events_per_sessionNUMERICEvents per sessionThe average number of events per session (Event count divided by Sessions).Event
file_extensionTEXTFile extensionThe 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_nameTEXTFile nameThe 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_dateTEXTFirst session dateThe date the user's first session occurred, formatted as YYYYMMDD.User
first_time_purchaser_conversion_rateNUMERICFirst-time purchaser conversionThe 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_purchasersNUMERICFirst time purchasersThe number of users that completed their first purchase event.Ecommerce
first_time_purchasers_per_new_userNUMERICFirst-time purchasers per new userThe average number of first time purchasers per new user.Ecommerce
first_user_campaign_idTEXTFirst user campaign IDIdentifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.User Source
first_user_campaign_nameTEXTFirst user campaignName of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.User Source
first_user_default_channel_groupTEXTFirst user default channel groupThe 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_nameTEXTFirst user Google Ads account nameThe Account name from Google Ads that first acquired the user.User Source
first_user_google_ads_ad_group_idTEXTFirst user Google Ads ad group IDThe Ad Group Id in Google Ads that first acquired the user.User Source
first_user_google_ads_ad_group_nameTEXTFirst user Google Ads ad group nameThe Ad Group Name in Google Ads that first acquired the user.User Source
first_user_google_ads_ad_network_typeTEXTFirst user Google Ads ad network typeThe 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_idTEXTFirst user Google Ads campaign IDIdentifier of the Google Ads marketing campaign that first acquired the user.User Source
first_user_google_ads_campaign_nameTEXTFirst user Google Ads campaignName of the Google Ads marketing campaign that first acquired the user.User Source
first_user_google_ads_campaign_typeTEXTFirst user Google Ads campaign typeThe 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_idTEXTFirst user Google Ads creative IDThe ID of the Google Ads creative that first acquired the user. Creative IDs identify individual ads.User Source
first_user_google_ads_customer_idTEXTFirst user Google Ads customer IDThe 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_keywordTEXTFirst user Google Ads keyword textThe 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_queryTEXTFirst user Google Ads queryThe search query that first acquired the user.User Source
first_user_manual_ad_contentTEXTFirst user manual ad contentThe ad content that first acquired the user. Populated by the utm_content parameter.User Source
first_user_manual_termTEXTFirst user manual termThe term that first acquired the user. Populated by the utm_term parameter.User Source
first_user_mediumTEXTFirst user mediumThe medium that first acquired the user to your website or app.User Source
first_user_sourceTEXTFirst user sourceThe source that first acquired the user to your website or app.User Source
first_user_source_mediumTEXTFirst user source / mediumThe combined values of the dimensions 'firstUserSource' and 'firstUserMedium'.User Source
first_user_source_platformTEXTFirst user source platformThe 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_urlTEXTFull page URLThe 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
genderTEXTGenderUser gender.User
TEXTGoogle Ads account nameThe Account name from Google Ads for the campaign that led to the conversion event. Corresponds to customer.descriptive_name in the Google Ads API.
TEXTGoogle Ads ad group IDThe ad group id attributed to the conversion event.Event Source
TEXTGoogle Ads ad group nameThe ad group name attributed to the conversion event.Event Source
TEXTGoogle Ads ad network typeThe 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
TEXTGoogle Ads campaign IDThe campaign ID for the Google Ads campaign attributed to the conversion event.Event Source
TEXTGoogle Ads campaignThe campaign name for the Google Ads campaign attributed to the conversion event.Event Source
TEXTGoogle Ads campaign typeThe 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
TEXTGoogle Ads creative IDThe ID of the Google Ads creative attributed to the conversion event. Creative IDs identify individual ads.Event Source
TEXTGoogle Ads customer IDThe 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
TEXTGoogle Ads keyword textThe 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
TEXTGoogle Ads queryThe search query that led to the conversion event.Event Source
group_idTEXTGroup IDThe player group ID in a game for an event. Populated by the event parameter 'group_id'.Game Event
hostnameTEXTHostnameIncludes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com.Account
hourTEXTHourThe 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_eventTEXTIs conversion eventThe 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_affiliationTEXTItem affiliationThe name or code of the affiliate (partner/vendor; if any) associated with an individual item. Populated by the 'affiliation' item parameter.Ecommerce
item_brandTEXTItem brandBrand name of the item.Ecommerce
item_categoryTEXTItem categoryThe hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.Ecommerce
item_category2TEXTItem category 2The 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_category3TEXTItem category 3The 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_category4TEXTItem category 4The 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_category5TEXTItem category 5The 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_idTEXTItem IDThe ID of the item.Ecommerce
item_list_click_eventsNUMERICItem-list click eventsThe 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_rateNUMERICItem list click through rateThe 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_idTEXTItem list IDThe ID of the item list.Ecommerce
item_list_nameTEXTItem list nameThe name of the item list.Ecommerce
item_list_view_eventsNUMERICItem-list view eventsThe number of times the item list was viewed. This metric counts the occurrence of the 'view_item_list' event.Ecommerce
item_nameTEXTItem nameThe name of the item.Ecommerce
item_promotion_click_through_rateNUMERICItem promotion click through rateThe 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_nameTEXTItem promotion creative nameThe name of the item-promotion creative.Ecommerce
item_promotion_idTEXTItem promotion IDThe ID of the item promotion.Ecommerce
item_promotion_nameTEXTItem promotion nameThe name of the promotion for the item.Ecommerce
item_revenueNUMERICItem revenueThe 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_variantTEXTItem variantThe 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_eventsNUMERICItem view eventsThe number of times the item details were viewed. The metric counts the occurrence of the 'view_item' event.Ecommerce
items_added_to_cartNUMERICItems added to cartThe 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_outNUMERICItems checked outThe number of units checked out for a single item. This metric counts the quantity of items in 'begin_checkout' events.Ecommerce
items_clicked_in_listNUMERICItems clicked in listThe 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_promotionNUMERICItems clicked in promotionThe number of units clicked in promotion for a single item. This metric counts the quantity of items in 'select_promotion' events.Ecommerce
items_purchasedNUMERICItems purchasedThe number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events.Ecommerce
items_viewedNUMERICItems viewedThe number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.Ecommerce
items_viewed_in_listNUMERICItems viewed in listThe 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_promotionNUMERICItems viewed in promotionThe number of units viewed in promotion for a single item. This metric counts the quantity of items in 'view_promotion' events.Ecommerce
landing_pageTEXTLanding pageThe page path associated with the first pageview in a session.Content
landing_page_plus_query_stringTEXTLanding page + query stringThe page path + query string associated with the first pageview in a session.Content
languageTEXTLanguageThe language setting of the user's browser or device. e.g. EnglishDevice
language_codeTEXTLanguage codeThe language setting (ISO 639) of the user's browser or device. e.g. 'en-us'Device
levelTEXTLevelThe player's level in a game. Populated by the event parameter 'level'.Game Event
TEXTLink classesThe 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
TEXTLink domainThe 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
TEXTLink IDThe 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
TEXTLink textThe link text of the file download. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_text'.Outbound Link
TEXTLink URLThe 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_contentTEXTManual ad contentThe ad content attributed to the conversion event. Populated by the utm_content parameter.Event Source
manual_termTEXTManual termThe term attributed to the conversion event. Populated by the utm_term parameter.Event Source
mediumTEXTMediumThe medium attributed to the conversion event.Session Source
methodTEXTMethodThe method by which an event was triggered. Populated by the event parameter 'method'.Event
minuteTEXTMinuteThe 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_brandingTEXTDevice brandManufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).Device
mobile_device_modelTEXTMobile modelThe mobile device model name (examples: iPhone X or SM-G950F).Device
monthTEXTMonthThe month of the event, a two digit integer from 01 to 12.Time
new_vs_returningTEXTNew / returningNew users have 0 previous sessions, and returning users have 1 or more previous sessions. This dimension returns two values: 'new' or 'returning'.User
newusersNUMERICNew usersThe web page titles used on your site.Basic
nth_dayTEXTNth dayThe number of days since the start of the date range.Time
nth_hourTEXTNth hourThe number of hours since the start of the date range. The starting hour is 0000.Time
nth_minuteTEXTNth minuteThe number of minutes since the start of the date range. The starting minute is 0000.Time
nth_monthTEXTNth monthThe number of months since the start of a date range. The starting month is 0000.Time
nth_weekTEXTNth weekA number representing the number of weeks since the start of a date range.Time
nth_yearTEXTNth yearThe number of years since the start of the date range. The starting year is 0000.Time
operating_systemTEXTOperating systemThe operating systems used by visitors to your app or website. Includes desktop and mobile operating systems such as Windows and Android.Device
operating_system_versionTEXTOS versionThe 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_versionTEXTOperating system with versionThe operating system and version. For example, Android 10 or Windows 7.Device
order_couponTEXTOrder couponCode for the order-level coupon.Ecommerce
organic_google_search_average_positionNUMERICOrganic google search average positionThe 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_rateNUMERICOrganic google search click through rateThe 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_clicksNUMERICOrganic google search clicksThe number of organic Google Search clicks reported from Search Console. This metric requires an active Search Console link.Other
organic_google_search_impressionsNUMERICOrganic google search impressionsThe number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link.Other
outboundTEXTOutboundReturns '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_locationTEXTPage locationThe 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_pathTEXTPage pathThe 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_stringTEXTPage path + query stringThe 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_referrerTEXTPage referrerThe 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
pagetitleTEXTPage titleThe web page titles used on your site.Content
percent_scrolledTEXTPercent scrolledThe 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
platformTEXTPlatformThe 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_categoryTEXTPlatform / device categoryThe platform and type of device on which your website or mobile app ran. (example: Android / mobile)Device
promotion_clicksNUMERICPromotion clicksThe number of times an item promotion was clicked. This metric counts the occurrence of the 'select_promotion' event.Ecommerce
promotion_viewsNUMERICPromotion viewsThe number of times an item promotion was viewed. This metric counts the occurrence of the 'view_promotion' event.Ecommerce
publisher_ad_clicksNUMERICPublisher ad clicksThe number of ad_click events.Ads
publisher_ad_impressionsNUMERICPublisher ad impressionsThe number of ad_impression events.Ads
purchase_revenueNUMERICPurchase revenueThe 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_rateNUMERICPurchase-to-view rateThe 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_rateNUMERICPurchaser conversionThe 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
regionREGIONRegionThe geographic region from which the user activity originated, derived from their IP address.Geo
return_on_ad_spendNUMERICReturn on ad spendReturn On Ad Spend (ROAS) is total revenue divided by advertiser ad cost.Event
screen_page_viewsNUMERICViewsThe 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_sessionNUMERICViews per sessionThe 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_userNUMERICViews per userThe 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_resolutionTEXTScreen resolutionThe screen resolution of the user's monitor. For example, 1920x1080.Basic
scrolled_usersNUMERICScrolled usersThe number of unique users who scrolled down at least 90% of the page.Basic
search_termTEXTSearch termThe 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_idTEXTSession campaign IDThe marketing campaign id for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.Session Source
session_conversion_rateNUMERICSession conversion rateThe percentage of sessions in which any conversion event was triggered.Session Source
session_default_channel_groupTEXTSession default channel groupThe 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_nameTEXTSession Google Ads account nameThe 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_idTEXTSession Google Ads ad group IDThe Ad Group Id in Google Ads for a session.Session Source
session_google_ads_ad_group_nameTEXTSession Google Ads ad group nameThe Ad Group Name in Google Ads for a session.Session Source
session_google_ads_ad_network_typeTEXTSession Google Ads ad network typeThe 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_idTEXTSession Google Ads campaign IDThe Campaign ID for the Google Ads Campaign that led to this session.Session Source
session_google_ads_campaign_nameTEXTSession Google Ads campaignThe Campaign name for the Google Ads Campaign that led to this session.Session Source
session_google_ads_campaign_typeTEXTSession Google Ads campaign typeThe 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_idTEXTSession Google Ads creative IDThe 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_idTEXTSession Google Ads customer IDThe 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_keywordTEXTSession Google Ads keyword textThe 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_queryTEXTSession Google Ads queryThe search query that led to the session.Session Source
session_manual_ad_contentTEXTSession manual ad contentThe ad content that led to a session. Populated by the utm_content parameter.Session Source
session_manual_termTEXTSession manual termThe term that led to a session. Populated by the utm_term parameter.Session Source
session_sa360_ad_group_nameTEXTSession SA360 ad group nameThe Ad Group name from Search Ads 360 that led to this session.Session Source
session_sa360_campaign_idTEXTSession SA360 campaign IDThe Campaign ID from Search Ads 360 that led to this session.Session Source
session_sa360_campaign_nameTEXTSession SA360 campaignThe Campaign name from Search Ads 360 that led to this session.Session Source
session_sa360_creative_formatTEXTSession SA360 creative formatThe 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_idTEXTSession SA360 engine account IDThe ID of the engine account in SA360 that led to this session.Session Source
session_sa360_engine_account_nameTEXTSession SA360 engine account nameThe name of the engine account in SA360 that led to this session.Session Source
session_sa360_engine_account_typeTEXTSession SA360 engine account typeThe 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_keywordTEXTSession SA360 keyword textThe search engine keyword from Search Ads 360 that led to this session.Session Source
session_sa360_mediumTEXTSession SA360 mediumThe search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'.Session Source
session_sa360_queryTEXTSession SA360 queryThe search query from Search Ads 360 that led to this session.Session Source
session_sa360_sourceTEXTSession SA360 sourceThe source of the traffic from Search Ads 360 that led to this session. For example, 'example.com' or 'google'.Session Source
session_source_mediumTEXTSession source / mediumThe combined values of the dimensions 'sessionSource' and 'sessionMedium'.Session Source
session_source_platformTEXTSession source platformThe 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
sessionsNUMERICSessionsThe number of sessions that began on your site or app (event triggered: session_start).Session Source
sessions_per_userNUMERICSessions per userThe average number of sessions per user (Sessions divided by Active Users).Session Source
shipping_amountNUMERICShipping amountShipping amount associated with a transaction. Populated by the 'shipping' event parameter.Ecommerce
shipping_tierTEXTShipping tierThe 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_idTEXTSigned in with user IDThe string 'yes' if the user signed in with the User-ID feature. To learn more about User-ID, see .User
sourceTEXTSourceThe source attributed to the conversion event.Session Source
source_mediumTEXTSource / mediumThe combined values of the dimensions 'source' and 'medium'.Event Source
source_platformTEXTSource platformThe 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_idTEXTStream IDThe numeric data stream identifier for your app or website.Account
stream_nameTEXTStream nameThe data stream name for your app or website.Account
tax_amountNUMERICTax amountTax amount associated with a transaction. Populated by the 'tax' event parameter.Ecommerce
test_data_filter_idTEXTTest data filter IDThe 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_nameTEXTTest data filter nameThe 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_revenueNUMERICTotal ad revenueThe total advertising revenue from both Admob and third-party sources.Event
total_purchasersNUMERICTotal purchasersThe number of users that logged purchase events for the time period selected.Ecommerce
totalrevenueNUMERICTotal revenueThe sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue).Event
totalusersNUMERICTotal usersThe 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
transactionidTEXTTransaction IDThe ID of the ecommerce transaction.Ecommerce
transactionrevenueNUMERICTransaction revenue (alias for Total revenue)The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue).Event
transactionsNUMERICTransactionsThe 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_purchaserNUMERICTransactions per purchaserThe average numer of transactions per purchaser.Event
unified_page_path_screenTEXTPage path and screen classThe page path (web) or screen class (app) on which the event was logged.Content
unified_page_screenTEXTPage path + query string and screen classThe page path and query string (web) or screen class (app) on which the event was logged.Content
unified_screen_classTEXTPage title and screen classThe page title (web) or screen class (app) on which the event was logged.Content
unified_screen_nameTEXTPage title and screen nameThe page title (web) or screen name (app) on which the event was logged.Content
user_conversion_rateNUMERICUser conversion rateThe percentage of users who triggered any conversion event.Event
user_engagement_durationNUMERICUser engagementThe total amount of time (in seconds) your website or app was in the foreground of users' devices.Basic
usersNUMERICUsersAlias for active_users.User
video_providerTEXTVideo providerThe 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_titleTEXTVideo titleThe title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_title'.Video
video_urlTEXTVideo URLThe url of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_url'.Video
virtual_currency_nameTEXTVirtual currency nameThe 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
visibleTEXTVisibleReturns '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_mauNUMERICWAU / MAUThe 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
weekTEXTWeekThe 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
yearTEXTYearThe four-digit year of the event e.g. 2020.Time
todayDATETodayToday's date