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]


Fields

IDTypeNameDescription
account_idTEXTAccount IDThe Account ID
account_nameTEXTAccount NameThe Account Name
achievement_idTEXTAchievement IDThe achievement ID in a game for an event. Populated by the event parameter 'achievement_id'.
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.
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.
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.
active_usersNUMERICActive usersThe number of distinct users who visited your site or app.
ad_formatTEXTAd formatDescribes the way ads looked and where they were located. Typical formats include 'Interstitial', 'Banner', 'Rewarded', and 'Native advanced'.
ad_source_nameTEXTAd sourceThe source network that served the ad. Typical sources include 'AdMob Network', 'Liftoff', 'Facebook Audience Network', and 'Mediated house ads'.
ad_unit_exposureNUMERICAd unit exposureThe time that an ad unit was exposed to a user, in milliseconds.
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.
add_to_cartsNUMERICAdd to cartsThe number of times users added items to their shopping carts.
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_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_cost_per_clickNUMERICAds cost per clickAds cost per click is ad cost divided by ad clicks and is often abbreviated CPC.
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.
ageTEXTAgeUser age brackets.
app_versionTEXTApp versionThe app's versionName (Android) or short bundle version (iOS).
audience_idNUMERICAudience 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.
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.
average_purchase_revenueNUMERICAverage purchase revenueThe average purchase revenue in the transaction group of events.
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.
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.
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.
average_session_durationNUMERICAverage session durationThe average duration (in seconds) of users' sessions.
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.
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'.
browserTEXTBrowserThe browsers used to view your website.
campaignTEXTCampaign (alias for Campaign name)The name of the marketing campaign. Present only for conversion events.
campaign_idTEXTCampaign IDThe identifier of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
campaign_nameTEXTCampaign nameThe name of the marketing campaign. Present only for conversion events.
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.
characterTEXTCharacterThe player character in a game for an event. Populated by the event parameter 'character'.
checkoutsNUMERICCheckoutsThe number of times users started the checkout process. This metric counts the occurrence of the 'begin_checkout' event.
cityTEXTCityThe city from which the user activity originated.
cityidTEXTCity IDThe geographic ID of the city from which the user activity originated, derived from their IP address.
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_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_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_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_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_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.
content_groupTEXTContent groupA category that applies to items of published content. Populated by the event parameter 'content_group'.
content_idTEXTContent IDThe identifier of the selected content. Populated by the event parameter 'content_id'.
content_typeTEXTContent typeThe category of the selected content. Populated by the event parameter 'content_type'.
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 .
cost_per_conversionNUMERICCost per conversionCost per conversion is ad cost divided by conversions.
countryTEXTCountryThe country from which the user activity originated.
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.
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".
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.
dateDATEDateThe date of the event, formatted as YYYYMMDD.
date_hourTEXTDate + hour (YYYYMMDDHH)The combined values of date and hour formatted as YYYYMMDDHH.
date_hour_minuteTEXTDate hour and minuteThe combined values of date, hour, and minute formatted as YYYYMMDDHHMM.
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.
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.
dayTEXTDayThe day of the month, a two-digit number from 01 to 31.
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.
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'.
deviceTEXTDeviceThe branded device name (examples are Galaxy S10 or P30 Pro).
device_modelTEXTDevice modelThe mobile device model (example: iPhone 10,6).
devicecategoryTEXTDevice categoryThe type of device - Desktop, Tablet, or Mobile.
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.
engaged_sessionsNUMERICEngaged sessionsThe number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
engagement_rateNUMERICEngagement 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.
event_countNUMERICEvent countThe count of events.
event_count_per_userNUMERICEvent count per userThe average number of events per user (Event count divided by Active users).
event_nameTEXTEvent nameThe name of the event.
event_valueNUMERICEvent valueThe sum of the event parameter named 'value'.
events_per_sessionNUMERICEvents per sessionThe average number of events per session (Event count divided by Sessions).
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'.
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'.
first_session_dateTEXTFirst session dateThe date the user's first session occurred, formatted as YYYYMMDD.
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.
first_time_purchasersNUMERICFirst time purchasersThe number of users that completed their first purchase event.
first_time_purchasers_per_new_userNUMERICFirst-time purchasers per new userThe average number of first time purchasers per new user.
first_user_campaign_idTEXTFirst user campaign IDIdentifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
first_user_campaign_nameTEXTFirst user campaignName of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
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'.
first_user_google_ads_account_nameTEXTFirst user Google Ads account nameThe Account name from Google Ads that first acquired the user.
first_user_google_ads_ad_group_idTEXTFirst user Google Ads ad group IDThe Ad Group Id in Google Ads that first acquired the user.
first_user_google_ads_ad_group_nameTEXTFirst user Google Ads ad group nameThe Ad Group Name in Google Ads that first acquired the user.
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)'.
first_user_google_ads_campaign_idTEXTFirst user Google Ads campaign IDIdentifier of the Google Ads marketing campaign that first acquired the user.
first_user_google_ads_campaign_nameTEXTFirst user Google Ads campaignName of the Google Ads marketing campaign that first acquired the user.
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 .
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.
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.
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 .
first_user_google_ads_queryTEXTFirst user Google Ads queryThe search query that first acquired the user.
first_user_manual_ad_contentTEXTFirst user manual ad contentThe ad content that first acquired the user. Populated by the utm_content parameter.
first_user_manual_termTEXTFirst user manual termThe term that first acquired the user. Populated by the utm_term parameter.
first_user_mediumTEXTFirst user mediumThe medium that first acquired the user to your website or app.
first_user_sourceTEXTFirst user sourceThe source that first acquired the user to your website or app.
first_user_source_mediumTEXTFirst user source / mediumThe combined values of the dimensions 'firstUserSource' and 'firstUserMedium'.
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.
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.
genderTEXTGenderUser gender.
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.
TEXTGoogle Ads ad group nameThe ad group name attributed to the conversion event.
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)'.
TEXTGoogle Ads campaign IDThe campaign ID for the Google Ads campaign attributed to the conversion event.
TEXTGoogle Ads campaignThe campaign name for the Google Ads campaign attributed to the conversion event.
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 .
TEXTGoogle Ads creative IDThe ID of the Google Ads creative attributed to the conversion event. Creative IDs identify individual ads.
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.
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 .
TEXTGoogle Ads queryThe search query that led to the conversion event.
group_idTEXTGroup IDThe player group ID in a game for an event. Populated by the event parameter 'group_id'.
hostnameTEXTHostnameIncludes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com.
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.
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 .
item_affiliationTEXTItem affiliationThe name or code of the affiliate (partner/vendor; if any) associated with an individual item. Populated by the 'affiliation' item parameter.
item_brandTEXTItem brandBrand name of the item.
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.
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.
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.
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.
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.
item_idTEXTItem IDThe ID of the item.
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.
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.
item_list_idTEXTItem list IDThe ID of the item list.
item_list_nameTEXTItem list nameThe name of the item list.
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.
item_nameTEXTItem nameThe name of the item.
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.
item_promotion_creative_nameTEXTItem promotion creative nameThe name of the item-promotion creative.
item_promotion_idTEXTItem promotion IDThe ID of the item promotion.
item_promotion_nameTEXTItem promotion nameThe name of the promotion for the item.
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.
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.
item_view_eventsNUMERICItem view eventsThe number of times the item details were viewed. The metric counts the occurrence of the 'view_item' event.
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.
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.
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.
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.
items_purchasedNUMERICItems purchasedThe number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events.
items_viewedNUMERICItems viewedThe number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.
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.
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.
landing_pageTEXTLanding page + query stringThe page path + query string associated with the first pageview in a session.
languageTEXTLanguageThe language setting of the user's browser or device. e.g. English
language_codeTEXTLanguage codeThe language setting (ISO 639) of the user's browser or device. e.g. 'en-us'
levelTEXTLevelThe player's level in a game. Populated by the event parameter 'level'.
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'.
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'.
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'.
TEXTLink textThe link text of the file download. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter 'link_text'.
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'.
manual_ad_contentTEXTManual ad contentThe ad content attributed to the conversion event. Populated by the utm_content parameter.
manual_termTEXTManual termThe term attributed to the conversion event. Populated by the utm_term parameter.
mediumTEXTMediumThe medium attributed to the conversion event.
methodTEXTMethodThe method by which an event was triggered. Populated by the event parameter 'method'.
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.
mobile_device_brandingTEXTDevice brandManufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).
mobile_device_modelTEXTMobile modelThe mobile device model name (examples: iPhone X or SM-G950F).
monthTEXTMonthThe month of the event, a two digit integer from 01 to 12.
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'.
newusersNUMERICNew usersThe web page titles used on your site.
nth_dayTEXTNth dayThe number of days since the start of the date range.
nth_hourTEXTNth hourThe number of hours since the start of the date range. The starting hour is 0000.
nth_minuteTEXTNth minuteThe number of minutes since the start of the date range. The starting minute is 0000.
nth_monthTEXTNth monthThe number of months since the start of a date range. The starting month is 0000.
nth_weekTEXTNth weekA number representing the number of weeks since the start of a date range.
nth_yearTEXTNth yearThe number of years since the start of the date range. The starting year is 0000.
operating_systemTEXTOperating systemThe operating systems used by visitors to your app or website. Includes desktop and mobile operating systems such as Windows and Android.
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.
operating_system_with_versionTEXTOperating system with versionThe operating system and version. For example, Android 10 or Windows 7.
order_couponTEXTOrder couponCode for the order-level coupon.
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.
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.
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.
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.
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'.
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'.
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.
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.
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'.
pagetitleTEXTPage titleThe web page titles used on your site.
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'.
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.
platform_device_categoryTEXTPlatform / device categoryThe platform and type of device on which your website or mobile app ran. (example: Android / mobile)
promotion_clicksNUMERICPromotion clicksThe number of times an item promotion was clicked. This metric counts the occurrence of the 'select_promotion' event.
promotion_viewsNUMERICPromotion viewsThe number of times an item promotion was viewed. This metric counts the occurrence of the 'view_promotion' event.
publisher_ad_clicksNUMERICPublisher ad clicksThe number of ad_click events.
publisher_ad_impressionsNUMERICPublisher ad impressionsThe number of ad_impression events.
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.
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).
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.
regionTEXTRegionThe geographic region from which the user activity originated, derived from their IP address.
return_on_ad_spendNUMERICReturn on ad spendReturn On Ad Spend (ROAS) is total revenue divided by advertiser ad cost.
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).
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.
screen_resolutionTEXTScreen resolutionThe screen resolution of the user's monitor. For example, 1920x1080.
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'.
session_campaign_idTEXTSession campaign IDThe marketing campaign id for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
session_conversion_rateNUMERICSession conversion rateThe percentage of sessions in which any conversion event was triggered.
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_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_google_ads_ad_group_idTEXTSession Google Ads ad group IDThe Ad Group Id in Google Ads for a session.
session_google_ads_ad_group_nameTEXTSession Google Ads ad group nameThe Ad Group Name in Google Ads for a session.
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_google_ads_campaign_idTEXTSession Google Ads campaign IDThe Campaign ID for the Google Ads Campaign that led to this session.
session_google_ads_campaign_nameTEXTSession Google Ads campaignThe Campaign name for the Google Ads Campaign that led to this session.
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_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_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_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_google_ads_queryTEXTSession Google Ads queryThe search query that led to the session.
session_manual_ad_contentTEXTSession manual ad contentThe ad content that led to a session. Populated by the utm_content parameter.
session_manual_termTEXTSession manual termThe term that led to a session. Populated by the utm_term parameter.
session_mediumTEXTSession mediumThe medium that initiated a session on your website or app.
session_sa360_ad_group_nameTEXTSession SA360 ad group nameThe Ad Group name from Search Ads 360 that led to this session.
session_sa360_campaign_idTEXTSession SA360 campaign IDThe Campaign ID from Search Ads 360 that led to this session.
session_sa360_campaign_nameTEXTSession SA360 campaignThe Campaign name from Search Ads 360 that led to this session.
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_sa360_engine_account_idTEXTSession SA360 engine account IDThe ID of the engine account in SA360 that led to this session.
session_sa360_engine_account_nameTEXTSession SA360 engine account nameThe name of the engine account in SA360 that led to this session.
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_sa360_keywordTEXTSession SA360 keyword textThe search engine keyword from Search Ads 360 that led to this session.
session_sa360_mediumTEXTSession SA360 mediumThe search engine keyword from Search Ads 360 that led to this session. For example, 'cpc'.
session_sa360_queryTEXTSession SA360 queryThe search query from Search Ads 360 that led to this session.
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_mediumTEXTSession source / mediumThe combined values of the dimensions 'sessionSource' and 'sessionMedium'.
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.
sessionsNUMERICSessionsThe number of sessions that began on your site or app (event triggered: session_start).
sessions_per_userNUMERICSessions per userThe average number of sessions per user (Sessions divided by Active Users).
shipping_amountNUMERICShipping amountShipping amount associated with a transaction. Populated by the 'shipping' event parameter.
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.
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 .
sourceTEXTSourceThe source attributed to the conversion event.
source_mediumTEXTSource / mediumThe combined values of the dimensions 'source' and 'medium'.
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.
stream_idTEXTStream IDThe numeric data stream identifier for your app or website.
stream_nameTEXTStream nameThe data stream name for your app or website.
tax_amountNUMERICTax amountTax amount associated with a transaction. Populated by the 'tax' event parameter.
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 .
total_ad_revenueNUMERICTotal ad revenueThe total advertising revenue from both Admob and third-party sources.
total_purchasersNUMERICTotal purchasersThe number of users that logged purchase events for the time period selected.
totalrevenueNUMERICTotal revenueThe sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue).
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.
transactionidTEXTTransaction IDThe ID of the ecommerce transaction.
transactionrevenueNUMERICTransaction revenue (alias for Total revenue)The sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue).
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.
transactions_per_purchaserNUMERICTransactions per purchaserThe average numer of transactions per purchaser.
unified_page_path_screenTEXTPage path and screen classThe page path (web) or screen class (app) on which the event was logged.
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.
unified_screen_classTEXTPage title and screen classThe page title (web) or screen class (app) on which the event was logged.
unified_screen_nameTEXTPage title and screen nameThe page title (web) or screen name (app) on which the event was logged.
user_conversion_rateNUMERICUser conversion rateThe percentage of users who triggered any conversion event.
user_engagement_durationNUMERICUser engagementThe total amount of time (in seconds) your website or app was in the foreground of users' devices.
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_titleTEXTVideo titleThe title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_title'.
video_urlTEXTVideo URLThe url of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'video_url'.
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.
visibleTEXTVisibleReturns 'true' if the content is visible. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter 'visible'.
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.
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.
yearTEXTYearThe four-digit year of the event e.g. 2020.