Google Analytics Data (GA4): Most-used fields

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