-
Notifications
You must be signed in to change notification settings - Fork 2
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. |
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. |