Google Analytics Data (GA4): Most-used fields#
The table below gives information about most-used fields that you can import from Google Analytics Data (GA4). Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
account.createTime |
account.createTime |
The creation timestamp of the Google Analytics account. |
dimension |
account.displayName |
account.displayName |
The user-friendly display name of the Google Analytics account. |
dimension |
account.name |
account.name |
The resource name of the Google Analytics account. |
dimension |
account.regionCode |
account.regionCode |
The region code (e.g., ‘US’, ‘EMEA’) associated with the Google Analytics account. |
dimension |
account.updateTime |
account.updateTime |
The last update timestamp of the Google Analytics account. |
dimension |
achievementId |
achievementId |
The achievement ID in a game for an event, populated by the event parameter ‘achievement_id’. |
dimension |
active1DayUsers |
active1DayUsers |
The count of distinct active users in the last 1 day. |
metric |
active28DayUsers |
active28DayUsers |
The count of distinct active users in the last 28 days. |
metric |
active7DayUsers |
active7DayUsers |
The count of distinct active users in the last 7 days. |
metric |
activeUsers |
activeUsers |
The number of distinct users who had an engaged session or recorded a first_open, first_visit, or app_start event. |
metric |
adFormat |
adFormat |
Describes the way ads looked and where they were located (e.g., Interstitial, Banner, Rewarded). |
dimension |
adSourceName |
adSourceName |
The source network that served the ad (e.g., AdMob Network, Liftoff). |
dimension |
adUnitName |
adUnitName |
The name you chose to describe this Ad unit. |
dimension |
addToCarts |
addToCarts |
The number of times items were added to a shopping cart. |
metric |
advertiserAdClicks |
advertiserAdClicks |
The number of clicks on an advertiser’s ads. |
metric |
advertiserAdCost |
advertiserAdCost |
The cost of an advertiser’s ads. |
metric |
advertiserAdCostPerClick |
advertiserAdCostPerClick |
The average cost per click for paid advertising from an advertiser’s perspective. |
metric |
advertiserAdImpressions |
advertiserAdImpressions |
The number of times an advertiser’s ad was displayed. |
metric |
audienceId |
audienceId |
The identifier for a user audience. |
metric |
audienceName |
audienceName |
The given name of an Audience. Users are reported in the audiences to which they belonged during the report’s date range. |
dimension |
averagePurchaseRevenue |
averagePurchaseRevenue |
The average revenue from purchases. |
metric |
averageSessionDuration |
averageSessionDuration |
The average duration of user sessions in seconds. |
metric |
bounceRate |
bounceRate |
The percentage of sessions that were single-page sessions (i.e., sessions in which the user left your site on the landing page without triggering any other requests to the Analytics server). |
metric |
brandingInterest |
brandingInterest |
Interests demonstrated by users who are higher in the shopping funnel (e.g., Shoppers, Travel Buffs). |
dimension |
browser |
browser |
The browser used to view your website. |
dimension |
campaignId |
campaignId |
The identifier of the marketing campaign. Present only for key events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. |
dimension |
campaignName |
campaignName |
The name of the marketing campaign. Present only for key events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns. |
dimension |
checkouts |
checkouts |
The number of times users completed the checkout process. |
metric |
city |
city |
The city from which the user activity originated. |
dimension |
cm360CampaignName |
cm360CampaignName |
The name of the CM360 campaign. |
dimension |
contentGroup |
contentGroup |
The content group of the page or screen. |
dimension |
contentId |
contentId |
The identifier of the content that was viewed. |
dimension |
contentType |
contentType |
The type of content on the page or screen. Example: ‘article’, ‘blog’. |
dimension |
conversions:add_payment_info |
conversions:add_payment_info |
The number of times the ‘add_payment_info’ event was a conversion. |
metric |
conversions:add_shipping_info |
conversions:add_shipping_info |
The number of times the ‘add_shipping_info’ event was a conversion. |
metric |
conversions:add_to_cart |
conversions:add_to_cart |
The number of times the ‘add_to_cart’ event was a conversion. |
metric |
conversions:add_to_wishlist |
conversions:add_to_wishlist |
The number of times the ‘add_to_wishlist’ event was a conversion. |
metric |
conversions:begin_checkout |
conversions:begin_checkout |
The number of times the ‘begin_checkout’ event was a conversion. |
metric |
conversions:purchase |
conversions:purchase |
The number of times the purchase event was recorded as a key event. |
metric |
conversions:view_item |
conversions:view_item |
The number of times the ‘view_item’ event was a conversion. |
metric |
country |
country |
The country from which the user activity originated. |
dimension |
countryId |
countryId |
The geographic ID of the country from which the user activity originated. |
dimension |
currencyCode |
currencyCode |
The currency code for transactions. |
dimension |
customChannelGroup:{NUM} |
customChannelGroup:{NUM} |
A custom channel grouping defined for your property. The {NUM} indicates the index of the custom channel group. |
dimension |
date |
date |
The date of the event in YYYYMMDD format. |
dimension |
dateHour |
dateHour |
The date and hour of the event in YYYYMMDDHH format. |
metric |
dateHourMinute |
dateHourMinute |
The date, hour, and minute of the event in YYYYMMDDHHMM format. |
metric |
day |
day |
The day of the month when the event occurred (1-31). |
metric |
dayOfWeek |
dayOfWeek |
The day of the week, where 0 is Sunday and 6 is Saturday. |
metric |
dayOfWeekName |
dayOfWeekName |
The name of the day of the week. Example: ‘Monday’. |
dimension |
defaultChannelGroup |
defaultChannelGroup |
The default channel grouping (e.g., Organic Search, Direct, Referral). |
dimension |
deviceCategory |
deviceCategory |
The category of device (e.g., desktop, tablet, mobile) from which the user activity originated. |
dimension |
deviceModel |
deviceModel |
The model name of the device (e.g., iPhone, Pixel). |
dimension |
ecommercePurchases |
ecommercePurchases |
The number of unique e-commerce purchases. |
metric |
engagedSessions |
engagedSessions |
The number of engaged sessions. An engaged session is a session that lasts longer than 10 seconds, has a conversion event, or has 2 or more screen or page views. |
metric |
engagementRate |
engagementRate |
The percentage of engaged sessions. |
metric |
eventCount |
eventCount |
The total count of events. |
metric |
eventCountPerUser |
eventCountPerUser |
The average number of events per user. |
metric |
eventName |
eventName |
The name of the event (e.g., click, page_view, purchase). |
dimension |
eventsPerSession |
eventsPerSession |
The average number of events per session. |
metric |
firstTimePurchasers |
firstTimePurchasers |
The number of unique users who made their first purchase. |
metric |
firstUserCampaignName |
firstUserCampaignName |
The name of the first campaign that acquired the user. |
dimension |
firstUserCustomChannelGroup:{NUM} |
firstUserCustomChannelGroup:{NUM} |
A custom channel grouping for a user’s first visit. The {NUM} indicates the index of the custom channel group. |
dimension |
firstUserDefaultChannelGroup |
firstUserDefaultChannelGroup |
The default channel grouping that first acquired the user (e.g., Organic Search, Direct). |
dimension |
firstUserGoogleAdsAdGroupName |
firstUserGoogleAdsAdGroupName |
The name of the Google Ads ad group that first acquired the user. |
dimension |
firstUserMedium |
firstUserMedium |
The medium that first attributed to the user. |
dimension |
firstUserPrimaryChannelGroup |
firstUserPrimaryChannelGroup |
The primary channel group that first attributed to the user. |
dimension |
firstUserSource |
firstUserSource |
The source that first attributed to the user. |
dimension |
firstUserSourceMedium |
firstUserSourceMedium |
The combined source and medium that first acquired the user (e.g., google / organic, direct / (none)). |
dimension |
fullPageUrl |
fullPageUrl |
The full URL of the page where the event occurred. |
dimension |
googleAdsAccountName |
googleAdsAccountName |
The Google Ads account name associated with the campaign. |
dimension |
googleAdsAdGroupId |
googleAdsAdGroupId |
The ID of the Google Ads ad group. |
dimension |
googleAdsAdGroupName |
googleAdsAdGroupName |
The name of the Google Ads ad group. |
dimension |
googleAdsCampaignName |
googleAdsCampaignName |
The name of the Google Ads campaign. |
dimension |
googleAdsCustomerId |
googleAdsCustomerId |
The ID of the Google Ads customer account. |
dimension |
googleAdsKeyword |
googleAdsKeyword |
The Google Ads keyword that matched to trigger an ad impression. |
dimension |
googleAdsQuery |
googleAdsQuery |
The search query entered by the user in Google Search that led to an impression of a Google Ads ad. |
dimension |
grossItemRevenue |
grossItemRevenue |
The total gross revenue from individual items. |
metric |
grossPurchaseRevenue |
grossPurchaseRevenue |
The total gross revenue from purchases. |
metric |
hostName |
hostName |
The hostname of the page where the event occurred. |
dimension |
hour |
hour |
The hour of the day when the event occurred (0-23). |
metric |
isKeyEvent |
isKeyEvent |
Indicates whether an event is marked as a key event (formerly conversion event). |
dimension |
isoWeek |
isoWeek |
The ISO week of the date. Example: ‘01’. |
metric |
isoYear |
isoYear |
The ISO year of the date. Example: ‘2023’. |
metric |
isoYearIsoWeek |
isoYearIsoWeek |
The year and ISO week of the date. Example: ‘202301’. |
metric |
itemAffiliation |
itemAffiliation |
The affiliation associated with the item. |
dimension |
itemCategory |
itemCategory |
The category of the item. |
dimension |
itemCategory2 |
itemCategory2 |
The second category of the item. |
dimension |
itemCategory3 |
itemCategory3 |
The third category of the item. |
dimension |
itemCategory4 |
itemCategory4 |
The fourth category of the item. |
dimension |
itemCategory5 |
itemCategory5 |
The fifth category of the item. |
dimension |
itemId |
itemId |
The identifier of the item. |
dimension |
itemName |
itemName |
The name of the item. |
dimension |
itemRevenue |
itemRevenue |
The total revenue from items. |
metric |
itemViewEvents |
itemViewEvents |
The number of times an item was viewed. |
metric |
itemsAddedToCart |
itemsAddedToCart |
The number of items added to a shopping cart. |
metric |
itemsCheckedOut |
itemsCheckedOut |
metric |
|
itemsPurchased |
itemsPurchased |
The number of items purchased. |
metric |
itemsViewed |
itemsViewed |
The number of items viewed. |
metric |
itemsViewedInList |
itemsViewedInList |
The number of items viewed in an item list. |
metric |
keyEvents |
keyEvents |
The count of key events. |
metric |
keyEvents:file_download |
keyEvents:file_download |
The count of ‘file_download’ key events. |
metric |
keyEvents:form_start |
keyEvents:form_start |
The count of ‘form_start’ key events. |
metric |
keyEvents:form_submission |
keyEvents:form_submission |
The total count of the ‘form_submission’ key event, indicating how many times users completed a form submission. |
metric |
keyEvents:form_submit |
keyEvents:form_submit |
The count of ‘form_submit’ events that are registered as key events. |
metric |
keyEvents:login |
keyEvents:login |
The count of ‘login’ key events. |
metric |
keyEvents:purchase |
keyEvents:purchase |
The total count of purchase key events. |
metric |
landingPage |
landingPage |
The page path of the first page viewed in a session. |
dimension |
landingPagePlusQueryString |
landingPagePlusQueryString |
The page path and query string of the first page viewed in a session. |
dimension |
language |
language |
The language setting of the user’s browser or device, such as ‘en-us’ for US English. |
dimension |
linkText |
linkText |
The text of a link that was clicked. |
dimension |
linkUrl |
linkUrl |
The URL of an outbound link that was clicked. |
dimension |
medium |
medium |
The medium through which the user arrived (e.g., organic, cpc, referral). |
dimension |
mobileDeviceModel |
mobileDeviceModel |
The model of the mobile device. Example: ‘iPhone10,3’. |
dimension |
month |
month |
The month of the year when the event occurred (1-12). |
dimension |
newUsers |
newUsers |
The number of first-time users. |
metric |
newVsReturning |
newVsReturning |
Indicates whether a user is new or returning. |
dimension |
nthHour |
nthHour |
The hour (0-23) within the specified date range, starting from 0 for the first hour. |
metric |
operatingSystem |
operatingSystem |
The operating system of the user’s device. |
dimension |
operatingSystemVersion |
operatingSystemVersion |
The operating system version of the user’s device. Example: ‘10’. |
dimension |
pageLocation |
pageLocation |
The full URL of the page where the event occurred. |
dimension |
pagePath |
pagePath |
The page path and query string (e.g., /path?q=query) of the page that was viewed. |
dimension |
pagePathPlusQueryString |
pagePathPlusQueryString |
The path and query string portion of a webpage URL. |
dimension |
pageReferrer |
pageReferrer |
The referrer of the page where the event occurred. |
dimension |
pageTitle |
pageTitle |
The title of the page where the event occurred. |
dimension |
percentScrolled |
percentScrolled |
A custom event parameter indicating the percentage of a page that a user has scrolled. Useful for understanding content engagement. |
dimension |
platform |
platform |
The platform on which the event occurred (e.g., web, iOS, Android). |
dimension |
platformDeviceCategory |
platformDeviceCategory |
The platform and device category combined (e.g., web / desktop, android / mobile). |
dimension |
property.createTime |
property.createTime |
The creation timestamp of the Google Analytics property. |
dimension |
property.currencyCode |
property.currencyCode |
The currency code (e.g., ‘USD’, ‘EUR’) configured for the Google Analytics 4 property. |
dimension |
property.displayName |
property.displayName |
The user-friendly display name of the Google Analytics 4 property. |
dimension |
property.industryCategory |
property.industryCategory |
The industry category that best describes the business or organization associated with the Google Analytics 4 property. |
dimension |
property.name |
property.name |
The resource name of the Google Analytics 4 property. |
dimension |
property.parent |
property.parent |
The resource name of the parent account that this property belongs to. |
dimension |
property.timeZone |
property.timeZone |
The time zone setting for the Google Analytics property. |
dimension |
property.updateTime |
property.updateTime |
The last update timestamp of the Google Analytics property. |
dimension |
propertyId |
propertyId |
The numeric identifier for a Google Analytics 4 property. |
metric |
publisherAdClicks |
publisherAdClicks |
The total publisher ad clicks on your app or site. |
metric |
publisherAdImpressions |
publisherAdImpressions |
The total publisher ad impressions on your app or site. |
metric |
purchaseRevenue |
purchaseRevenue |
The total revenue from purchases. |
metric |
purchaserRate |
purchaserRate |
The percentage of active users who made a purchase. |
metric |
region |
region |
The geographic region from which user activity originated, such as a state or province. This data is derived from the user’s IP address. |
dimension |
returnOnAdSpend |
returnOnAdSpend |
The total revenue divided by the total cost of advertising. |
metric |
sa360AdGroupName |
sa360AdGroupName |
The name of the SA360 ad group. |
dimension |
sa360CampaignName |
sa360CampaignName |
The name of the SA360 campaign. |
dimension |
screenPageViews |
screenPageViews |
The total number of app screen views and web page views. |
metric |
screenPageViewsPerSession |
screenPageViewsPerSession |
The average number of screen and page views per session. |
metric |
screenPageViewsPerUser |
screenPageViewsPerUser |
The average number of screen and page views per user. |
metric |
scrolledUsers |
scrolledUsers |
The number of unique users who scrolled at least 90% of a page. |
metric |
searchTerm |
searchTerm |
The search term entered by the user on the site or app. |
dimension |
sessionCampaignId |
sessionCampaignId |
The ID of the campaign associated with a session. |
dimension |
sessionCampaignName |
sessionCampaignName |
The name of the campaign associated with a session. |
dimension |
sessionCm360AccountName |
sessionCm360AccountName |
The name of the CM360 account associated with a session. |
dimension |
sessionCm360CampaignId |
sessionCm360CampaignId |
The ID of the CM360 campaign associated with a session. |
dimension |
sessionCm360CampaignName |
sessionCm360CampaignName |
The name of the CM360 campaign associated with a session. |
dimension |
sessionCm360CreativeName |
sessionCm360CreativeName |
The CM360 creative name that attributed to the session. |
dimension |
sessionCm360Medium |
sessionCm360Medium |
The CM360 medium associated with a session. |
dimension |
sessionCm360PlacementId |
sessionCm360PlacementId |
The ID of the CM360 placement associated with a session. |
dimension |
sessionCm360PlacementName |
sessionCm360PlacementName |
The name of the CM360 placement associated with a session. |
dimension |
sessionCm360SiteId |
sessionCm360SiteId |
The ID of the CM360 site (placement) associated with a session. |
dimension |
sessionCm360SiteName |
sessionCm360SiteName |
The name of the CM360 site (placement) associated with a session. |
dimension |
sessionCm360Source |
sessionCm360Source |
The CM360 source associated with a session. |
dimension |
sessionCm360SourceMedium |
sessionCm360SourceMedium |
The CM360 source / medium that attributed to the session. Example: ‘google / cpc’. |
dimension |
sessionConversionRate:add_payment_info |
sessionConversionRate:add_payment_info |
The session conversion rate for the ‘add_payment_info’ event. |
metric |
sessionConversionRate:add_shipping_info |
sessionConversionRate:add_shipping_info |
The session conversion rate for the ‘add_shipping_info’ event. |
metric |
sessionConversionRate:add_to_cart |
sessionConversionRate:add_to_cart |
The session conversion rate for the ‘add_to_cart’ event. |
metric |
sessionConversionRate:add_to_wishlist |
sessionConversionRate:add_to_wishlist |
The session conversion rate for the ‘add_to_wishlist’ event. |
metric |
sessionConversionRate:begin_checkout |
sessionConversionRate:begin_checkout |
The session conversion rate for the ‘begin_checkout’ event. |
metric |
sessionConversionRate:purchase |
sessionConversionRate:purchase |
The session conversion rate for the ‘purchase’ event. |
metric |
sessionConversionRate:view_item |
sessionConversionRate:view_item |
The session conversion rate for the ‘view_item’ event. |
metric |
sessionCustomChannelGroup:{NUM} |
sessionCustomChannelGroup:{NUM} |
A session-scoped custom channel grouping defined for your property. The {NUM} indicates the index of the custom channel group. |
dimension |
sessionDefaultChannelGroup |
sessionDefaultChannelGroup |
The default channel grouping for a session (e.g., Organic Search, Direct, Referral). |
dimension |
sessionDv360LineItemName |
sessionDv360LineItemName |
The DV360 line item name that attributed to the session. |
dimension |
sessionGoogleAdsAccountName |
sessionGoogleAdsAccountName |
The name of the Google Ads account associated with a session. |
dimension |
sessionGoogleAdsAdGroupId |
sessionGoogleAdsAdGroupId |
The ID of the Google Ads ad group associated with a session. |
metric |
sessionGoogleAdsAdGroupName |
sessionGoogleAdsAdGroupName |
The name of the Google Ads ad group associated with a session. |
dimension |
sessionGoogleAdsAdNetworkType |
sessionGoogleAdsAdNetworkType |
The type of ad network that served the Google Ads advertisement, such as Google Search, Google Display Network, or YouTube. |
dimension |
sessionGoogleAdsCampaignId |
sessionGoogleAdsCampaignId |
The ID of the Google Ads campaign associated with a session. |
dimension |
sessionGoogleAdsCampaignName |
sessionGoogleAdsCampaignName |
The name of the Google Ads campaign associated with a session. |
dimension |
sessionGoogleAdsCreativeId |
sessionGoogleAdsCreativeId |
The ID of the Google Ads creative associated with a session. |
metric |
sessionGoogleAdsCustomerId |
sessionGoogleAdsCustomerId |
The Google Ads customer ID that attributed to the session. |
dimension |
sessionGoogleAdsKeyword |
sessionGoogleAdsKeyword |
The Google Ads keyword that matched to trigger an ad impression for a session. |
dimension |
sessionKeyEventRate |
sessionKeyEventRate |
The rate of key events per session. |
metric |
sessionManualMedium |
sessionManualMedium |
The manually specified or overridden medium that acquired the user for a session. Examples include ‘cpc’, ‘referral’, or ‘email’. |
dimension |
sessionManualSource |
sessionManualSource |
The manually tagged source that attributed to the session. |
dimension |
sessionMedium |
sessionMedium |
The session-scoped medium (e.g., organic, cpc, referral). |
dimension |
sessionPrimaryChannelGroup |
sessionPrimaryChannelGroup |
The primary channel grouping for the session. |
dimension |
sessionSource |
sessionSource |
The session-scoped source (e.g., google, direct, (not set)). |
dimension |
sessionSourceMedium |
sessionSourceMedium |
The combined session-scoped source and medium (e.g., google / organic, direct / (none)). |
dimension |
sessionSourcePlatform |
sessionSourcePlatform |
The source platform for the session (e.g., Google Ads, SA360, DV360). |
dimension |
sessions |
sessions |
The number of sessions. |
metric |
sessionsPerUser |
sessionsPerUser |
The average number of sessions per user. |
metric |
shippingAmount |
shippingAmount |
The shipping amount for the transaction. |
metric |
source |
source |
The source through which the user arrived (e.g., google, direct, (not set)). |
dimension |
sourceMedium |
sourceMedium |
The combined source and medium (e.g., google / organic, direct / (none)). |
dimension |
sourcePlatform |
sourcePlatform |
The source platform for user acquisition (e.g., Google Ads, SA360, DV360). |
dimension |
source_medium |
source_medium |
The combined values of the traffic source and medium, such as ‘google / organic’. |
dimension |
state_iso_code |
state_iso_code |
The ISO 3166-2 alpha-2 standard code for the state or region where the user activity originated, derived from their IP address. |
dimension |
streamId |
streamId |
The unique identifier for the data stream. |
metric |
streamName |
streamName |
The user-friendly name of the data stream. |
dimension |
taxAmount |
taxAmount |
The total amount of tax collected for e-commerce transactions. |
metric |
totalAdRevenue |
totalAdRevenue |
The total revenue generated from ads. |
metric |
totalPurchasers |
totalPurchasers |
The number of unique purchasers. |
metric |
totalRevenue |
totalRevenue |
The total revenue from purchases, subscriptions, and ads. |
metric |
totalUsers |
totalUsers |
The total number of unique users. |
metric |
transactionId |
transactionId |
The unique identifier for an e-commerce transaction. |
dimension |
transactions |
transactions |
The total number of unique transaction IDs. |
metric |
transactionsPerPurchaser |
transactionsPerPurchaser |
The number of purchases per unique purchaser. |
metric |
unifiedPagePathScreen |
unifiedPagePathScreen |
The page path and screen class for combined web and app data. |
dimension |
unifiedScreenClass |
unifiedScreenClass |
The screen class of the application on which the event was logged. |
dimension |
userAgeBracket |
userAgeBracket |
The age bracket of the user (e.g., 18-24, 25-34). |
dimension |
userConversionRate:add_payment_info |
userConversionRate:add_payment_info |
The user conversion rate for the ‘add_payment_info’ event. |
metric |
userConversionRate:add_shipping_info |
userConversionRate:add_shipping_info |
The user conversion rate for the ‘add_shipping_info’ event. |
metric |
userConversionRate:add_to_cart |
userConversionRate:add_to_cart |
The user conversion rate for the ‘add_to_cart’ event. |
metric |
userConversionRate:begin_checkout |
userConversionRate:begin_checkout |
The user conversion rate for the ‘begin_checkout’ event. |
metric |
userConversionRate:purchase |
userConversionRate:purchase |
The user conversion rate for the ‘purchase’ event. |
metric |
userConversionRate:view_item |
userConversionRate:view_item |
The user conversion rate for the ‘view_item’ event. |
metric |
userEngagementDuration |
userEngagementDuration |
The total duration (in seconds) that users spent with the website or app in the foreground. |
metric |
userGender |
userGender |
The gender of the user. |
dimension |
userKeyEventRate |
userKeyEventRate |
The rate of key events per user. |
metric |
videoTitle |
videoTitle |
The title of the video. |
dimension |
videoUrl |
videoUrl |
A custom event parameter capturing the URL of a video played by a user. Used to analyze video content performance. |
dimension |
week |
week |
The week of the date. Example: ‘01’. |
metric |
year |
year |
The year when the event occurred. |
metric |
yearMonth |
yearMonth |
The year and month of the event in YYYYMM format. |
metric |