Skip to content

GA4 data schema

Mufaddal Taiyab-Ali edited this page Apr 15, 2021 · 5 revisions
Field name Data type Description
App New App Dimensions of GA4 schema
app_info RECORD A record of information on the app.
app_info.id STRING The package name or bundle ID of the app.
app_info.firebase_app_id STRING The Firebase App ID associated with the app
app_info.install_source STRING The store that installed the app.
app_info.version STRING The app's versionName (Android) or short bundle version.
Device The device dimensions of App+Web separated from Web browser dimensions
device RECORD A record of device information.
device.category STRING The device category (mobile, tablet, desktop).
device.mobile_brand_name STRING The device brand name.
device.mobile_model_name STRING The device model name.
device.mobile_marketing_name STRING The device marketing name.
device.mobile_os_hardware_model STRING The device model information retrieved directly from the operating system.
device.operating_system STRING The operating system of the device.
device.operating_system_version STRING The OS version.
device.vendor_id STRING IDFV (present only if IDFA is not collected).
device.advertising_id STRING Advertising ID/IDFA.
device.language STRING The OS language.
device.time_zone_offset_seconds INTEGER The offset from GMT in seconds.
device.is_limited_ad_tracking BOOLEAN The device's Limit Ad Tracking setting.
On iOS14+, returns false if the IDFA is non-zero.
Stream and platform
stream_id STRING The numeric ID of the stream.
platform STRING The platform on which the app was built.
User
user_first_touch_timestamp INTEGER The time (in microseconds) at which the user first opened the app or visited the site.
user_id STRING The user ID set via the setUserId API.
user_pseudo_id STRING The pseudonymous id (e.g., app instance ID) for the user.
user_properties RECORD A repeated record of user properties set with the setUserProperty API.
user_properties.key STRING The name of the user property.
user_properties.value RECORD A record for the user property value.
user_properties.value.string_value STRING The string value of the user property.
user_properties.value.int_value INTEGER The integer value of the user property.
user_properties.value.double_value FLOAT The double value of the user property.
user_properties.value.float_value FLOAT This field is currently unused.
user_properties.value.set_timestamp_micros INTEGER The time (in microseconds) at which the user property was last set.
user_ltv RECORD A record of Lifetime Value information about the user. This field is not populated in intraday tables.
user_ltv.revenue FLOAT The Lifetime Value (revenue) of the user. This field is not populated in intraday tables.
user_ltv.currency STRING The Lifetime Value (currency) of the user. This field is not populated in intraday tables.
Campaign Note: traffic_source attribution is based on cross-channel last click. traffic_source values do not change if the user interacts with subsequent campaigns after installation.
traffic_source RECORD Name of the traffic source that first acquired the user. This field is not populated in intraday tables.
traffic_source.name STRING Name of the marketing campaign that first acquired the user. This field is not populated in intraday tables.
traffic_source.medium STRING Name of the medium (paid search, organic search, email, etc.) that first acquired the user. This field is not populated in intraday tables.
traffic_source.source STRING Name of the network that first acquired the user. This field is not populated in intraday tables.
Geo
geo RECORD A record of the user's geographic information.
geo.continent STRING The continent from which events were reported, based on IP address.
geo.sub_continent STRING The subcontinent from which events were reported, based on IP address.
geo.country STRING The country from which events were reported, based on IP address.
geo.region STRING The region from which events were reported, based on IP address.
geo.metro STRING The metro from which events were reported, based on IP address.
geo.city STRING The city from which events were reported, based on IP address.
Event The main structural change from GA360
The page, sessions, events and other custom dimensions are formatted in Events/Parameters key-value pairs
event_date STRING The date on which the event was logged (YYYYMMDD format in the registered timezone of your app).
event_timestamp INTEGER The time (in microseconds, UTC) at which the event was logged on the client.
event_previous_timestamp INTEGER The time (in microseconds, UTC) at which the event was previously logged on the client.
event_name STRING The name of the event.
event_params RECORD A repeated record of the parameters associated with this event.
event_params.key STRING The event parameter's key.
event_params.value RECORD A record of the event parameter's value.
event_params.value.string_value STRING The string value of the event parameter.
event_params.value.int_value INTEGER The integer value of the event parameter.
event_params.value.double_value FLOAT The double value of the event parameter.
event_params.value.float_value FLOAT The float value of the event parameter. This field is currently unused.
event_value_in_usd FLOAT The currency-converted value (in USD) of the event's "value" parameter.
event_bundle_sequence_id INTEGER The sequential ID of the bundle in which these events were uploaded.
event_server_timestamp_offset INTEGER Timestamp offset between collection time and upload time in micros.
Ecommerce
ecommerce RECORD A record of information about ecommerce.
ecommerce.total_item_quantity INTEGER Total number of items in this event, which is the sum of items.quantity.
ecommerce.purchase_revenue_in_usd FLOAT Purchase revenue of this event, represented in USD with standard unit. Populated for purchase event only.
ecommerce.purchase_revenue FLOAT Purchase revenue of this event, represented in local currency with standard unit. Populated for purchase event only.
ecommerce.refund_value_in_usd ecommerce.refund_value_in_usd The amount of refund in this event, represented in USD with standard unit. Populated for refund event only.
ecommerce.refund_value FLOAT The amount of refund in this event, represented in local currency with standard unit. Populated for refund event only.
ecommerce.shipping_value_in_usd FLOAT The shipping cost in this event, represented in USD with standard unit.
ecommerce.shipping_value FLOAT The shipping cost in this event, represented in local currency.
ecommerce.tax_value_in_usd FLOAT The tax value in this event, represented in USD with standard unit.
ecommerce.tax_value FLOAT The tax value in this event, represented in local currency with standard unit.
ecommerce.transaction_id STRING The transaction ID of the ecommerce transaction.
ecommerce.unique_items INTEGER The number of unique items in this event, based on item_id, item_name, and item_brand.
Items
items RECORD A repeated record of items included in this event.
items.item_id STRING The ID of the item.
items.item_name STRING The name of the item.
items.item_brand STRING The brand of the item.
items.item_variant STRING The variant of the item.
items.item_category STRING The category of the item.
items.item_category2 STRING The sub category of the item.
items.item_category3 STRING The sub category of the item.
items.item_category4 STRING The sub category of the item.
items.item_category5 STRING The sub category of the item.
items.price_in_usd FLOAT The price of the item, in USD with standard unit.
items.price FLOAT The price of the item in local currency.
items.quantity INTEGER The quantity of the item.
items.item_revenue_in_usd FLOAT The revenue of this item, calculated as price_in_usd * quantity. It is populated for purchase events only, in USD with standard unit.
items.item_revenue FLOAT The revenue of this item, calculated as price * quantity. It is populated for purchase events only, in local currency with standard unit.
items.item_refund_in_usd FLOAT The refund value of this item, calculated as price_in_usd * quantity. It is populated for refund events only, in USD with standard unit.
items.item_refund FLOAT The refund value of this item, calculated as price * quantity. It is populated for refund events only, in local currency with standard unit.
items.coupon STRING Coupon code applied to this item.
items.affiliation STRING A product affiliation to designate a supplying company or brick and mortar store location.
items.location_id STRING The location associated with the item.
items.item_list_id STRING The ID of the list in which the item was presented to the user.
items.item_list_name STRING The name of the list in which the item was presented to the user.
Items.item_list_index STRING The position of the item in a list.
items.promotion_id STRING The ID of a product promotion.
items.promotion_name STRING The name of a product promotion.
items.creative_name STRING The name of a creative used in a promotional spot.
items.creative_slot STRING The name of a creative slot.
Web The web browser dimensions
web_info RECORD A record of information for web data.
web_info.hostname STRING The hostname associated with the logged event.
web_info.browser STRING The browser in which the user viewed content.
web_info.browser_version STRING The version of the browser in which the user viewed content.

GA360 schema with GA4 counterpart (where relevant)

Field Name Data Type Description GA4 counterpart
clientId STRING Unhashed version of the Client ID for a given user associated with any given visit/session.
fullVisitorId STRING The unique visitor ID (also known as client ID). user_id
visitorId NULL This field is deprecated. Use "fullVisitorId" instead.
userId STRING Overridden User ID sent to Analytics. user_pseudo_id
visitNumber INTEGER The session number for this user. If this is the first session, then this is set to 1.
visitId INTEGER An identifier for this session. This is part of the value usually stored as the _utmb cookie. This is only unique to the user. For a completely unique ID, you should use a combination of fullVisitorId and visitId.
visitStartTime INTEGER The timestamp (expressed as POSIX time). event_timestamp
date STRING The date of the session in YYYYMMDD format. event_date
totals RECORD This section contains aggregate values across the session.
totals.bounces INTEGER Total bounces (for convenience). For a bounced session, the value is 1, otherwise it is null.
totals.hits INTEGER Total number of hits within the session.
totals.newVisits INTEGER Total number of new users in session (for convenience). If this is the first visit, this value is 1, otherwise it is null.
totals.pageviews INTEGER Total number of pageviews within the session.
totals.screenviews INTEGER Total number of screenviews within the session.
totals.sessionQualityDim INTEGER An estimate of how close a particular session was to transacting, ranging from 1 to 100, calculated for each session. A value closer to 1 indicates a low session quality, or far from transacting, while a value closer to 100 indicates a high session quality, or very close to transacting. A value of 0 indicates that Session Quality is not calculated for the selected time range.
totals.timeOnScreen INTEGER The total time on screen in seconds.
totals.timeOnSite INTEGER Total time of the session expressed in seconds.
totals.totalTransactionRevenue INTEGER Total transaction revenue, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
totals.transactionRevenue INTEGER This field is deprecated. Use "totals.totalTransactionRevenue" instead (see above).
totals.transactions INTEGER Total number of ecommerce transactions within the session.
totals.UniqueScreenViews INTEGER Total number of unique screenviews within the session.
totals.visits INTEGER The number of sessions (for convenience). This value is 1 for sessions with interaction events. The value is null if there are no interaction events in the session.
trafficSource RECORD This section contains information about the Traffic Source from which the session originated. traffic_source
trafficSource.adContent STRING The ad content of the traffic source. Can be set by the utm_content URL parameter.
trafficSource.adwordsClickInfo RECORD This section contains information about the Google Ads click info if there is any associated with this session. Analytics uses the last non-direct click model.
trafficSource. INTEGER The Google ad-group ID.
adwordsClickInfo.adGroupId
trafficSource. STRING Network Type. Takes one of the following values: {“Google Search", "Content", "Search partners", "Ad Exchange", "Yahoo Japan Search", "Yahoo Japan AFS", “unknown”}
adwordsClickInfo.adNetworkType
trafficSource. INTEGER The Google Ads campaign ID.
adwordsClickInfo.campaignId
trafficSource. INTEGER The Google ad ID.
adwordsClickInfo.creativeId
trafficSource. INTEGER The ID for the targeting criterion.
adwordsClickInfo.criteriaId
trafficSource. STRING Descriptive string for the targeting criterion.
adwordsClickInfo.criteriaParameters
trafficSource. INTEGER The Google Ads Customer ID.
adwordsClickInfo.customerId
trafficSource. STRING The Google Click ID.
adwordsClickInfo.gclId
trafficSource. BOOLEAN True if it is a Trueview video ad.
adwordsClickInfo.isVideoAd
trafficSource. INTEGER Page number in search results where the ad was shown.
adwordsClickInfo.page
trafficSource. STRING Position of the Ad. Takes one of the following values:{“RHS", "Top"}
adwordsClickInfo.slot
trafficSource. RECORD Google Ads targeting criteria for a click. There are multiple types of targeting criteria, but should have only one value for each criterion.
adwordsClickInfo.targetingCriteria
trafficSource. INTEGER Remarketing list ID (if any) in Google Ads, derived from matching_criteria in click record.
adwordsClickInfo.targetingCriteria.
boomUserlistId
trafficSource.campaign STRING The campaign value. Usually set by the utm_campaign URL parameter. traffic_source.name
trafficSource.campaignCode STRING Value of the utm_id campaign tracking parameter, used for manual campaign tracking.
trafficSource.isTrueDirect BOOLEAN True if the source of the session was Direct (meaning the user typed the name of your website URL into the browser or came to your site via a bookmark), This field will also be true if 2 successive but distinct sessions have exactly the same campaign details. Otherwise NULL.
trafficSource.keyword STRING The keyword of the traffic source, usually set when the trafficSource.medium is "organic" or "cpc". Can be set by the utm_term URL parameter.
trafficSource.medium STRING The medium of the traffic source. Could be "organic", "cpc", "referral", or the value of the utm_medium URL parameter. traffic_source.medium
trafficSource.referralPath STRING If trafficSource.medium is "referral", then this is set to the path of the referrer. (The host name of the referrer is in trafficSource.source.)
trafficSource.source STRING The source of the traffic source. Could be the name of the search engine, the referring hostname, or a value of the utm_source URL parameter. traffic_source.source
socialEngagementType STRING Engagement type, either "Socially Engaged" or "Not Socially Engaged".
channelGrouping STRING The Default Channel Group associated with an end user's session for this View.
device RECORD This section contains information about the user devices. device
device.browser STRING The browser used (e.g., "Chrome" or "Firefox"). web_info.browser
device.browserSize STRING The viewport size of users' browsers. This captures the initial dimensions of the viewport in pixels and is formatted as width x height, for example, 1920x960.
device.browserVersion STRING The version of the browser used. web_info.browser_version
device.deviceCategory STRING The type of device (Mobile, Tablet, Desktop). device.category
device.mobileDeviceInfo STRING The branding, model, and marketing name used to identify the mobile device. device.mobile_brand_name
device.mobileDeviceMarketingName STRING The marketing name used for the mobile device. device.mobile_marketing_name
device.mobileDeviceModel STRING The mobile device model. device.mobile_model_name
device.mobileInputSelector STRING Selector (e.g., touchscreen, joystick, clickwheel, stylus) used on the mobile device.
device.operatingSystem STRING The operating system of the device (e.g., "Macintosh" or "Windows"). device.operating_system
device.operatingSystemVersion STRING The version of the operating system. device.operating_system_version
device.isMobile BOOLEAN If the user is on a mobile device, this value is true, otherwise false.
This field is deprecated. Use device.deviceCategory instead.
device.mobileDeviceBranding STRING The brand or manufacturer of the device.
device.flashVersion STRING The version of the Adobe Flash plugin that is installed on the browser.
device.javaEnabled BOOLEAN Whether or not Java is enabled in the browser.
device.language STRING The language the device is set to use. Expressed as the IETF language code. device.language
device.screenColors STRING Number of colors supported by the display, expressed as the bit-depth (e.g., "8-bit", "24-bit", etc.).
device.screenResolution STRING The resolution of the device's screen, expressed in pixel width x height (e.g., "800x600").
customDimensions RECORD This section contains any user-level or session-level custom dimensions that are set for a session. This is a repeated field and has an entry for each dimension that is set.
customDimensions.index INTEGER The index of the custom dimension.
customDimensions.value STRING The value of the custom dimension.
geoNetwork RECORD This section contains information about the geography of the user. geo
geoNetwork.continent STRING The continent from which sessions originated, based on IP address. geo.continent
geoNetwork.subContinent STRING The sub-continent from which sessions originated, based on IP address of the visitor. geo.sub_continent
geoNetwork.country STRING The country from which sessions originated, based on IP address. geo.country
geoNetwork.region STRING The region from which sessions originate, derived from IP addresses. In the U.S., a region is a state, such as New York. geo.region
geoNetwork.metro STRING The Designated Market Area (DMA) from which sessions originate. geo.metro
geoNetwork.city STRING Users' city, derived from their IP addresses or Geographical IDs. geo.city
geoNetwork.cityId STRING Users' city ID, derived from their IP addresses or Geographical IDs. The city IDs are the same as the Criteria IDs found at https://developers.google.com/
analytics/devguides/collection/
protocol/v1/geoid.
geoNetwork.latitude STRING The approximate latitude of users' city, derived from their IP addresses or Geographical IDs. Locations north of the equator have positive latitudes and locations south of the equator have negative latitudes.
geoNetwork.longitude STRING The approximate longitude of users' city, derived from their IP addresses or Geographical IDs. Locations east of the prime meridian have positive longitudes and locations west of the prime meridian have negative longitudes.
geoNetwork.networkDomain STRING [No longer supported]
The domain name of user's ISP, derived from the domain name registered to the ISP's IP address.
geoNetwork.networkLocation STRING [No longer supported]
The names of the service providers used to reach the property. For example, if most users of the website come via the major cable internet service providers, its value will be these service providers' names.
hits RECORD This row and nested fields are populated for any and all types of hits.
hits.dataSource STRING The data source of a hit. By default, hits sent from analytics.js are reported as "web" and hits sent from the mobile SDKs are reported as "app".
hits.sourcePropertyInfo RECORD This section contains information about source property for rollup properties
hits.sourcePropertyInfo. STRING Source property display name of Roll-Up Properties. This is valid for only Roll-Up Properties.
sourcePropertyDisplayName
hits.sourcePropertyInfo. STRING Source property tracking ID of roll-up properties. This is valid for only roll-up properties.
sourcePropertyTrackingId
hits.eCommerceAction RECORD This section contains all of the ecommerce hits that occurred during the session. This is a repeated field and has an entry for each hit that was collected.
hits.eCommerceAction.action_type STRING The action type. Click through of product lists = 1, Product detail views = 2, Add product(s) to cart = 3, Remove product(s) from cart = 4, Check out = 5, Completed purchase = 6, Refund of purchase = 7, Checkout options = 8, Unknown = 0. ecommerce.total_item_quantity
ecommerce.purchase_revenue
Usually this action type applies to all the products in a hit, with the following exception: when hits.product.isImpression = TRUE, the corresponding product is a product impression that is seen while the product action is taking place (i.e., a "product in list view"). ecommerce.refund_value_in_usd
Example query to calculate number of products in list views: ecommerce.refund_value
AND ( BOOLEAN(hits.product.isImpression) IS NULL OR BOOLEAN(hits.product.isImpression) == FALSE )
hits.eCommerceAction.option STRING This field is populated when a checkout option is specified. For example, a shipping option such as option = 'Fedex'. ecommerce.shipping_value
hits.eCommerceAction.step INTEGER This field is populated when a checkout step is specified with the hit.
hits.exceptionInfo.exceptions INTEGER The number of exceptions sent to Google Analytics.
hits.exceptionInfo.fatalExceptions INTEGER The number of exceptions sent to Google Analytics where isFatal is set to true.
hits.experiment RECORD This row and the nested fields are populated for each hit that contains data for an experiment.
hits.experiment.experimentId STRING The ID of the experiment.
hits.experiment.experimentVariant STRING The variation or combination of variations present in a hit for an experiment.
hits.hitNumber INTEGER The sequenced hit number. For the first hit of each session, this is set to 1.
hits.hour INTEGER The hour in which the hit occurred (0 to 23).
hits.isSecure BOOLEAN This field is deprecated.
hits.isEntrance BOOLEAN If this hit was the first pageview or screenview hit of a session, this is set to true.
hits.isExit BOOLEAN If this hit was the last pageview or screenview hit of a session, this is set to true.
hits.isInteraction BOOLEAN If this hit was an interaction, this is set to true. If this was a non-interaction hit (i.e., an event with interaction set to false), this is false.
hits.latencyTracking RECORD This section contains information about events in the Navigation Timing API.
hits.latencyTracking.domainLookupTime INTEGER The total time (in milliseconds) all samples spent in DNS lookup for this page.
hits.latencyTracking.domContentLoadedTime INTEGER The time (in milliseconds), including the network time from users' locations to the site's server, the browser takes to parse the document and execute deferred and parser-inserted scripts (DOMContentLoaded).
hits.latencyTracking.domInteractiveTime INTEGER The time (in milliseconds), including the network time from users' locations to the site's server, the browser takes to parse the document (DOMInteractive).
hits.latencyTracking.domLatencyMetricsSample INTEGER Sample set (or count) of pageviews used to calculate the averages for site speed DOM metrics.
hits.latencyTracking.pageDownloadTime INTEGER The total time (in milliseconds) to download this page among all samples.
hits.latencyTracking.pageLoadSample INTEGER The sample set (or count) of pageviews used to calculate the average page load time.
hits.latencyTracking.pageLoadTime INTEGER Total time (in milliseconds), from pageview initiation (e.g., a click on a page link) to page load completion in the browser, the pages in the sample set take to load.
hits.latencyTracking.redirectionTime INTEGER The total time (in milliseconds) all samples spent in redirects before fetching this page. If there are no redirects, this is 0.
hits.latencyTracking.serverConnectionTime INTEGER Total time (in milliseconds) all samples spent in establishing a TCP connection to this page.
hits.latencyTracking.serverResponseTime INTEGER The total time (in milliseconds) the site's server takes to respond to users' requests among all samples; this includes the network time from users' locations to the server.
hits.latencyTracking.speedMetricsSample INTEGER The sample set (or count) of pageviews used to calculate the averages of site speed metrics.
hits.latencyTracking.userTimingCategory STRING For easier reporting purposes, this is used to categorize all user timing variables into logical groups.
hits.latencyTracking.userTimingLabel STRING The name of the resource's action being tracked.
hits.latencyTracking.userTimingSample INTEGER The number of hits sent for a particular userTimingCategory, userTimingLabel, or userTimingVariable.
hits.latencyTracking.userTimingValue INTEGER Total number of milliseconds for user timing.
hits.latencyTracking.userTimingVariable STRING Variable used to add flexibility to visualize user timings in the reports.
hits.minute INTEGER The minute in which the hit occurred (0 to 59).
hits.product.isImpression BOOLEAN TRUE if at least one user viewed this product (i.e., at least one impression) when it appeared in the product list.
hits.product.isClick BOOLEAN Whether users clicked this product when it appeared in the product list.
hits.product.customDimensions RECORD This section is populated for all hits containing product scope Custom Dimensions.
hits.product.customDimensions.index INTEGER The product scope Custom Dimensions index.
hits.product.customDimensions.value STRING The product scope Custom Dimensions value.
hits.product.customMetrics RECORD This section is populated for all hits containing product scope Custom Metrics.
hits.product.customMetrics.index INTEGER The product scope Custom Metrics index.
hits.product.customMetrics.value INTEGER The product scope Custom Metrics value.
hits.product.productListName STRING Name of the list in which the product is shown, or in which a click occurred. For example, "Home Page Promotion", "Also Viewed", "Recommended For You", "Search Results List", etc.
hits.product.productListPosition INTEGER Position of the product in the list in which it is shown.
hits.publisher. INTEGER The number of clicks on AdSense ads that served as Google Ad Manager backfill.
adsenseBackfillDfpClicks
hits.publisher. INTEGER The number of AdSense ad impressions that were served as Google Ad Manager backfill.
adsenseBackfillDfpImpressions
hits.publisher. INTEGER The number of ad requests where AdSense was trafficked as backfill and returned an ad creative to the page.
adsenseBackfillDfpMatchedQueries
hits.publisher. INTEGER The number of ad impressions filled by AdSense that viewability measurements were able to take into account (includes both in-view and not-in-view ads).
adsenseBackfillDfpMeasurableImpressions
hits.publisheradsenseBackfillDfpPagesViewed INTEGER The number of Google Analytics pageviews where Google Ad Manager recorded AdSense revenue.
hits.publisher.adsenseBackfillDfpQueries INTEGER The number of ad requests made to AdSense by Google Ad Manager.
hits.publisher. INTEGER The CPC revenue associated with the resultant AdSense ad clicks.
adsenseBackfillDfpRevenueCpc
hits.publisher. INTEGER The CPM revenue associated with the served AdSense ad impressions.
adsenseBackfillDfpRevenueCpm
hits.publisher. INTEGER The number of AdSense impressions that met Google Ad Manager’s viewability standard.
adsenseBackfillDfpViewableImpressions
hits.publisher.adxBackfillDfpClicks INTEGER The number of clicks on Google Ad Manager ads served as Google Ad Manager backfill.
hits.publisher. INTEGER The number of Google Ad Manager ad impressions that were served as Google Ad Manager backfill.
adxBackfillDfpImpressions
hits.publisher. INTEGER The number of ad requests where Google Ad Manager was trafficked as backfill and returned an ad creative to the page.
adxBackfillDfpMatchedQueries
hits.publisher. INTEGER The number of ad impressions filled by Google Ad Manager that viewability measurements are able to take into account (includes both in-view and not-in-view ads).
adxBackfillDfpMeasurableImpressions
hits.publisher. INTEGER The number of Google Analytics pageviews where Google Ad Manager recorded revenue.
adxBackfillDfpPagesViewed
hits.publisher. INTEGER The number of ad requests made to Google Ad Manager by Google Ad Manager.
adxBackfillDfpQueries
hits.publisher. INTEGER The CPC revenue associated with the resultant Google Ad Manager ad clicks.
adxBackfillDfpRevenueCpc
hits.publisher. INTEGER The CPM revenue associated with the served Google Ad Manager ad impressions.
adxBackfillDfpRevenueCpm
hits.publisher. INTEGER The number of Google Ad Manager impressions that met Google Ad Manager’s viewability standard.
adxBackfillDfpViewableImpressions
hits.publisher.dfpAdGroup STRING The Google Ad Manager Line Item ID of the ad that served.
hits.publisher.dfpAdUnits STRING The IDs of the Google Ad Manager Ad Units present in the ad request.
hits.publisher.dfpClicks INTEGER The number of times Google Ad Manager ads were clicked.
hits.publisher.dfpImpressions INTEGER A Google Ad Manager ad impression is reported whenever an individual ad is displayed. For example, when a page with two ad units is viewed once, we display two impressions.
hits.publisher.dfpMatchedQueries INTEGER The number of ad requests where a creative was returned to the page.
hits.publisher.dfpMeasurableImpressions INTEGER The number of ad impressions that viewability measurements are able to take into account (includes both in-view and not-in-view ads).
hits.publisher.dfpNetworkId STRING The Google Ad Manager network ID that the ad request was sent to.
hits.publisher.dfpPagesViewed INTEGER The number of Google Analytics pageviews where Google Ad Manager recorded revenue.
hits.publisher.dfpQueries INTEGER The number of ad requests made to Google Ad Manager.
hits.publisher.dfpRevenueCpc INTEGER The CPC revenue associated with the resultant ad clicks, based on the rate-field value for each clicked ad in Google Ad Manager.
hits.publisher.dfpRevenueCpm INTEGER The CPM revenue associated with the served ad impressions, based on the rate-field value for each served ad in Google Ad Manager.
hits.publisher.dfpViewableImpressions INTEGER The number of impressions that met Google Ad Manager’s viewability standard.
hits.time INTEGER The number of milliseconds after the visitStartTime when this hit was registered. The first hit has a hits.time of 0
hits.transaction.transactionCoupon STRING The coupon code associated with the transaction. items.coupon
hits.referrer STRING The referring page, if the session has a goal completion or transaction. If this page is from the same domain, this is blank. items.affiliation
hits.refund RECORD This row and nested fields are populated for each hit that contains Enhanced Ecommerce REFUND information.
hits.refund.localRefundAmount INTEGER Refund amount in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.refund.refundAmount INTEGER Refund amount, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000). items.item_refund_in_usd
hits.social RECORD This section is populated for each hit with type = "SOCIAL".
hits.social.hasSocialSourceReferral STRING A string, either Yes or No, that indicates whether sessions to the property are from a social source.
hits.social.socialInteractionAction STRING The social action passed with the social tracking code (Share, Tweet, etc.).
hits.social.socialInteractionNetwork STRING The the network passed with the social tracking code, e.g., Twitter.
hits.social.socialInteractionNetworkAction STRING For social interactions, this represents the social network being tracked.
hits.social.socialInteractions INTEGER The total number of social interactions.
hits.social.socialInteractionTarget STRING For social interactions, this is the URL (or resource) which receives the social network action.
hits.social.socialNetwork STRING The social network name. This is related to the referring social network for traffic sources; e.g., Blogger.
hits.social.uniqueSocialInteractions INTEGER The number of sessions during which the specified social action(s) occurred at least once. This is based on the the unique combination of socialInteractionNetwork, socialInteractionAction, and socialInteractionTarget.
hits.type STRING The type of hit. One of: "PAGE", "TRANSACTION", "ITEM", "EVENT", "SOCIAL", "APPVIEW", "EXCEPTION".
Timing hits are considered an event type in the Analytics backend. When you query time-related fields (e.g., hits.latencyTracking.pageLoadTime), choose hits.type as Event if you want to use hit.type in your queries.
hits.page RECORD This section is populated for each hit with type = "PAGE".
hits.page.pagePath STRING The URL path of the page.
hits.page.pagePathLevel1 STRING This dimension rolls up all the page paths in the 1st hierarchical level in pagePath.
hits.page.pagePathLevel2 STRING This dimension rolls up all the page paths in the 2nd hierarchical level in pagePath.
hits.page.pagePathLevel3 STRING This dimension rolls up all the page paths in the 3d hierarchical level in pagePath.
hits.page.pagePathLevel4 STRING This dimension rolls up all the page paths into hierarchical levels. Up to 4 pagePath levels may be specified. All additional levels in the pagePath hierarchy are also rolled up in this dimension.
hits.page.hostname STRING The hostname of the URL.
hits.page.pageTitle STRING The page title.
hits.page.searchKeyword STRING If this was a search results page, this is the keyword entered.
hits.product RECORD This row and nested fields will be populated for each hit that contains Enhanced Ecommerce PRODUCT data.
hits.product.localProductPrice INTEGER The price of the product in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.product.localProductRefundAmount INTEGER The amount processed as part of a refund for a product in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.product.localProductRevenue INTEGER The revenue of the product in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.product.productBrand STRING The brand associated with the product. items.item_brand
hits.product.productPrice INTEGER The price of the product, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000). items.price
hits.product.productQuantity INTEGER The quantity of the product purchased.
hits.product.productRefundAmount INTEGER The amount processed as part of a refund for a product, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000). items.item_refund
hits.product.productRevenue INTEGER The revenue of the product, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.product.productSKU STRING Product SKU.
hits.product.productVariant STRING Product Variant. items.item_variant
hits.product.v2ProductCategory STRING Product Category. items.creative_slot
hits.product.v2ProductName STRING Product Name. items.creative_name
hits.promotion RECORD This row and nested fields are populated for each hit that contains Enhanced Ecommerce PROMOTION information.
hits.promotion.promoCreative STRING The text or creative variation associated with the promotion.
hits.promotion.promoId STRING Promotion ID. items.promotion_id
hits.promotion.promoName STRING Promotion Name. items.promotion_name
hits.promotion.promoPosition STRING Promotion position on site.
hits.promotionActionInfo RECORD This row and nested fields are populated for each hit that contains Enhanced Ecommerce PROMOTION action information.
hits.promotionActionInfo.promoIsView BOOLEAN True if the Enhanced Ecommerce action is a promo view.
hits.promotionActionInfo.promoIsClick BOOLEAN True if the Enhanced Ecommerce action is a promo click.
hits.page.searchCategory STRING If this was a search-results page, this is the category selected.
hits.transaction RECORD This section is populated for each hit with type = "TRANSACTION".
hits.transaction.transactionId STRING The transaction ID of the ecommerce transaction. ecommerce.transaction_id
hits.transaction.transactionRevenue INTEGER Total transaction revenue, expressed as the value passed to Analytics multiplied by 10^6. (e.g., 2.40 would be given as 2400000).
hits.transaction.transactionTax INTEGER Total transaction tax, expressed as the value passed to Analytics multiplied by 10^6. (e.g., 2.40 would be given as 2400000). ecommerce.tax_value_in_usd
hits.transaction.transactionShipping INTEGER Total transaction shipping cost, expressed as the value passed to Analytics multiplied by 10^6. (e.g., 2.40 would be given as 2400000). ecommerce.shipping_value_in_usd
hits.transaction.affiliation STRING The affiliate information passed to the ecommerce tracking code.
hits.transaction.currencyCode STRING The local currency code for the transaction.
hits.transaction.localTransactionRevenue INTEGER Total transaction revenue in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.transaction.localTransactionTax INTEGER Total transaction tax in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000). ecommerce.tax_value
hits.transaction.localTransactionShipping INTEGER Total transaction shipping cost in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.item RECORD This section will be populated for each hit with type = "ITEM". item
hits.item.transactionId STRING The transaction ID of the ecommerce transaction. ecommerce.transaction_id
hits.item.productName STRING The name of the product. items.item_name
hits.item.productCategory STRING The category of the product. items.item_category
hits.item.productSku STRING The SKU or product ID. items.item_id
hits.item.itemQuantity INTEGER The quantity of the product sold. items.quantity
hits.item.itemRevenue INTEGER Total revenue from the item, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000). items.item_revenue
hits.item.currencyCode STRING The local currency code for the transaction.
hits.item.localItemRevenue INTEGER Total revenue from this item in local currency, expressed as the value passed to Analytics multiplied by 10^6 (e.g., 2.40 would be given as 2400000).
hits.contentGroup RECORD This section contains information about content grouping. Learn more
hits.contentGroup.contentGroupX STRING The content group on a property. A content group is a collection of content that provides a logical structure that can be determined by tracking-code or page-title/URL regex match, or predefined rules. (Index X can range from 1 to 5.)
hits.contentGroup.previousContentGroupX STRING Content group that was visited before another content group. (Index X can range from 1 to 5.)
hits.contentGroup.contentGroupUniqueViewsX STRING The number of unique content group views. Content group views in different sessions are counted as unique content group views. Both the pagePath and pageTitle are used to determine content group view uniqueness. (Index X can range from 1 to 5.)
hits.contentInfo RECORD This section will be populated for each hit with type = "APPVIEW".
hits.contentInfo.contentDescription STRING The description of the content being viewed as passed to the SDK.
hits.appInfo RECORD This section will be populated for each hit with type = "APPVIEW" or "EXCEPTION". app_info
hits.appInfo.appInstallerId STRING ID of the installer (e.g., Google Play Store) from which the app was downloaded. app_info.install_source
hits.appInfo.appName STRING The name of the application. app_info.firebase_app_id
hits.appInfo.appVersion STRING The version of the application. app_info.version
hits.appInfo.appId STRING The ID of the application. app_info.id
hits.appInfo.screenName STRING The name of the screen.
hits.appInfo.landingScreenName STRING The landing screen of the session.
hits.appInfo.exitScreenName STRING The exit screen of the session.
hits.appInfo.screenDepth STRING The number of screenviews per session reported as a string. Can be useful for historgrams.
hits.exceptionInfo RECORD This section is populated for each hit with type = "EXCEPTION".
hits.exceptionInfo.description STRING The exception description.
hits.exceptionInfo.isFatal BOOLEAN If the exception was fatal, this is set to true.
hits.eventInfo RECORD This section is populated for each hit with type = "EVENT".
hits.eventInfo.eventCategory STRING The event category.
hits.eventInfo.eventAction STRING The event action.
hits.eventInfo.eventLabel STRING The event label. event_name
hits.eventInfo.eventValue INTEGER The event value. event_params.value
hits.customVariables RECORD This section contains any hit-level custom variables. This is a repeated field and has an entry for each variable that is set. event_params.value.string_value
hits.customVariables.index INTEGER The index of the custom variable. event_params.value.int_value
hits.customVariables.customVarName STRING The custom variable name. event_params
hits.customVariables.customVarValue STRING The custom variable value.
hits.customDimensions RECORD This section contains any hit-level custom dimensions. This is a repeated field and has an entry for each dimension that is set.
hits.customDimensions.index INTEGER The index of the custom dimension.
hits.customDimensions.value STRING The value of the custom dimension.
hits.customMetrics RECORD This section contains any hit-level custom metrics. This is a repeated field and has an entry for each metric that is set.
hits.customMetrics.index INTEGER The index of the custom metric.
hits.customMetrics.value INTEGER The value of the custom metric.
Clone this wiki locally