API Dimensions & Metrics

The dimensions and metrics you can use in Data API Core Reporting queries.

Dimensions

The following dimensions can be requested in reports for any property. Specify the "API Name" in a Dimension resource's name field for a column of the dimension in the report response.

API NameUI NameDescription
achievementIdAchievement IDThe achievement ID in a game for an event. Populated by the event parameter achievement_id.
adFormatAd formatDescribes the way ads looked and where they were located. Typical formats include Interstitial, Banner, Rewarded, and Native advanced.
adSourceNameAd sourceThe source network that served the ad. Typical sources include AdMob Network, Liftoff, Facebook Audience Network, and Mediated house ads.
adUnitNameAd unitThe name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users.
appVersionApp versionThe app's versionName (Android) or short bundle version (iOS).
audienceIdAudience 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.
audienceNameAudience 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.
audienceResourceNameAudience resource nameThe resource name of this audience. Resource names contain both collection & resource identifiers to uniquely identify a resource; to learn more, see Resource names.
brandingInterestInterestsInterests 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/Beacund Travelers.
browserBrowserThe browsers used to view your website.
campaignIdCampaign IDThe identifier of the marketing campaign. Present only for key events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
campaignNameCampaignThe name of the marketing campaign. Present only for key events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
characterCharacterThe player character in a game for an event. Populated by the event parameter character.
cityCityThe city from which the user activity originated.
cityIdCity IDThe geographic ID of the city from which the user activity originated, derived from their IP address.
cm360AccountIdCM360 account IDThe CM360 Account ID that led to the key event. Identifies the CM360 Account.
cm360AccountNameCM360 account nameThe CM360 Account Name that led to the key event. A CM360 account consists of advertisers, sites, campaigns, and user profiles.
cm360AdvertiserIdCM360 advertiser IDThe CM360 Advertiser ID that led to the key event. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.
cm360AdvertiserNameCM360 advertiser nameThe CM360 Advertiser Name that led to the key event. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.
cm360CampaignIdCM360 campaign IDThe CM360 Campaign ID that led to the key event. A CM360 campaign can be configured to specify when your ads run, what landing pages are used, and other properties.
cm360CampaignNameCM360 campaign nameThe CM360 Campaign Name that led to the key event. A CM360 campaign can be configured to specify when your ads run, what landing pages are used, and other properties.
cm360CreativeFormatCM360 creative formatThe CM360 Creative Format that led to the key event. CM360 creative formats are also referred to as creative types.
cm360CreativeIdCM360 creative IDThe CM360 Creative ID that led to the key event. Identifies a CM360 creative.
cm360CreativeNameCM360 creative nameThe CM360 Creative Name that led to the key event. The name given to a CM360 creative.
cm360CreativeTypeCM360 creative typeThe CM360 Creative Type that led to the key event. A category of CM360 creatives like 'Display' or 'Tracking'. To learn more, see manage creatives
cm360CreativeTypeIdCM360 creative type IDThe CM360 Creative Type ID that led to the key event. Identifies a CM360 creative type.
cm360CreativeVersionCM360 creative versionThe CM360 Creative Version that led to the key event. The version number helps you keep track of multiple versions of your creative in your reports. If you upload a new asset to an existing creative, the version number is increased by one.
cm360MediumCM360 mediumThe CM360 Medium that led to the key event. The CM360 medium is also referred to as the placement cost structure.
cm360PlacementCostStructureCM360 placement cost structureThe CM360 Placement Cost Structure that led to the key event. Placement cost structures regulate how media cost will be calculated. For example 'CPM'.
cm360PlacementIdCM360 placement IDThe CM360 Placement ID that led to the key event. Identifies a CM360 placement. A placement is the part of a website where your ad appears.
cm360PlacementNameCM360 placement nameThe CM360 Placement Name that led to the key event. The given name for a CM360 placement. A placement is the part of a website where your ad appears.
cm360RenderingIdCM360 rendering IDThe CM360 Rendering ID that led to the key event. Identifies a CM360 creative.
cm360SiteIdCM360 site IDThe CM360 Site ID that led to the key event. Identifies a CM360 site.
cm360SiteNameCM360 site nameThe CM360 Site Name that led to the key event. The CM360 Site name from which the ad space was purchased.
cm360SourceCM360 sourceThe CM360 Source that led to the key event. The CM360 source is also referred to as the site name.
cm360SourceMediumCM360 source / mediumThe CM360 Source Medium that led to the key event. A combination of the source and medium.
cohortCohortThe 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 such as cohort_0 and cohort_1.
cohortNthDayDaily 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.
cohortNthMonthMonthly 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.
cohortNthWeekWeekly 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.
contentGroupContent groupA category that applies to items of published content. Populated by the event parameter content_group.
contentIdContent IDThe identifier of the selected content. Populated by the event parameter content_id.
contentTypeContent typeThe category of the selected content. Populated by the event parameter content_type.
continentContinentThe continent from which the user activity originated. For example, Americas or Asia.
continentIdContinent IDThe geographic ID of the continent from which the user activity originated, derived from their IP address.
countryCountryThe country from which the user activity originated.
countryIdCountry 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.
currencyCodeCurrencyThe local currency code (based on ISO 4217 standard) of the eCommerce event. For example, USD or GBP. Currency is specified in tagging by the currency parameter. Businesses that transact in more than one currency can specify a local currency code when sending eCommerce events to Analytics, and this dimension shows those currencies. To Learn more, See Currency reference.
dateDateThe date of the event, formatted as YYYYMMDD.
dateHourDate + hour (YYYYMMDDHH)The combined values of date and hour formatted as YYYYMMDDHH.
dateHourMinuteDate hour and minuteThe combined values of date, hour, and minute formatted as YYYYMMDDHHMM.
dayDayThe day of the month, a two-digit number from 01 to 31.
dayOfWeekDay of weekThe integer day of the week. It returns values in the range 0 to 6 with Sunday as the first day of the week.
dayOfWeekNameDay of week nameThe day of the week in English. This dimension has values such as Sunday or Monday.
defaultChannelGroupDefault channel groupThe key event'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.
deviceCategoryDevice categoryThe type of device: Desktop, Tablet, or Mobile.
deviceModelDevice modelThe mobile device model (example: iPhone 10,6).
dv360AdvertiserIdDV360 advertiser IDThe DV360 Advertiser ID that led to the key event. Identifies the DV360 advertiser.
dv360AdvertiserNameDV360 advertiser nameThe DV360 Advertiser Name that led to the key event. DV360 advertisers represent real-life businesses that run advertising campaigns.
dv360CampaignIdDV360 campaign IDThe DV360 Campaign ID that led to the key event. Identifies the DV360 campaign.
dv360CampaignNameDV360 campaign nameThe DV360 Campaign Name that led to the key event. DV360 campaigns group together related insertion orders with a common business goal.
dv360CreativeFormatDV360 creative formatThe DV360 Creative Format that led to the key event. Also referred to as the creative type. For example, expandable, video, or native.
dv360CreativeIdDV360 creative IDThe DV360 Creative ID that led to the key event. Identifies the DV360 creative.
dv360CreativeNameDV360 creative nameThe DV360 Creative Name that led to the key event. The name given to a DV360 creative.
dv360ExchangeIdDV360 exchange IDThe DV360 Exchange ID that led to the key event. Identifies the DV360 exchange.
dv360ExchangeNameDV360 exchange nameThe DV360 Exchange Name that led to the key event. The DV360 ad exchange involved in the ad click. To learn more, see managing exchanges.
dv360InsertionOrderIdDV360 insertion order IDThe DV360 Insertion Order ID that led to the key event. Identifies the DV360 insertion order.
dv360InsertionOrderNameDV360 insertion order nameThe DV360 Insertion Order Name that led to the key event. A DV360 insertion order contains a set of line items that are related to the same advertising campaign.
dv360LineItemIdDV360 line item IDThe DV360 Line Item ID that led to the key event. Identifies the DV360 line item.
dv360LineItemNameDV360 line item nameThe DV360 Line Item Name that led to the key event. A DV360 line item bids on impressions and serves creatives to inventory sources.
dv360MediumDV360 mediumThe DV360 Medium that led to the key event. The billable outcome of the insertion order. For example, cpm.
dv360PartnerIdDV360 partner IDThe DV360 Partner ID that led to the key event. Identifies the DV360 partner.
dv360PartnerNameDV360 partner nameThe DV360 Partner Name that led to the key event. DV360 partners represent agencies, trading desks, or large individual advertisers.
dv360SourceDV360 sourceThe DV360 Source that led to the key event. The DV360 site name where your ad was displayed.
dv360SourceMediumDV360 source / mediumThe DV360 Source Medium that led to the key event. A combination of the source and medium.
eventNameEvent nameThe name of the event.
fileExtensionFile 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.
fileNameFile 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.
firstSessionDateFirst session dateThe date the user's first session occurred, formatted as YYYYMMDD.
firstUserCampaignIdFirst user campaign IDIdentifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
firstUserCampaignNameFirst user campaignName of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
firstUserCm360AccountIdFirst user CM360 account IDThe CM360 Account ID that originally acquired the user. Identifies the CM360 account.
firstUserCm360AccountNameFirst user CM360 account nameThe CM360 Account Name that originally acquired the user. A CM360 account consists of advertisers, sites, campaigns, and user profiles.
firstUserCm360AdvertiserIdFirst user CM360 advertiser IDThe CM360 Advertiser ID that originally acquired the user. Identifies the CM360 advertiser.
firstUserCm360AdvertiserNameFirst user CM360 advertiser nameThe CM360 Advertiser Name that originally acquired the user. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.
firstUserCm360CampaignIdFirst user CM360 campaign IDThe CM360 Campaign ID that originally acquired the user. Identifies the CM360 campaign.
firstUserCm360CampaignNameFirst user CM360 campaign nameThe CM360 Campaign Name that originally acquired the user. A CM360 campaign can be configured to specify when your ads run, what landing pages are used, and other properties.
firstUserCm360CreativeFormatFirst user CM360 creative formatThe CM360 Creative Format that originally acquired the user. CM360 creative formats are also referred to as creative types.
firstUserCm360CreativeIdFirst user CM360 creative IDThe CM360 Creative ID that originally acquired the user. Identifies a CM360 creative.
firstUserCm360CreativeNameFirst user CM360 creative nameThe CM360 Creative Name that originally acquired the user. The name given to a CM360 creative.
firstUserCm360CreativeTypeFirst user CM360 creative typeThe CM360 Creative Type that originally acquired the user. A category of CM360 creatives like 'Display' or 'Tracking'. To learn more, see manage creatives
firstUserCm360CreativeTypeIdFirst user CM360 creative type IDThe CM360 Creative Type ID that originally acquired the user. Identifies a CM360 creative type.
firstUserCm360CreativeVersionFirst user CM360 creative versionThe CM360 Creative Version that originally acquired the user. The version number helps you keep track of multiple versions of your creative in your reports. If you upload a new asset to an existing creative, the version number is increased by one.
firstUserCm360MediumFirst user CM360 mediumThe CM360 Medium that originally acquired the user. The CM360 medium is also referred to as the placement cost structure.
firstUserCm360PlacementCostStructureFirst user CM360 placement cost structureThe CM360 Placement Cost Structure that originally acquired the user. Placement cost structures regulate how media cost will be calculated. For example 'CPM'.
firstUserCm360PlacementIdFirst user CM360 placement IDThe CM360 Placement ID that originally acquired the user. Identifies a CM360 placement. A placement is the part of a website where your ad appears.
firstUserCm360PlacementNameFirst user CM360 placement nameThe CM360 Placement Name that originally acquired the user. The given name for a CM360 placement. A placement is the part of a website where your ad appears.
firstUserCm360RenderingIdFirst user CM360 rendering IDThe CM360 Rendering ID that originally acquired the user. Identifies a CM360 creative.
firstUserCm360SiteIdFirst user CM360 site IDThe CM360 Site ID that originally acquired the user. Identifies a CM360 site.
firstUserCm360SiteNameFirst user CM360 site nameThe CM360 Site Name that originally acquired the user. The CM360 Site name from which the ad space was purchased.
firstUserCm360SourceFirst user CM360 sourceThe CM360 Source that originally acquired the user. The CM360 source is also referred to as the site name.
firstUserCm360SourceMediumFirst user CM360 source / mediumThe CM360 Source Medium that originally acquired the user. A combination of the source and medium.
firstUserDefaultChannelGroupFirst 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.
firstUserDv360AdvertiserIdFirst user DV360 advertiser IDThe DV360 Advertiser ID that originally acquired the user. Identifies the DV360 advertiser.
firstUserDv360AdvertiserNameFirst user DV360 advertiser nameThe DV360 Advertiser Name that originally acquired the user. DV360 advertisers represent real-life businesses that run advertising campaigns.
firstUserDv360CampaignIdFirst user DV360 campaign IDThe DV360 Campaign ID that originally acquired the user. Identifies the DV360 campaign.
firstUserDv360CampaignNameFirst user DV360 campaign nameThe DV360 Campaign Name that originally acquired the user. DV360 campaigns group together related insertion orders with a common business goal.
firstUserDv360CreativeFormatFirst user DV360 creative formatThe DV360 Creative Format that originally acquired the user. Also referred to as the creative type. For example, expandable, video, or native.
firstUserDv360CreativeIdFirst user DV360 creative IDThe DV360 Creative ID that originally acquired the user. Identifies the DV360 creative.
firstUserDv360CreativeNameFirst user DV360 creative nameThe DV360 Creative Name that originally acquired the user. The name given to a DV360 creative.
firstUserDv360ExchangeIdFirst user DV360 exchange IDThe DV360 Exchange ID that originally acquired the user. Identifies the DV360 exchange.
firstUserDv360ExchangeNameFirst user DV360 exchange nameThe DV360 Exchange Name that originally acquired the user. The DV360 ad exchange involved in the ad click. To learn more, see managing exchanges.
firstUserDv360InsertionOrderIdFirst user DV360 insertion order IDThe DV360 Insertion Order ID that originally acquired the user. Identifies the DV360 insertion order.
firstUserDv360InsertionOrderNameFirst user DV360 insertion order nameThe DV360 Insertion Order Name that originally acquired the user. A DV360 insertion order contains a set of line items that are related to the same advertising campaign.
firstUserDv360LineItemIdFirst user DV360 line item IDThe DV360 Line Item ID that originally acquired the user. Identifies the DV360 line item.
firstUserDv360LineItemNameFirst user DV360 line item nameThe DV360 Line Item Name that originally acquired the user. A DV360 line item bids on impressions and serves creatives to inventory sources.
firstUserDv360MediumFirst user DV360 mediumThe DV360 Medium that originally acquired the user. The billable outcome of the insertion order. For example, cpm.
firstUserDv360PartnerIdFirst user DV360 partner IDThe DV360 Partner ID that originally acquired the user. Identifies the DV360 partner.
firstUserDv360PartnerNameFirst user DV360 partner nameThe DV360 Partner Name that originally acquired the user. DV360 partners represent agencies, trading desks, or large individual advertisers.
firstUserDv360SourceFirst user DV360 sourceThe DV360 Source that originally acquired the user. The DV360 site name where your ad was displayed.
firstUserDv360SourceMediumFirst user DV360 source / mediumThe DV360 Source Medium that originally acquired the user. A combination of the source and medium.
firstUserGoogleAdsAccountNameFirst user Google Ads account nameThe Account name from Google Ads that first acquired the user.
firstUserGoogleAdsAdGroupIdFirst user Google Ads ad group IDThe Ad Group Id in Google Ads that first acquired the user.
firstUserGoogleAdsAdGroupNameFirst user Google Ads ad group nameThe Ad Group Name in Google Ads that first acquired the user.
firstUserGoogleAdsAdNetworkTypeFirst 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).
firstUserGoogleAdsCampaignIdFirst user Google Ads campaign IDIdentifier of the Google Ads marketing campaign that first acquired the user.
firstUserGoogleAdsCampaignNameFirst user Google Ads campaignName of the Google Ads marketing campaign that first acquired the user.
firstUserGoogleAdsCampaignTypeFirst 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, Demand Gen, App, Smart, Hotel, Local, and Performance Max. To learn more, see Choose the right campaign type.
firstUserGoogleAdsCreativeIdFirst user Google Ads creative IDThe ID of the Google Ads creative that first acquired the user. Creative IDs identify individual ads.
firstUserGoogleAdsCustomerIdFirst 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.
firstUserGoogleAdsKeywordFirst user Google Ads keyword textFirst user Google Ads keyword text
firstUserGoogleAdsQueryFirst user Google Ads queryThe search query that first acquired the user.
firstUserManualAdContentFirst user manual ad contentThe ad content that first acquired the user. Populated by the utm_content parameter.
firstUserManualCampaignIdFirst user manual campaign IDThe manual Campaign ID that originally acquired the user. Identifies the manual campaign. Populated by utm_id URL parameter.
firstUserManualCampaignNameFirst user manual campaign nameThe manual Campaign Name that originally acquired the user. The name of the manual campaign. Populated by utm_campaign URL parameter. To learn more, see Collect campaign data with custom URLs.
firstUserManualCreativeFormatFirst user manual creative formatThe manual Creative Format that originally acquired the user. Identifies the creative format used in the ad. Populated by utm_creative_format URL parameter.
firstUserManualMarketingTacticFirst user manual marketing tacticThe manual Marketing Tactic that originally acquired the user. The targeting criteria applied to a campaign. For example, remarketing or prospecting. Populated by utm_marketing_tactic URL parameter.
firstUserManualMediumFirst user manual mediumThe manual Medium that originally acquired the user. The marketing medium used in the referral. For example, cpc. Populated by utm_medium URL parameter.
firstUserManualSourceFirst user manual sourceThe manual Source that originally acquired the user. The referrer. Populated by utm_source URL parameter.
firstUserManualSourceMediumFirst user manual source / mediumThe manual Source Medium that originally acquired the user. A combination of the source and medium.
firstUserManualSourcePlatformFirst user manual source platformThe manual Source Platform that originally acquired the user. The platform responsible for directing traffic to a given Analytics property. Populated by utm_source_platform URL parameter.
firstUserManualTermFirst user manual termThe term that first acquired the user. Populated by the utm_term parameter.
firstUserMediumFirst user mediumThe medium that first acquired the user to your website or app.
firstUserPrimaryChannelGroupFirst user primary channel groupThe primary channel group that originally acquired a user. Primary channel groups are the channel groups used in standard reports in Google Analytics and serve as an active record of your property's data in alignment with channel grouping over time. To learn more, see Custom channel groups.
firstUserSa360AdGroupIdFirst user SA360 ad group IDThe SA360 Ad Group ID that originally acquired the user. Identifies the SA360 ad group.
firstUserSa360AdGroupNameFirst user SA360 ad group nameThe SA360 Ad Group Name that originally acquired the user. SA360 Ad groups contain ads and keywords that relate to each other.
firstUserSa360CampaignIdFirst user SA360 campaign IDThe SA360 Campaign ID that originally acquired the user. Identifies the SA360 campaign.
firstUserSa360CampaignNameFirst user SA360 campaignThe SA360 Campaign Name that originally acquired the user. A SA360 campaign lets you organize your ads and define a goal for your advertising.
firstUserSa360CreativeFormatFirst user SA360 creative formatThe SA360 Creative Format that originally acquired the user. The creative format is the specific layout or design of the advertisement used in a campaign.
firstUserSa360EngineAccountIdFirst user SA360 engine account IDThe SA360 Engine Account ID that originally acquired the user. Identifies the SA360 engine account.
firstUserSa360EngineAccountNameFirst user SA360 engine account nameThe SA360 Engine Account Name that originally acquired the user. A SA360 engine account contains campaigns, ad groups, and other items from an advertising account.
firstUserSa360EngineAccountTypeFirst user SA360 engine account typeThe SA360 Engine Account Type that originally acquired the user. The type of engine used by the search engine account.
firstUserSa360KeywordTextFirst user SA360 keyword textThe SA360 Keyword Text that originally acquired the user. The keywords that matched the search query.
firstUserSa360ManagerAccountIdFirst user SA360 manager account IDThe SA360 Manager Account ID that originally acquired the user. Identifies the SA360 manager account.
firstUserSa360ManagerAccountNameFirst user SA360 manager account nameThe SA360 Manager Account Name that originally acquired the user. The top level of the Search Ads 360 account hierarchy and is used for administration and reporting across the lower-level sub-manager and client accounts.
firstUserSa360MediumFirst user SA360 mediumThe SA360 Medium that originally acquired the user. The payment mode used in ad buying. For example, cpc.
firstUserSa360QueryFirst user SA360 queryThe SA360 Query that originally acquired the user. The search query typed by the user.
firstUserSa360SourceFirst user SA360 sourceThe SA360 Source that originally acquired the user. The search query happened on this site.
firstUserSa360SourceMediumFirst user SA360 source / mediumThe SA360 Source Medium that originally acquired the user. A combination of the source and medium.
firstUserSourceFirst user sourceThe source that first acquired the user to your website or app.
firstUserSourceMediumFirst user source / mediumThe combined values of the dimensions firstUserSource and firstUserMedium.
firstUserSourcePlatformFirst user source platformThe source platform that first acquired the user. Don't 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.
fullPageUrlFull 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.
googleAdsAccountNameGoogle Ads account nameThe Account name from Google Ads for the campaign that led to the key event. Corresponds to customer.descriptive_name in the Google Ads API.
googleAdsAdGroupIdGoogle Ads ad group IDThe Google Ads ad group ID attributed to the key event.
googleAdsAdGroupNameGoogle Ads ad group nameThe ad group name attributed to the key event.
googleAdsAdNetworkTypeGoogle Ads ad network typeThe advertising network type of the key event. An enumeration which includes Google search, Search partners, Google Display Network, Youtube Search, Youtube Videos, Cross-network, Social, and (universal campaign).
googleAdsCampaignIdGoogle Ads campaign IDThe campaign ID for the Google Ads campaign attributed to the key event.
googleAdsCampaignNameGoogle Ads campaignThe campaign name for the Google Ads campaign attributed to the key event.
googleAdsCampaignTypeGoogle Ads campaign typeThe campaign type for the Google Ads campaign attributed to the key 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, Demand Gen, App, Smart, Hotel, Local, and Performance Max. To learn more, see Choose the right campaign type.
googleAdsCreativeIdGoogle Ads creative IDThe ID of the Google Ads creative attributed to the key event. Creative IDs identify individual ads.
googleAdsCustomerIdGoogle Ads customer IDThe Customer ID from Google Ads for the campaign that led to key event. Customer IDs in Google Ads uniquely identify Google Ads accounts.
googleAdsKeywordGoogle Ads keyword textThe matched keyword that led to the key 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 Keywords: Definition.
googleAdsQueryGoogle Ads queryThe search query that led to the key event.
groupIdGroup IDThe player group ID in a game for an event. Populated by the event parameter group_id.
hostNameHostnameIncludes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com.
hourHourThe 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.
isKeyEventIs key eventThe string true if the event is a key event. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as first_open or purchase) are marked as key events by default.
isoWeekISO week of the yearISO week number, where each week starts on Monday. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 01, 02, & 53.
isoYearISO yearThe ISO year of the event. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 2022 & 2023.
isoYearIsoWeekISO week of ISO yearThe combined values of isoWeek and isoYear. Example values include 201652 & 201701.
itemAffiliationItem affiliationThe name or code of the affiliate (partner/vendor; if any) associated with an individual item. Populated by the affiliation item parameter.
itemBrandItem brandBrand name of the item.
itemCategoryItem categoryThe hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.
itemCategory2Item 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.
itemCategory3Item 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.
itemCategory4Item 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.
itemCategory5Item 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.
itemIdItem IDThe ID of the item.
itemListIdItem list IDThe ID of the item list.
itemListNameItem list nameThe name of the item list.
itemListPositionItem list positionThe position of an item in a list. For example, a product you sell in a list. This dimension is populated in tagging by the index parameter in the items array.
itemLocationIDItem location IDThe physical location associated with the item. For example, the physical store location. It's recommended to use the Google Place ID that corresponds to the associated item. A custom location ID can also be used. This field is populated in tagging by the location_id parameter in the items array.
itemNameItem nameThe name of the item.
itemPromotionCreativeNameItem promotion creative nameThe name of the item-promotion creative.
itemPromotionCreativeSlotItem promotion creative slotThe name of the promotional creative slot associated with the item. This dimension can be specified in tagging by the creative_slot parameter at the event or item level. If the parameter is specified at both the event & item level, the item-level parameter is used.
itemPromotionIdItem promotion IDThe ID of the item promotion.
itemPromotionNameItem promotion nameThe name of the promotion for the item.
itemVariantItem variantThe specific variation of a product. For example, XS, S, M, or L for size; or Red, Blue, Green, or Black for color. Populated by the item_variant parameter.
landingPageLanding pageThe page path associated with the first pageview in a session.
landingPagePlusQueryStringLanding page + query stringThe page path + query string associated with the first pageview in a session.
languageLanguageThe language setting of the user's browser or device. For example, English.
languageCodeLanguage codeThe language setting (ISO 639) of the user's browser or device. For example, en-us.
levelLevelThe player's level in a game. Populated by the event parameter level.
linkClassesLink classesThe HTML class attribute for an outbound link. For example if a user clicks a link <a class="center" href="www.youtube.com">, this dimension will return center. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter link_classes.
linkDomainLink domainThe destination domain of the outbound link. For example if a user clicks a link <a href="www.youtube.com">, this dimension will return youtube.com. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter link_domain.
linkIdLink IDThe HTML ID attribute for an outbound link or file download. For example if a user clicks a link <a id="socialLinks" href="www.youtube.com">, this dimension will return socialLinks. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter link_id.
linkTextLink textThe link text of the file download. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter link_text.
linkUrlLink URLThe full URL for an outbound link or file download. For example if a user clicks a link <a href="https://www.youtube.com/results?search_query=analytics">, 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.
manualAdContentManual ad contentThe ad content attributed to the key event. Populated by the utm_content parameter.
manualCampaignIdManual campaign IDThe manual Campaign ID that led to the key event. Identifies the manual campaign. Populated by utm_id URL parameter.
manualCampaignNameManual campaign nameThe manual Campaign Name that led to the key event. The name of the manual campaign. Populated by utm_campaign URL parameter. To learn more, see Collect campaign data with custom URLs.
manualCreativeFormatManual creative formatThe manual Creative Format that led to the key event. Identifies the creative format used in the ad. Populated by utm_creative_format URL parameter.
manualMarketingTacticManual marketing tacticThe manual Marketing Tactic that led to the key event. The targeting criteria applied to a campaign. For example, remarketing or prospecting. Populated by utm_marketing_tactic URL parameter.
manualMediumManual mediumThe manual Medium that led to the key event. The marketing medium used in the referral. For example, cpc. Populated by utm_medium URL parameter.
manualSourceManual sourceThe manual Source that led to the key event. The referrer. Populated by utm_source URL parameter.
manualSourceMediumManual source / mediumThe manual Source Medium that led to the key event. A combination of the source and medium.
manualSourcePlatformManual source platformThe manual Source Platform that led to the key event. The platform responsible for directing traffic to a given Analytics property. Populated by utm_source_platform URL parameter.
manualTermManual termThe term attributed to the key event. Populated by the utm_term parameter.
mediumMediumThe medium attributed to the key event.
methodMethodThe method by which an event was triggered. Populated by the event parameter method.
minuteMinuteThe 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.
mobileDeviceBrandingDevice brandManufacturer or branded name (examples: Samsung, HTC, Verizon, T-Mobile).
mobileDeviceMarketingNameDeviceThe branded device name (examples: Galaxy S10 or P30 Pro).
mobileDeviceModelMobile modelThe mobile device model name (examples: iPhone X or SM-G950F).
monthMonthThe month of the event, a two digit integer from 01 to 12.
newVsReturningNew / returningNew users have 0 previous sessions, and returning users have 1 or more previous sessions. This dimension returns two values: new or returning.
nthDayNth dayThe number of days since the start of the date range.
nthHourNth hourThe number of hours since the start of the date range. The starting hour is 0000.
nthMinuteNth minuteThe number of minutes since the start of the date range. The starting minute is 0000.
nthMonthNth monthThe number of months since the start of a date range. The starting month is 0000.
nthWeekNth weekA number representing the number of weeks since the start of a date range.
nthYearNth yearThe number of years since the start of the date range. The starting year is 0000.
operatingSystemOperating systemThe operating systems used by visitors to your app or website. Includes desktop and mobile operating systems such as Windows and Android.
operatingSystemVersionOS 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.
operatingSystemWithVersionOperating system with versionThe operating system and version. For example, Android 10 or Windows 7.
orderCouponOrder couponCode for the order-level coupon.
outboundOutboundReturns true if the link led to a site that is not a part of the property's domain. Automatically populated if Enhanced Measurement is enabled. Populated by the event parameter outbound.
pageLocationPage 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.
pagePathPage 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.
pagePathPlusQueryStringPage 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.
pageReferrerPage 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.
pageTitlePage titleThe web page titles used on your site.
percentScrolledPercent 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.
platformPlatformThe 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.
platformDeviceCategoryPlatform / device categoryThe platform and type of device on which your website or mobile app ran. (example: Android / mobile)
primaryChannelGroupPrimary channel groupThe primary channel group attributed to the key event. Primary channel groups are the channel groups used in standard reports in Google Analytics and serve as an active record of your property's data in alignment with channel grouping over time. To learn more, see Custom channel groups.
regionRegionThe geographic region from which the user activity originated, derived from their IP address.
sa360AdGroupIdSA360 ad group IDThe SA360 Ad Group ID that led to the key event. Identifies the SA360 ad group.
sa360AdGroupNameSA360 ad group nameThe SA360 Ad Group Name that led to the key event. SA360 Ad groups contain ads and keywords that relate to each other.
sa360CampaignIdSA360 campaign IDThe SA360 Campaign ID that led to the key event. Identifies the SA360 campaign.
sa360CampaignNameSA360 campaignThe SA360 Campaign Name that led to the key event. A SA360 campaign lets you organize your ads and define a goal for your advertising.
sa360CreativeFormatSA360 creative formatThe SA360 Creative Format that led to the key event. The creative format is the specific layout or design of the advertisement used in a campaign.
sa360EngineAccountIdSA360 engine account IDThe SA360 Engine Account ID that led to the key event. Identifies the SA360 engine account.
sa360EngineAccountNameSA360 engine account nameThe SA360 Engine Account Name that led to the key event. A SA360 engine account contains campaigns, ad groups, and other items from an advertising account.
sa360EngineAccountTypeSA360 engine account typeThe SA360 Engine Account Type that led to the key event. The type of engine used by the search engine account.
sa360KeywordTextSA360 keyword textThe SA360 Keyword Text that led to the key event. The keywords that matched the search query.
sa360ManagerAccountIdSA360 manager account IDThe SA360 Manager Account ID that led to the key event. Identifies the SA360 manager account.
sa360ManagerAccountNameSA360 manager account nameThe SA360 Manager Account Name that led to the key event. The top level of the Search Ads 360 account hierarchy and is used for administration and reporting across the lower-level sub-manager and client accounts.
sa360MediumSA360 mediumThe SA360 Medium that led to the key event. The payment mode used in ad buying. For example, cpc.
sa360QuerySA360 queryThe SA360 Query that led to the key event. The search query typed by the user.
sa360SourceSA360 sourceThe SA360 Source that led to the key event. The search query happened on this site.
sa360SourceMediumSA360 source / mediumThe SA360 Source Medium that led to the key event. A combination of the source and medium.
screenResolutionScreen resolutionThe screen resolution of the user's monitor. For example, 1920x1080.
searchTermSearch 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.
sessionCampaignIdSession campaign IDThe marketing campaign ID for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
sessionCampaignNameSession campaignThe marketing campaign name for a session. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.
sessionCm360AccountIdSession CM360 account IDThe CM360 Account ID that led to the session. Identifies the CM360 account.
sessionCm360AccountNameSession CM360 account nameThe CM360 Account Name that led to the session. A CM360 account consists of advertisers, sites, campaigns, and user profiles.
sessionCm360AdvertiserIdSession CM360 advertiser IDThe CM360 Advertiser ID that led to the session. Identifies the CM360 advertiser.
sessionCm360AdvertiserNameSession CM360 advertiser nameThe CM360 Advertiser Name that led to the session. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.
sessionCm360CampaignIdSession CM360 campaign IDThe CM360 Campaign ID that led to the session. Identifies the CM360 campaign.
sessionCm360CampaignNameSession CM360 campaign nameThe CM360 Campaign Name that led to the session. A CM360 campaign can be configured to specify when your ads run, what landing pages are used, and other properties.
sessionCm360CreativeFormatSession CM360 creative formatThe CM360 Creative Format that led to the session. CM360 creative formats are also referred to as creative types.
sessionCm360CreativeIdSession CM360 creative IDThe CM360 Creative ID that led to the session. Identifies a CM360 creative.
sessionCm360CreativeNameSession CM360 creative nameThe CM360 Creative Name that led to the session. The name given to a CM360 creative.
sessionCm360CreativeTypeSession CM360 creative typeThe CM360 Creative Type that led to the session. A category of CM360 creatives like 'Display' or 'Tracking'. To learn more, see manage creatives
sessionCm360CreativeTypeIdSession CM360 creative type IDThe CM360 Creative Type ID that led to the session. Identifies a CM360 creative type.
sessionCm360CreativeVersionSession CM360 creative versionThe CM360 Creative Version that led to the session. The version number helps you keep track of multiple versions of your creative in your reports. If you upload a new asset to an existing creative, the version number is increased by one.
sessionCm360MediumSession CM360 mediumThe CM360 Medium that led to the session. The CM360 medium is also referred to as the placement cost structure.
sessionCm360PlacementCostStructureSession CM360 placement cost structureThe CM360 Placement Cost Structure that led to the session. Placement cost structures regulate how media cost will be calculated. For example 'CPM'.
sessionCm360PlacementIdSession CM360 placement IDThe CM360 Placement ID that led to the session. Identifies a CM360 placement. A placement is the part of a website where your ad appears.
sessionCm360PlacementNameSession CM360 placement nameThe CM360 Placement Name that led to the session. The given name for a CM360 placement. A placement is the part of a website where your ad appears.
sessionCm360RenderingIdSession CM360 rendering IDThe CM360 Rendering ID that led to the session. Identifies a CM360 creative.
sessionCm360SiteIdSession CM360 site IDThe CM360 Site ID that led to the session. Identifies a CM360 site.
sessionCm360SiteNameSession CM360 site nameThe CM360 Site Name that led to the session. The CM360 Site name from which the ad space was purchased.
sessionCm360SourceSession CM360 sourceThe CM360 Source that led to the session. The CM360 source is also referred to as the site name.
sessionCm360SourceMediumSession CM360 source / mediumThe CM360 Source Medium that led to the session. A combination of the source and medium.
sessionDefaultChannelGroupSession 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.
sessionDv360AdvertiserIdSession DV360 advertiser IDThe DV360 Advertiser ID that led to the session. Identifies the DV360 advertiser.
sessionDv360AdvertiserNameSession DV360 advertiser nameThe DV360 Advertiser Name that led to the session. DV360 advertisers represent real-life businesses that run advertising campaigns.
sessionDv360CampaignIdSession DV360 campaign IDThe DV360 Campaign ID that led to the session. Identifies the DV360 campaign.
sessionDv360CampaignNameSession DV360 campaign nameThe DV360 Campaign Name that led to the session. DV360 campaigns group together related insertion orders with a common business goal.
sessionDv360CreativeFormatSession DV360 creative formatThe DV360 Creative Format that led to the session. Also referred to as the creative type. For example, expandable, video, or native.
sessionDv360CreativeIdSession DV360 creative IDThe DV360 Creative ID that led to the session. Identifies the DV360 creative.
sessionDv360CreativeNameSession DV360 creative nameThe DV360 Creative Name that led to the session. The name given to a DV360 creative.
sessionDv360ExchangeIdSession DV360 exchange IDThe DV360 Exchange ID that led to the session. Identifies the DV360 exchange.
sessionDv360ExchangeNameSession DV360 exchange nameThe DV360 Exchange Name that led to the session. The DV360 ad exchange involved in the ad click. To learn more, see managing exchanges.
sessionDv360InsertionOrderIdSession DV360 insertion order IDThe DV360 Insertion Order ID that led to the session. Identifies the DV360 insertion order.
sessionDv360InsertionOrderNameSession DV360 insertion order nameThe DV360 Insertion Order Name that led to the session. A DV360 insertion order contains a set of line items that are related to the same advertising campaign.
sessionDv360LineItemIdSession DV360 line item IDThe DV360 Line Item ID that led to the session. Identifies the DV360 line item.
sessionDv360LineItemNameSession DV360 line item nameThe DV360 Line Item Name that led to the session. A DV360 line item bids on impressions and serves creatives to inventory sources.
sessionDv360MediumSession DV360 mediumThe DV360 Medium that led to the session. The billable outcome of the insertion order. For example, cpm.
sessionDv360PartnerIdSession DV360 partner IDThe DV360 Partner ID that led to the session. Identifies the DV360 partner.
sessionDv360PartnerNameSession DV360 partner nameThe DV360 Partner Name that led to the session. DV360 partners represent agencies, trading desks, or large individual advertisers.
sessionDv360SourceSession DV360 sourceThe DV360 Source that led to the session. The DV360 site name where your ad was displayed.
sessionDv360SourceMediumSession DV360 source / mediumThe DV360 Source Medium that led to the session. A combination of the source and medium.
sessionGoogleAdsAccountNameSession Google Ads account nameThe Account name from Google Ads that led to the session. Corresponds to customer.descriptive_name in the Google Ads API.
sessionGoogleAdsAdGroupIdSession Google Ads ad group IDThe Ad Group Id in Google Ads for a session.
sessionGoogleAdsAdGroupNameSession Google Ads ad group nameThe Ad Group Name in Google Ads for a session.
sessionGoogleAdsAdNetworkTypeSession 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).
sessionGoogleAdsCampaignIdSession Google Ads campaign IDThe Campaign ID for the Google Ads Campaign that led to this session.
sessionGoogleAdsCampaignNameSession Google Ads campaignThe Campaign name for the Google Ads Campaign that led to this session.
sessionGoogleAdsCampaignTypeSession 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, Demand Gen, App, Smart, Hotel, Local, and Performance Max. To learn more, see Choose the right campaign type.
sessionGoogleAdsCreativeIdSession Google Ads creative IDThe ID of the Google Ads creative that led to a session on your website or app. Creative IDs identify individual ads.
sessionGoogleAdsCustomerIdSession Google Ads customer IDThe Customer ID from Google Ads that led to the session. Customer IDs in Google Ads uniquely identify Google Ads accounts.
sessionGoogleAdsKeywordSession 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 Keywords: Definition.
sessionGoogleAdsQuerySession Google Ads queryThe search query that led to the session.
sessionManualAdContentSession manual ad contentThe ad content that led to a session. Populated by the utm_content parameter.
sessionManualCampaignIdSession manual campaign IDThe manual Campaign ID that led to the session. Identifies the manual campaign. Populated by utm_id URL parameter.
sessionManualCampaignNameSession manual campaign nameThe manual Campaign Name that led to the session. The name of the manual campaign. Populated by utm_campaign URL parameter. To learn more, see Collect campaign data with custom URLs.
sessionManualCreativeFormatSession manual creative formatThe manual Creative Format that led to the session. Identifies the creative format used in the ad. Populated by utm_creative_format URL parameter.
sessionManualMarketingTacticSession manual marketing tacticThe manual Marketing Tactic that led to the session. The targeting criteria applied to a campaign. For example, remarketing or prospecting. Populated by utm_marketing_tactic URL parameter.
sessionManualMediumSession manual mediumThe manual Medium that led to the session. The marketing medium used in the referral. For example, cpc. Populated by utm_medium URL parameter.
sessionManualSourceSession manual sourceThe manual Source that led to the session. The referrer. Populated by utm_source URL parameter.
sessionManualSourceMediumSession manual source / mediumThe manual Source Medium that led to the session. A combination of the source and medium.
sessionManualSourcePlatformSession manual source platformThe manual Source Platform that led to the session. The platform responsible for directing traffic to a given Analytics property. Populated by utm_source_platform URL parameter.
sessionManualTermSession manual termThe term that led to a session. Populated by the utm_term parameter.
sessionMediumSession mediumThe medium that initiated a session on your website or app.
sessionPrimaryChannelGroupSession primary channel groupThe primary channel group that led to the session. Primary channel groups are the channel groups used in standard reports in Google Analytics and serve as an active record of your property's data in alignment with channel grouping over time. To learn more, see Custom channel groups.
sessionSa360AdGroupIdSession SA360 ad group IDThe SA360 Ad Group ID that led to the session. Identifies the SA360 ad group.
sessionSa360AdGroupNameSession SA360 ad group nameThe SA360 Ad Group Name that led to the session. SA360 Ad groups contain ads and keywords that relate to each other.
sessionSa360CampaignIdSession SA360 campaign IDThe SA360 Campaign ID that led to the session. Identifies the SA360 campaign.
sessionSa360CampaignNameSession SA360 campaignThe SA360 Campaign Name that led to the session. A SA360 campaign lets you organize your ads and define a goal for your advertising.
sessionSa360CreativeFormatSession SA360 creative formatThe SA360 Creative Format that led to the session. The creative format is the specific layout or design of the advertisement used in a campaign.
sessionSa360EngineAccountIdSession SA360 engine account IDThe SA360 Engine Account ID that led to the session. Identifies the SA360 engine account.
sessionSa360EngineAccountNameSession SA360 engine account nameThe SA360 Engine Account Name that led to the session. A SA360 engine account contains campaigns, ad groups, and other items from an advertising account.
sessionSa360EngineAccountTypeSession SA360 engine account typeThe SA360 Engine Account Type that led to the session. The type of engine used by the search engine account. For example, google ads, bing, or baidu.
sessionSa360KeywordSession SA360 keyword textThe SA360 Keyword Text that led to the session. The keywords that matched the search query.
sessionSa360ManagerAccountIdSession SA360 manager account IDThe SA360 Manager Account ID that led to the session. Identifies the SA360 manager account.
sessionSa360ManagerAccountNameSession SA360 manager account nameThe SA360 Manager Account Name that led to the session. The top level of the Search Ads 360 account hierarchy and is used for administration and reporting across the lower-level sub-manager and client accounts.
sessionSa360MediumSession SA360 mediumThe SA360 Medium that led to the session. The payment mode used in ad buying. For example, cpc.
sessionSa360QuerySession SA360 queryThe SA360 Query that led to the session. The search query typed by the user.
sessionSa360SourceSession SA360 sourceThe SA360 Source that led to the session. The search query happened on this site.
sessionSa360SourceMediumSession SA360 source / mediumThe SA360 Source Medium that led to the session. A combination of the source and medium.
sessionSourceSession sourceThe source that initiated a session on your website or app.
sessionSourceMediumSession source / mediumThe combined values of the dimensions sessionSource and sessionMedium.
sessionSourcePlatformSession source platformThe source platform of the session's campaign. Don't 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.
shippingTierShipping tierThe shipping tier selected for delivery of the purchased item. For example, Ground, Air, or Next-day. Populated by the shipping_tier event parameter.
signedInWithUserIdSigned in with user IDThe string yes if the user signed in with the User-ID feature. To learn more about User-ID, see Measure activity across platforms with User-ID.
sourceSourceThe source attributed to the key event.
sourceMediumSource / mediumThe combined values of the dimensions source and medium.
sourcePlatformSource platformThe source platform of the key event's campaign. Don't 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.
streamIdStream IDThe numeric data stream identifier for your app or website.
streamNameStream nameThe data stream name for your app or website.
testDataFilterIdTest 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 Data filters.
testDataFilterNameTest 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 Data filters.
transactionIdTransaction IDThe ID of the ecommerce transaction.
unifiedPagePathScreenPage path and screen classThe page path (web) or screen class (app) on which the event was logged.
unifiedPageScreenPage path + query string and screen classThe page path and query string (web) or screen class (app) on which the event was logged.
unifiedScreenClassPage title and screen classThe page title (web) or screen class (app) on which the event was logged.
unifiedScreenNamePage title and screen nameThe page title (web) or screen name (app) on which the event was logged.
userAgeBracketAgeUser age brackets.
userGenderGenderUser gender.
videoProviderVideo 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.
videoTitleVideo titleThe title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter video_title.
videoUrlVideo URLThe URL of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter video_url.
virtualCurrencyNameVirtual currency nameThe name of a virtual currency with which the user is interacting. Such as spending or purchasing gems in a game. Populated by the virtual_currency_name event parameter.
visibleVisibleReturns true if the content is visible. Automatically populated for embedded videos if Enhanced Measurement is enabled. Populated by the event parameter visible.
weekWeekThe 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.
yearYearThe four-digit year of the event. For example, 2020 or 2024.
yearMonthYear monthThe combined values of year and month. Example values include 202212 or 202301.
yearWeekYear weekThe combined values of year and week. Example values include 202253 or 202301.

Custom Dimensions

The Data API can create reports on Event and User scoped Custom Dimensions. See Event-scoped custom dimensions and metrics reporting and Custom user properties to learn more about custom dimensions. Custom dimensions are specified in an API report request by the dimension's parameter name and scope. For example, include "customEvent:achievement_id" in a Data API request to create a report for the Event-scoped Custom Dimension with parameter name "achievement_id". This API request will fail if the property has not registered this Event-scoped Custom Dimension.

If an Event-scoped Custom Dimension was registered before October 2020, the dimension must be specified in an API request with its event name. For example, include "customEvent:achievement_id\[level_up\]" for the Event-scoped Custom Dimension with parameter name "achievement_id" and event name "level_up". In October 2020, Analytics replaced Custom-parameter reporting with Event-scoped custom dimensions and metrics reporting.

The following are the general syntax for Custom Dimensions. You can query the Metadata API method to list all Custom Dimensions for a Property; here is an example of using the Metadata API method.

Generic API NameDescription
customEvent:parameter_nameEvent-scoped Custom Dimension for parameter_name
customEvent:parameter_name[event_name]Event-scoped Custom Dimension for parameter_name if registered before October 2020
customUser:parameter_nameUser-scoped Custom Dimension for parameter_name
customItem:parameter_nameItem-scoped Custom Dimension for parameter_name

Custom Channel Groups

The Data API can create reports on Custom Channel Groups. To learn more about Custom channel groups, see Custom channel groups in Google Analytics. Custom Channel Groups are specified in an API report request by the dimension's scope and channel group ID. For example, include "sessionCustomChannelGroup:9432931" in a Data API request to create a report for the Session-scoped Custom Channel with an ID of 9432931. This API request will fail if the property does not have a custom channel with this ID.

The following are the general syntax for Custom Channel Groups. You can query the Metadata API method to list all Custom Channel Groups for a Property.

Generic API NameDescription
sessionCustomChannelGroup:custom_channel_idThe custom channel that led to this session.
firstUserCustomChannelGroup:custom_channel_idThe custom channel that first acquired this user.
customChannelGroup:custom_channel_idThe custom channel that led to the key event.

Metrics

The following metrics can be requested in reports for any property. Specify the "API Name" in a Metric resource's name field for a column of the metric in the report response.

API NameUI NameDescription
active1DayUsers1-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.
active28DayUsers28-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.
active7DayUsers7-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.
activeUsersActive usersThe number of distinct users who visited your site or app.
adUnitExposureAd unit exposureThe time that an ad unit was exposed to a user, in milliseconds.
addToCartsAdd to cartsThe number of times users added items to their shopping carts.
advertiserAdClicksAds 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.
advertiserAdCostAds 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.
advertiserAdCostPerClickAds cost per clickAds cost per click is ad cost divided by ad clicks and is often abbreviated CPC.
advertiserAdCostPerKeyEventCost per key eventCost per key event is ad cost divided by key events.
advertiserAdImpressionsAds impressionsThe total number of impressions. Includes impressions from linked integrations like linked Display & Video 360 advertisers. Also includes uploaded impressions from data import.
averagePurchaseRevenueAverage purchase revenueThe average purchase revenue in the transaction group of events.
averagePurchaseRevenuePerPayingUserARPPUAverage 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.
averagePurchaseRevenuePerUserAverage 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.
averageRevenuePerUserARPUAverage revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings.
averageSessionDurationAverage session durationThe average duration (in seconds) of users` sessions.
bounceRateBounce 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.
cartToViewRateCart-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.
checkoutsCheckoutsThe number of times users started the checkout process. This metric counts the occurrence of the begin_checkout event.
cohortActiveUsersCohort 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 in the row where cohortNthWeek = 0001, this metric is the number of users (in the cohort) who are active in week 1.
cohortTotalUsersCohort 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 cohort'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.
crashAffectedUsersCrash-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".
crashFreeUsersRateCrash-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.
dauPerMauDAU / 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.
dauPerWauDAU / 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.
ecommercePurchasesEcommerce purchasesThe number of times users completed a purchase. This metric counts purchase events; this metric does not count in_app_purchase and subscription events.
engagedSessionsEngaged sessionsThe number of sessions that lasted longer than 10 seconds, or had a key event, or had 2 or more screen views.
engagementRateEngagement 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.
eventCountEvent countThe count of events.
eventCountPerUserEvent count per userThe average number of events per user (Event count divided by Active users).
eventValueEvent valueThe sum of the event parameter named value.
eventsPerSessionEvents per sessionThe average number of events per session (Event count divided by Sessions).
firstTimePurchaserRateFirst-time purchaser rateThe 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.
firstTimePurchasersFirst time purchasersThe number of users that completed their first purchase event.
firstTimePurchasersPerNewUserFirst-time purchasers per new userThe average number of first time purchasers per new user.
grossItemRevenueGross item revenueThe total revenue from items only. Gross 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. Gross item revenue does not include refunds.
grossPurchaseRevenueGross purchase revenueThe sum of revenue from purchases made in your app or site. Gross 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.
itemDiscountAmountItem discount amountThe monetary value of item discounts in eCommerce events. This metric is populated in tagging by the discount item parameter.
itemListClickEventsItem-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.
itemListClickThroughRateItem 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.
itemListViewEventsItem-list view eventsThe number of times the item list was viewed. This metric counts the occurrence of the view_item_list event.
itemPromotionClickThroughRateItem 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.
itemRefundAmountItem refund amountItem refund amount is the total refunded transaction revenue from items only. Item refund amount is the product of price and quantity for the refund event.
itemRevenueItem revenueThe total revenue from purchases minus refunded transaction 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.
itemViewEventsItem view eventsThe number of times the item details were viewed. The metric counts the occurrence of the view_item event.
itemsAddedToCartItems 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.
itemsCheckedOutItems checked outThe number of units checked out for a single item. This metric counts the quantity of items in begin_checkout events.
itemsClickedInListItems clicked in listThe number of units clicked in list for a single item. This metric counts the quantity of items in select_item events.
itemsClickedInPromotionItems clicked in promotionThe number of units clicked in promotion for a single item. This metric counts the quantity of items in select_promotion events.
itemsPurchasedItems purchasedThe number of units for a single item included in purchase events. This metric counts the quantity of items in purchase events.
itemsViewedItems viewedThe number of units viewed for a single item. This metric counts the quantity of items in view_item events.
itemsViewedInListItems 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.
itemsViewedInPromotionItems viewed in promotionThe number of units viewed in promotion for a single item. This metric counts the quantity of items in view_promotion events.
keyEventsKey eventsThe count of key events. Marking an event as a key event affects reports from time of creation. It doesn't change historic data. You can mark any event as key in Google Analytics, and some events (such as first_open or purchase) are marked as key events by default.
newUsersNew usersThe number of users who interacted with your site or launched your app for the first time (event triggered: first_open or first_visit).
organicGoogleSearchAveragePositionOrganic 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.
organicGoogleSearchClickThroughRateOrganic 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.
organicGoogleSearchClicksOrganic Google Search clicksThe number of organic Google Search clicks reported from Search Console. This metric requires an active Search Console link.
organicGoogleSearchImpressionsOrganic Google Search impressionsThe number of organic Google Search impressions reported from Search Console. This metric requires an active Search Console link.
promotionClicksPromotion clicksThe number of times an item promotion was clicked. This metric counts the occurrence of the select_promotion event.
promotionViewsPromotion viewsThe number of times an item promotion was viewed. This metric counts the occurrence of the view_promotion event.
publisherAdClicksPublisher ad clicksThe number of ad_click events.
publisherAdImpressionsPublisher ad impressionsThe number of ad_impression events.
purchaseRevenuePurchase revenueThe sum of revenue from purchases minus refunded transaction revenue 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.
purchaseToViewRatePurchase-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).
purchaserRatePurchaser rateThe 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.
refundAmountRefund amountThe total refunded transaction revenues. Refund amount sums refunded revenue for the refund and app_store_refund events.
returnOnAdSpendReturn on ad spendReturn On Ad Spend (ROAS) is total revenue divided by advertiser ad cost.
screenPageViewsViewsThe 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).
screenPageViewsPerSessionViews 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.
screenPageViewsPerUserViews 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.
scrolledUsersScrolled usersThe number of unique users who scrolled down at least 90% of the page.
sessionKeyEventRateSession key event rateThe percentage of sessions in which any key event was triggered.
sessionsSessionsThe number of sessions that began on your site or app (event triggered: session_start).
sessionsPerUserSessions per userThe average number of sessions per user (Sessions divided by Active Users).
shippingAmountShipping amountShipping amount associated with a transaction. Populated by the shipping event parameter.
taxAmountTax amountTax amount associated with a transaction. Populated by the tax event parameter.
totalAdRevenueTotal ad revenueThe total advertising revenue from both Admob and third-party sources.
totalPurchasersTotal purchasersThe number of users that logged purchase events for the time period selected.
totalRevenueTotal revenueThe sum of revenue from purchases, subscriptions, and advertising (Purchase revenue plus Subscription revenue plus Ad revenue) minus refunded transaction revenue.
totalUsersTotal 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.
transactionsTransactionsThe 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.
transactionsPerPurchaserTransactions per purchaserThe average number of transactions per purchaser.
userEngagementDurationUser engagementThe total amount of time (in seconds) your website or app was in the foreground of users` devices.
userKeyEventRateUser key event rateThe percentage of users who triggered any key event.
wauPerMauWAU / 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.

Custom Metrics

The Data API can create reports on Event scoped Custom Metrics. See Event-scoped custom dimensions and metrics reporting to learn more about custom metrics. Custom metrics are specified in an API report request by the metric's parameter name and scope. For example, include "customEvent:levels_unlocked" in a Data API request to create a report for the Event-scoped Custom Metric with parameter name "levels_unlocked". This API request will fail if the property has not registered this Event-scoped Custom Metric.

If an Event-scoped Custom Metric was registered before October 2020, the metric must be specified in an API request with its event name. For example, include "customEvent:levels_unlocked\[tutorial_start\]" for the Event-scoped Custom Metric with parameter name "levels_unlocked" and event name "tutorial_start". In October 2020, Analytics replaced Custom-parameter reporting with Event-scoped custom dimensions and metrics reporting.

The following are the general syntax for Custom Metrics. You can query the Metadata API method to list all Custom Metrics for a Property; here is an example of using the Metadata API method.

Generic API NameDescription
customEvent:parameter_nameEvent-scoped Custom Metric for parameter_name
customEvent:parameter_name[event_name]Event-scoped Custom Metric for parameter_name if registered before October 2020

Custom Metric Variants

Each custom metric that a property registers creates three API metric variants: a sum, an average, and a count. Most requests will use the sum of the custom metric. The average of the custom metric is useful for a summary statistic. The count of a custom metric is interesting if the number of occurrences of a parameter is useful to you.

You can query the Metadata API method to list all variants of Custom Metrics for a Property; here is an example of using the Metadata API method for a custom average.

Generic API NameDescription
customEvent:parameter_nameThe sum of an Event-scoped Custom Metric for parameter_name
averageCustomEvent:parameter_nameThe average value of an Event-scoped Custom Metric for parameter_name
countCustomEvent:parameter_nameThe number of occurrences of an Event-scoped Custom Metric for parameter_name

Key Event Rate Metrics For Each Key Event

Each key event that you register on a property creates Key Event Rate metrics that you can request in reports. There are two rate metrics for each key event: session-based key event rate and user-based key event rate.

You can query the Metadata API method to list all key event rate metrics for a Property. If you try to request the key event rate for an event that is not registered as a key event, the request will fail. Here is an example of using the Metadata API method for a key event rate metric for one key event.

Generic API NameDescription
sessionKeyEventRate:event_nameThe percentage of sessions in which a specific key event event was triggered.
userKeyEventRate:event_nameThe percentage of users who triggered a specific key event event.