CData Cloud offers access to Google Analytics across several standard services and protocols, in a cloud-hosted solution. Any application that can connect to a MySQL or SQL Server database can connect to Google Analytics through CData Cloud.
CData Cloud allows you to standardize and configure connections to Google Analytics as though it were any other OData endpoint, or standard SQL Server/MySQL database.
This page provides a guide to Establishing a Connection to Google Analytics in CData Cloud, as well as information on the available resources, and a reference to the available connection properties.
Establishing a Connection shows how to authenticate to Google Analytics and configure any necessary connection properties to create a database in CData Cloud
Accessing data from Google Analytics through the available standard services and CData Cloud administration is documented in further details in the CData Cloud Documentation.
Connect to Google Analytics by selecting the corresponding icon in the Database tab. Required properties are listed under Settings. The Advanced tab lists connection properties that are not typically required.
Provide the following connection properties before adding the authentication properties.
Provide the following connection properties before adding the authentication properties.
The Cloud supports using user accounts and GCP instance accounts for authentication.
The following sections discuss the available authentication schemes for Google Analytics:
AuthScheme must be set to OAuth in all user account flows.
Get an OAuth Access Token
Set the following connection properties to obtain the OAuthAccessToken:
Then call stored procedures to complete the OAuth exchange:
Once you have obtained the access and refresh tokens, you can connect to data and refresh the OAuth access token either automatically or manually.
Automatic Refresh of the OAuth Access Token
To have the driver automatically refresh the OAuth access token, set the following on the first data connection:
Manual Refresh of the OAuth Access Token
The only value needed to manually refresh the OAuth access token when connecting to data is the OAuth refresh token.
Use the RefreshOAuthAccessToken stored procedure to manually refresh the OAuthAccessToken after the ExpiresIn parameter value returned by GetOAuthAccessToken has elapsed, then set the following connection properties:
Then call RefreshOAuthAccessToken with OAuthRefreshToken set to the OAuth refresh token returned by GetOAuthAccessToken. After the new tokens have been retrieved, open a new connection by setting the OAuthAccessToken property to the value returned by RefreshOAuthAccessToken.
Finally, store the OAuth refresh token so that you can use it to manually refresh the OAuth access token after it has expired.
Option 1: Obtain and Exchange a Verifier Code
To obtain a verifier code, you must authenticate at the OAuth authorization URL.
Follow the steps below to authenticate from the machine with an internet browser and obtain the OAuthVerifier connection property.
On the headless machine, set the following connection properties to obtain the OAuth authentication values:
After the OAuth settings file is generated, you need to re-set the following properties to connect:
Option 2: Transfer OAuth Settings
Prior to connecting on a headless machine, you need to create and install a connection with the driver on a device that supports an internet browser. Set the connection properties as described in "Desktop Applications" above.
After completing the instructions in "Desktop Applications", the resulting authentication values are encrypted and written to the location specified by OAuthSettingsLocation. The default filename is OAuthSettings.txt.
Once you have successfully tested the connection, copy the OAuth settings file to your headless machine.
On the headless machine, set the following connection properties to connect to data:
When running on a GCP virtual machine, the Cloud can authenticate using a service account tied to the virtual machine. To use this mode, set AuthScheme to GCPInstanceAccount.
Google Analytics data is organized into various metrics (Sessions, Impressions, AdClicks, etc.), which can be queried over various dimensions (Country, Month, etc.). There are many valid combinations of metrics and dimensions. The Cloud surfaces some of the most commonly used combinations as tables for ease of use.
Additionally, the Cloud allows you to query all valid combinations, even those not included in the predefined tables, using two schemes: by using the Dimensions and Metrics columns and by defining custom schemas. Refer to Advanced Queries for more information. Below is a guide to getting started with the default tables.
The dimension and metrics are clearly defined for each table and can be seen in the Data Model: Simply select the metrics and the dimensions you are interested in.
For example, to find the number of sessions in each month, query the Session metric over the Month dimension. This would return 12 rows: one for each month.
SELECT Sessions, Month FROM TrafficTo separate out the months in each year, include both the month and the year dimensions in the query:
SELECT Sessions, Month, Year FROM Traffic
All Google Analytics reports cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT Sessions, Month, Year FROM Traffic WHERE StartDate = '90daysAgo' AND EndDate = 'Today'
The supported inputs for StartDate and EndDate in the Google Analytics API are 'today', 'yesterday', 'NdaysAgo' (where N is some number), and an exact date. Starting in the v4 API, up to two separate date ranges can be set in the filter.
Unlike most database tables, it is not very helpful to select all metrics and dimensions in a given table.
In some cases, it is not even possible to do this since Google Analytics allows a maximum of 7 dimensions and 10 metrics in a single query.
The Cloud thus interprets the SELECT * query to mean a default set of metrics and dimensions are requested.
This includes queries that explicitly select all columns. For schemas with less than 10 metrics, all metrics will be returned.
Refer to the individual view's documentation in Data Model to see which fields are the default for each schema.
Google Analytics has a very large number of metrics and dimensions that would clutter table definitions, so the table definitions included with the product only list the most commonly used combinations. We offer two alternatives to this design choice: You can use the Dimensions and Metrics columns to request fields that are not in the default table, or you can define your own table.
To request additional dimensions or metrics for any existing table, the recommended approach is to define custom schemas; however, you can also set the Dimensions and Metrics inputs in the WHERE clause. Both inputs take a comma-separated list so that you can specify multiple fields at once. The values will be returned in the corresponding Dimensions and Metrics column in the same order that you submitted them. For example, the following query will query the Traffic table for Sessions, the Goal 1 Conversion Rate, and Goal 1 Completions and group these metrics together by the User Age Bracket dimension:
SELECT Sessions, Dimensions, Metrics FROM Traffic WHERE Dimensions='UserAgeBracket' AND Metrics='Goal1ConversionRate,Goal1Completions'In the results from the query above, the value for UserAgeBracket will be returned in the Dimensions field for each row. The Metrics field will contain a comma-separated value containing the requested metrics for Goal 1.
You can use the following properties to gain greater control over Google Analytics API features and the strategies the Cloud uses to surface them:
By default, the Cloud attempts to negotiate SSL/TLS by checking the server's certificate against the system's trusted certificate store.
To specify another certificate, see the SSLServerCert property for the available formats to do so.
To connect through the Windows system proxy, you do not need to set any additional connection properties. To connect to other proxies, set ProxyAutoDetect to false.
In addition, to authenticate to an HTTP proxy, set ProxyAuthScheme, ProxyUser, and ProxyPassword, in addition to ProxyServer and ProxyPort.
Set the following properties:
The CData Cloud models Google Analytics entities in relational Tables, Views, and Stored Procedures. The provided tables will give you an overview of your account information and the profiles available for Google Analytics queries. Google Analytics allows for Dimensions and Metrics to be queried in a large number of arrangements. Some sample views are provided based on common Google Analytics reports. You can, however, also create your own custom views based on any combination of Dimensions and Metrics you need.
API limitations and requirements are documented in this section; you can use the SupportEnhancedSQL feature, set by default, to circumvent most of these limitations.
The CreateCustomSchema stored procedure can be used to easily generate new schema files with a custom combination of Dimensions and Metrics. This procedure takes the TableName and a comma-separated lists of Dimensions and Metrics and builds a schema file that can be read by the Cloud. Each Dimension or Metric in the list takes the name of the value from Google Analytics (without the 'ga:' prefix). For example:
Dimensions=UserType,SessionCount
Metrics=Users,PercentNewSessionsIf the Location connection property is set, the file will be output to that folder. Otherwise, the OutputFolder input can be used to specify an output folder. To begin querying these new files, simply set the Location connection property to the folder containing these new schema files.
See UniversalAnalytics Data Model for the available entities in the Universal Analytics API.
See GoogleAnalytics4 Data Model for the available entities in the Google Analytics 4 API.
The CData Cloud models the Google Analytics Universal Analytics API as relational tables, views, and stored procedures.. The provided tables will give you an overview of your account information and the profiles available for Google Analytics queries. Google Analytics allows for Dimensions and Metrics to be queried in a large number of arrangements. Some sample views are provided based on common Google Analytics reports. You can however also create your own custom views based on any combination of Dimensions and Metrics you need. API limitations and requirements are documented in this section; you can use the SupportEnhancedSQL feature, set by default, to circumvent most of these limitations. However, there is a strict limit in the API of 9 (for ApiVersion 4) or 7 (for ApiVersion 3) dimensions and 10 metrics per query, unless otherwise stated in the specfic table or view pages.
To use Universal Analytics Data Model, simply set Schema to UniversalAnalytics.
Views are tables that cannot be modified, such as Accounts, Goals, Profiles, Events, Traffic, and SiteContent. Typically, data that are read-only and cannot be updated are shown as views.
Stored Procedures are function-like interfaces to the data source. They can be used to search, update, and modify information in the data source.
Views are similar to tables in the way that data is represented; however, views are read-only.
Queries can be executed against a view as if it were a normal table.
Name | Description |
Accounts | Lists all Accounts to which the user has access. |
AdSense | Retrieves AdSense data. |
AdWords | Retrieves AdWords data. |
Ecommerce | Retrieves Ecommerce data. |
Events | Retrieves Event data. |
Global_Access_Object | Retrieves data for all the available dimensions and metrics. |
GoalCompletions | Retrieves Goal Completion data. |
Goals | A Goals resource describes a goal for one of a user's profiles. |
Profiles | Lists all Profiles to which the user has access. |
Segments | Lists all Segments to which the user has access. |
SiteContent | Retrieves internal Site Content data. |
SiteSearch | Retrieves internal Site Search data. |
SiteSpeed | Retrieves internal Site Speed data. |
Traffic | Retrieves all Traffic data. |
UserActivity | List information on a user's activity. |
WebProperties | Lists Web Properties to which the user has access. |
Lists all Accounts to which the user has access.
The Accounts table exposes every account the user has access to. Filters are not available in the WHERE clause for this table but LIMIT is supported.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Id [KEY] | String | Account Id. | |||
Kind | String | Resource type for Analytics account. | |||
SelfLink | String | Link for this account. | |||
Name | String | Account name. | |||
Permissions | String | All the permissions that the user has for this account. These include any implied permissions. | |||
Created | Datetime | Time the account was created. | |||
Updated | Datetime | Time the account was last modified. | |||
ChildLink | String | Child link for an account entry. Points to the list of Web properties for this account. |
Retrieves AdSense data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses Date instead of the default Campaign dimension:
SELECT Date, Sessions, Users, OrganicSearches, GoalValueAll, TransactionRevenue, AdsenseRevenue, AdsenseAdsClicks, AdsensePageImpressions FROM AdSenseFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return the Campaign name and revenue for Campaigns with revenue of more than 100:
SELECT Campaign, AdsenseRevenue FROM AdSense WHERE AdsenseRevenue > 100All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM AdSense WHERE StartDate = '90daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT Campaign, Sessions, Users, OrganicSearches, GoalValueAll, TransactionRevenue, AdsenseRevenue, AdsenseAdsClicks, AdsensePageImpressions FROM AdSense
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Campaign | String | True | True | When using manual campaign tracking, this value is the value of the utm_campaign campaign tracking parameter. When using AdWords autotagging, this value is the name(s) of the online ad campaign that you use for your property. Otherwise, this value is the following: not set. | |
Sessions | Integer | False | True | Counts the total number of sessions. | |
Users | Integer | False | True | Total number of users to your property for the requested time period. | |
OrganicSearches | Integer | False | True | The number of organic searches that happened within a session. This metric is search-engine agnostic. | |
GoalValueAll | Double | False | True | The total numeric value for all goals defined for your profile. | |
TransactionRevenue | Decimal | False | True | The total sale revenue provided in the transaction, excluding shipping and tax. | |
AdsenseRevenue | Decimal | False | True | The total revenue from AdSense ads. | |
AdsenseAdsClicks | Integer | False | True | The number of times AdSense ads on your site were clicked. | |
AdsensePageImpressions | Integer | False | True | The number of page views during which an AdSense ad was displayed. A page impression can have multiple ad units. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves AdWords data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses Keyword instead of the default Campaign dimension:
SELECT Keyword, Sessions, Impressions, AdClicks, AdCost, CTR, CPC, RPC, ROI, Margin FROM AdWordsFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will find the total number of AdClicks from the United States:
SELECT Country, AdClicks FROM AdWords WHERE Country = 'United States'All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM AdWords WHERE StartDate = '90daysAgo' AND EndDate = 'Today'Because there are more than 10 Metrics available for the AdWords table, a query that selects all columns only returns the default Metrics for this table (see columns marked as default Metrics below). If you need to select other Metrics, select them explicitly instead of using '*'. The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT Campaign, Sessions, Impressions, AdClicks, AdCost, CTR, CPC, RPC, ROI, Margin FROM AdWords
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Language | String | True | The language provided by the HTTP Request for the browser. Values are given as an ISO-639 code. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
Browser | String | True | The names of browsers used by users to your website. For example, Internet Explorer or Firefox. | ||
OperatingSystem | String | True | The operating system used by your users. For example, Windows, Linux , Macintosh, iPhone, iPod. | ||
DeviceCategory | String | True | The type of device: desktop, tablet, or mobile. | ||
Campaign | String | True | True | When using manual campaign tracking, this value is the value of the utm_campaign campaign tracking parameter. When using AdWords autotagging, this value is the name(s) of the online ad campaign that you use for your property. Otherwise, this value is: not set. | |
AdGroup | String | True | The name of your AdWords ad group. | ||
Keyword | String | True | When using manual campaign tracking, this value is the value of the utm_term campaign tracking parameter; i.e., the keywords used by users to reach your property when using AdWords autotagging or if a user used organic search to reach your property. Otherwise this value is: not set. | ||
Sessions | Integer | False | True | Counts the total number of sessions. | |
Impressions | Integer | False | True | Total number of campaign impressions. | |
AdClicks | Integer | False | True | The total number of times users have clicked on an ad to reach your property. | |
AdCost | Decimal | False | True | Derived cost for the advertising campaign. The currency for this value is based on the currency that you set in your AdWords account. | |
CTR | Double | False | True | Click-through rate for your ad. This is equal to the number of clicks divided by the number of impressions for your ad (e.g., how many times users clicked on one of your ads where that ad appeared). | |
CPC | Decimal | False | True | Cost to advertiser per click. | |
RPC | Decimal | False | True | RPC, or revenue-per-click, is the average revenue from e-commerce sales and/or goal value you received for each click on one of your search ads. | |
ROI | Decimal | False | True | Returns on Investment is overall transaction profit divided by derived advertising cost. | |
Margin | Decimal | False | True | The overall transaction profit margin. | |
PercentNewSessions | Double | False | The percentage of sessions by people who had never visited your property before. | ||
NewUsers | Integer | False | The number of users whose visit to your property was marked as a first-time session. | ||
BounceRate | Double | False | The percentage of single-page session. | ||
PageviewsPerSession | Double | False | The average number of pages viewed during a session on your property. | ||
AvgSessionDuration | Double | False | The average duration of user sessions represented in total seconds. | ||
GoalConversionRateAll | Double | False | The percentage of sessions that resulted in a conversion to at least one of your goals. | ||
Transactions | Integer | False | The total number of transactions. | ||
RevenuePerTransaction | Decimal | False | The average revenue for an e-commerce transaction. | ||
TransactionRevenue | Decimal | False | The total sale revenue provided in the transaction, excluding shipping and tax. | ||
TransactionRevenuePerSession | Decimal | False | Average transaction revenue for a session on your property. | ||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves Ecommerce data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses ProductSku instead of the default Date dimension:
SELECT ProductSku, UniquePurchases, ItemQuantity FROM EcommerceFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. The following query will find all product SKUs with more than 100 unique purchases:
SELECT ProductSku, UniquePurchases FROM Ecommerce WHERE UniquePurchases > 100All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM Ecommerce WHERE StartDate = '90daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT Sessions, Users, Transactions, TransactionRevenue, TransactionShipping, TransactionTax, RevenuePerTransaction, UniquePurchases, ItemQuantity, ItemRevenue FROM Ecommerce
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
ProductName | String | True | The product name for purchased items, as supplied by your e-commerce tracking application. | ||
ProductSku | String | True | The product SKUs for purchased items, as you have defined them in your e-commerce tracking application. | ||
ProductCategory | String | True | Any product variations (e.g., size or color) for purchased items, as supplied by your e-commerce application. | ||
TransactionId | String | True | The transaction Id for the shopping cart purchase. | ||
Sessions | Integer | False | True | Counts the total number of sessions. | |
Users | Integer | False | True | Total number of users to your property for the requested time period. | |
Transactions | Integer | False | True | The total number of transactions. | |
TransactionRevenue | Decimal | False | True | The total sale revenue provided in the transaction, excluding shipping and tax. | |
TransactionShipping | Decimal | False | True | The total cost of shipping. | |
TransactionTax | Decimal | False | True | The total amount of tax. | |
RevenuePerTransaction | Decimal | False | True | The average revenue for an e-commerce transaction. | |
UniquePurchases | Integer | False | True | The number of product sets purchased. | |
ItemQuantity | Integer | False | True | The total number of items purchased. | |
ItemRevenue | Decimal | False | True | The total revenue from purchased product items on your property. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves Event data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses EventLabel instead of the default EventCategory dimension:
SELECT EventLabel, TotalEvents, UniqueEvents, EventValue, SessionsWithEvent, AvgEventValue, EventsPerSessionWithEvent FROM EventsFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return all Events with less than or equal to 200 total events:
SELECT EventLabel, TotalEvents FROM Events WHERE TotalEvents <= 200All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM Events WHERE StartDate = '39daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT EventCategory, TotalEvents, UniqueEvents, EventValue, SessionsWithEvent, AvgEventValue, EventsPerSessionWithEvent FROM Events
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. A two digit integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A two-digit number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A two-digit number from 01 to 31. | ||
Hour | Integer | True | A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
EventCategory | String | True | True | The category of the event. | |
EventAction | String | True | The action of the event. | ||
EventLabel | String | True | The label of the event. | ||
TotalEvents | Integer | False | True | The total number of events for the profile, across all categories. | |
UniqueEvents | Integer | False | True | The total number of unique events for the profile, across all categories. | |
EventValue | Long | False | True | The total value of events for the profile. | |
SessionsWithEvent | Integer | False | True | The total number of sessions with events. | |
AvgEventValue | Double | False | True | The average value of an event. | |
EventsPerSessionWithEvent | Double | False | True | The average number of events per session with event. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves data for all the available dimensions and metrics.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
UserType | String | True | True | A boolean, either New Visitor or Returning Visitor, indicating if the users are new or returning. | |
SessionCount | String | True | The session index for a user. Each session from a unique user will get its own incremental index starting from 1 for the first session. Subsequent sessions do not change previous session indices. For example, if a user has 4 sessions to the website, sessionCount for that user will have 4 distinct values of '1' through '4'. | ||
DaysSinceLastSession | String | True | The number of days elapsed since users last visited the property, used to calculate user loyalty. | ||
UserDefinedValue | String | True | The value provided when defining custom user segments for the property. | ||
UserBucket | String | True | Randomly assigned users tag to allow A/B testing and splitting of remarketing lists. Ranges from 1-100. | ||
SessionDurationBucket | String | True | The length (returned as a string) of a session measured in seconds and reported in second increments. | ||
ReferralPath | String | True | The path of the referring URL (e.g., document.referrer). If someone places on their webpage a link to the property, this is the path of the page containing the referring link. | ||
FullReferrer | String | True | The full referring URL including the hostname and path. | ||
Campaign | String | True | For manual campaign tracking, it is the value of the utm_campaign campaign tracking parameter. For AdWords autotagging, it is the name(s) of the online ad campaign(s) you use for the property. If you use neither, its value is (not set). | ||
Source | String | True | The source of referrals. For manual campaign tracking, it is the value of the utm_source campaign tracking parameter. For AdWords autotagging, it is google. If you use neither, it is the domain of the source (e.g., document.referrer) referring the users. It may also contain a port address. If users arrived without a referrer, its value is (direct). | ||
Medium | String | True | The type of referrals. For manual campaign tracking, it is the value of the utm_medium campaign tracking parameter. For AdWords autotagging, it is cpc. If users came from a search engine detected by Google Analytics, it is organic. If the referrer is not a search engine, it is referral. If users came directly to the property and document.referrer is empty, its value is (none). | ||
SourceMedium | String | True | Combined values of ga:source and ga:medium. | ||
Keyword | String | True | For manual campaign tracking, it is the value of the utm_term campaign tracking parameter. For AdWords traffic, it contains the best matching targeting criteria. For the display network, where multiple targeting criteria could have caused the ad to show up, it returns the best matching targeting criteria as selected by Ads. This could be display_keyword, site placement, boomuserlist, user_interest, age, or gender. Otherwise its value is (not set). | ||
AdContent | String | True | For manual campaign tracking, it is the value of the utm_content campaign tracking parameter. For AdWords autotagging, it is the first line of the text for the online Ad campaign. If you use mad libs for the AdWords content, it contains the keywords you provided for the mad libs keyword match. If you use none of the above, its value is (not set). | ||
SocialNetwork | String | True | The social network name. This is related to the referring social network for traffic sources; e.g., Google+, Blogger. | ||
HasSocialSourceReferral | String | True | A boolean, either Yes or No, indicates whether sessions to the property are from a social source. | ||
AdGroup | String | True | The name of the AdWords ad group. | ||
AdSlot | String | True | The location (Top, RHS, or not set) of the advertisement on the hosting page. | ||
AdDistributionNetwork | String | True | The network (Content, Search, Search partners, etc.) used to deliver the ads. | ||
AdMatchType | String | True | The match type (Phrase, Exact, Broad, etc.) applied for users' search term. | ||
AdKeywordMatchType | String | True | The match type (Phrase, Exact, or Broad) applied to the keywords. For details, see https://support.google.com/adwords/answer/2472708. | ||
AdMatchedQuery | String | True | The search query that triggered impressions. | ||
AdPlacementDomain | String | True | The domain where the ads on the content network were placed. | ||
AdPlacementUrl | String | True | The URL where the ads were placed on the content network. | ||
AdFormat | String | True | The AdWords ad format (Text, Image, Flash, Video, etc.). | ||
AdTargetingType | String | True | This (keyword, placement, or vertical targeting) indicates how the AdWords ads were targeted. | ||
AdTargetingOption | String | True | It is Automatic placements or Managed placements, indicating how the ads were managed on the content network. | ||
AdDisplayUrl | String | True | The URL the AdWords ads displayed. | ||
AdDestinationUrl | String | True | The URL to which the AdWords ads referred traffic. | ||
AdwordsCustomerID | String | True | Customer's AdWords ID, corresponding to AdWords API AccountInfo.customerId. | ||
AdwordsCampaignID | String | True | AdWords API Campaign.id. | ||
AdwordsAdGroupID | String | True | AdWords API AdGroup.id. | ||
AdwordsCreativeID | String | True | AdWords API Ad.id. | ||
AdwordsCriteriaID | String | True | AdWords API Criterion.id. The geographical targeting Criteria IDs are listed at https://developers.google.com/analytics/devguides/collection/protocol/v1/geoid. | ||
AdQueryWordCount | String | True | The number of words in the search query. | ||
GoalCompletionLocation | String | True | The page path or screen name that matched any destination type goal completion. | ||
GoalPreviousStep1 | String | True | The page path or screen name that matched any destination type goal, one step prior to the goal completion location. | ||
GoalPreviousStep2 | String | True | The page path or screen name that matched any destination type goal, two steps prior to the goal completion location. | ||
GoalPreviousStep3 | String | True | The page path or screen name that matched any destination type goal, three steps prior to the goal completion location. | ||
Browser | String | True | The name of users' browsers, for example, Internet Explorer or Firefox. | ||
BrowserVersion | String | True | The version of users' browsers, for example, 2.0.0.14. | ||
OperatingSystem | String | True | Users' operating system, for example, Windows, Linux, Macintosh, or iOS. | ||
OperatingSystemVersion | String | True | The version of users' operating system, i.e., XP for Windows, PPC for Macintosh. | ||
MobileDeviceBranding | String | True | Mobile manufacturer or branded name. | ||
MobileDeviceModel | String | True | Mobile device model. | ||
MobileInputSelector | String | True | Selector (e.g., touchscreen, joystick, clickwheel, stylus) used on the mobile device. | ||
MobileDeviceInfo | String | True | The branding, model, and marketing name used to identify the mobile device. | ||
MobileDeviceMarketingName | String | True | The marketing name used for the mobile device. | ||
DeviceCategory | String | True | The type of device: desktop, tablet, or mobile. | ||
Continent | String | True | Users' continent, derived from users' IP addresses or Geographical IDs. | ||
SubContinent | String | True | Users' sub-continent, derived from their IP addresses or Geographical IDs. For example, Polynesia or Northern Europe. | ||
Country | String | True | Users' country, derived from their IP addresses or Geographical IDs. | ||
Region | String | True | Users' region, derived from their IP addresses or Geographical IDs. In U.S., a region is a state, New York, for example. | ||
Metro | String | True | The Designated Market Area (DMA) from where traffic arrived. | ||
City | String | True | Users' city, derived from their IP addresses or Geographical IDs. | ||
Latitude | String | True | 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. | ||
Longitude | String | True | 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. | ||
NetworkDomain | String | True | The domain name of users' ISP, derived from the domain name registered to the ISP's IP address. | ||
NetworkLocation | String | True | 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. | ||
FlashVersion | String | True | The version of Flash, including minor versions, supported by users' browsers. | ||
JavaEnabled | String | True | A boolean, either Yes or No, indicating whether Java is enabled in users' browsers. | ||
Language | String | True | The language, in ISO-639 code format (e.g., en-gb for British English), provided by the HTTP Request for the browser. | ||
ScreenColors | String | True | The color depth of users' monitors, retrieved from the DOM of users' browsers. For example, 4-bit, 8-bit, 24-bit, or undefined-bit. | ||
SourcePropertyDisplayName | String | True | Source property display name of roll-up properties. This is valid for only roll-up properties. | ||
SourcePropertyTrackingId | String | True | Source property tracking Id of roll-up properties. This is valid for only roll-up properties. | ||
ScreenResolution | String | True | Resolution of users' screens, for example, 1024x738. | ||
Hostname | String | True | The hostname from which the tracking request was made. | ||
PagePath | String | True | A page on the website specified by path and/or query parameters. Use this with hostname to get the page's full URL. | ||
PagePathLevel1 | String | True | This dimension rolls up all the page paths in the first hierarchical level in pagePath. | ||
PagePathLevel2 | String | True | This dimension rolls up all the page paths in the second hierarchical level in pagePath. | ||
PagePathLevel3 | String | True | This dimension rolls up all the page paths in the third hierarchical level in pagePath. | ||
PagePathLevel4 | String | True | This dimension rolls up all the page paths into hierarchical levels. Up to 4 pagePath levels maybe specified. All additional levels in the pagePath hierarchy are also rolled up in this dimension. | ||
PageTitle | String | True | The page's title. Multiple pages might have the same page title. | ||
LandingPagePath | String | True | The first page in users' sessions, or the landing page. | ||
SecondPagePath | String | True | The second page in users' sessions. | ||
ExitPagePath | String | True | The last page or exit page in users' sessions. | ||
PreviousPagePath | String | True | A page visited before another page on the same property, typically used with the pagePath dimension. | ||
PageDepth | String | True | The number of pages visited by users during a session. The value is a histogram that counts pageviews across a range of possible values. In this calculation, all sessions will have at least one pageview, and some percentage of sessions will have more. | ||
SearchUsed | String | True | A boolean, either Visits With Site Search or Visits Without Site Search, to distinguish whether internal search was used in a session. | ||
SearchKeyword | String | True | Search term used within the property. | ||
SearchKeywordRefinement | String | True | Subsequent keyword search term or string entered by users after a given initial string search. | ||
SearchCategory | String | True | The category used for the internal search if site search categories are enabled in the view. For example, the product category may be electronics, furniture, or clothing. | ||
SearchStartPage | String | True | The page where users initiated an internal search. | ||
SearchDestinationPage | String | True | The page users immediately visited after performing an internal search on the site. This is usually the search results page. | ||
SearchAfterDestinationPage | String | True | The page that users visited after performing an internal search on the site. | ||
AppInstallerId | String | True | The Id of the app installer (e.g., Google Play Store) from which the app was downloaded. By default, the app installer Id is set by the PackageManager#getInstallerPackageName method. | ||
AppVersion | String | True | The application version. | ||
AppName | String | True | The application name. | ||
AppId | String | True | The application ID. | ||
ScreenName | String | True | The name of the screen. | ||
ScreenDepth | String | True | The number of screenviews (reported as a string) per session, useful for historgrams. | ||
LandingScreenName | String | True | The name of the first viewed screen. | ||
ExitScreenName | String | True | The name of the screen where users exited the application. | ||
EventCategory | String | True | The event category. | ||
EventAction | String | True | Event action. | ||
EventLabel | String | True | Event label. | ||
TransactionId | String | True | The transaction ID, supplied by the ecommerce tracking method, for the purchase in the shopping cart. | ||
Affiliation | String | True | A product affiliation to designate a supplying company or brick and mortar location. | ||
SessionsToTransaction | String | True | The number of sessions between users' purchases and the related campaigns that lead to the purchases. | ||
DaysToTransaction | String | True | The number of days between users' purchases and the most recent campaign source prior to the purchase. | ||
ProductSku | String | True | The product SKU, defined in the ecommerce tracking application, for purchased items. | ||
ProductName | String | True | The product name, supplied by the ecommerce tracking application, for purchased items. | ||
ProductCategory | String | True | Any product variation (size, color) supplied by the ecommerce application for purchased items, not compatible with Enhanced Ecommerce. | ||
CurrencyCode | String | True | The local currency code (based on ISO 4217 standard) of the transaction. | ||
SocialInteractionNetwork | String | True | For social interactions, this represents the social network being tracked. | ||
SocialInteractionAction | String | True | For social interactions, this is the social action (e.g., +1, bookmark) being tracked. | ||
SocialInteractionNetworkAction | String | True | For social interactions, this is the concatenation of the socialInteractionNetwork and socialInteractionAction action (e.g., Google: +1) being tracked at this hit level. | ||
SocialInteractionTarget | String | True | For social interactions, this is the URL (or resource) which receives the social network action. | ||
SocialEngagementType | String | True | Engagement type. | ||
UserTimingCategory | String | True | For easier reporting purposes, this is used to categorize all user timing variables into logical groups. | ||
UserTimingLabel | String | True | The name of the resource's action being tracked. | ||
UserTimingVariable | String | True | Used to add flexibility to visualize user timings in the reports. | ||
ExceptionDescription | String | True | The description for the exception. | ||
ExperimentId | String | True | The user-scoped Id of the content experiment that users were exposed to when the metrics were reported. | ||
ExperimentVariant | String | True | The user-scoped Id of the particular variant that users were exposed to during a content experiment. | ||
Date | String | True | The date of the session formatted as YYYYMMDD. | ||
Year | String | True | The year of the session, a four-digit year from 2005 to the current year. | ||
Month | String | True | Month of the session, a two digit integer from 01 to 12. | ||
Week | String | True | The week of the session, a two-digit number from 01 to 53. Each week starts on Sunday. | ||
Day | String | True | The day of the month, a two-digit number from 01 to 31. | ||
Hour | String | True | A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. If the timezone follows daylight savings time, there will be an apparent bump in the number of sessions during the changeover hour (e.g., between 1:00 and 2:00) for the day per year when that hour repeats. A corresponding hour with zero sessions will occur at the opposite changeover. (Google Analytics does not track user time more precisely than hours.) | ||
Minute | String | True | Returns the minutes, between 00 and 59, in the hour. | ||
NthMonth | String | True | The index for a month in the specified date range. In the date range, the index for the first month is 0, for the second month 1, and so on. | ||
NthWeek | String | True | The index for each week in the specified date range. The index for the first week in the date range is 0, for the second week 1, and so on. The index corresponds to week entries. | ||
NthDay | String | True | The index for each day in the specified date range. The index for the first day (i.e., start-date) in the date range is 0, for the second day 1, and so on. | ||
NthMinute | String | True | The index for each minute in the specified date range. The index for the first minute of the first day (i.e., start-date) in the date range is 0, for the next minute 1, and so on. | ||
DayOfWeek | String | True | Day of the week, a one-digit number from 0 (Sunday) to 6 (Saturday). | ||
DayOfWeekName | String | True | Name (in English) of the day of the week. | ||
DateHour | String | True | Combined values of ga:date and ga:hour formated as YYYYMMDDHH. | ||
DateHourMinute | String | True | Combined values of ga:date, ga:hour and ga:minute formated as YYYYMMDDHHMM. | ||
YearMonth | String | True | Combined values of ga:year and ga:month. | ||
YearWeek | String | True | Combined values of ga:year and ga:week. | ||
IsoWeek | String | True | ISO week number, where each week starts on Monday. For details, see http://en.wikipedia.org/wiki/ISO_week_date. ga:isoWeek should only be used with ga:isoYear because ga:year represents Gregorian calendar. | ||
IsoYear | String | True | The ISO year of the session. For details, see http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear should only be used with ga:isoWeek because ga:week represents Gregorian calendar. | ||
IsoYearIsoWeek | String | True | Combined values of ga:isoYear and ga:isoWeek. | ||
DcmClickAd | String | True | DCM ad name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickAdId | String | True | DCM ad Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickAdType | String | True | DCM ad type name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickAdTypeId | String | True | DCM ad type Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickAdvertiser | String | True | DCM advertiser name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickAdvertiserId | String | True | DCM advertiser Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCampaign | String | True | DCM campaign name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCampaignId | String | True | DCM campaign Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCreativeId | String | True | DCM creative Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCreative | String | True | DCM creative name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickRenderingId | String | True | DCM rendering Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCreativeType | String | True | DCM creative type name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCreativeTypeId | String | True | DCM creative type Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickCreativeVersion | String | True | DCM creative version of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickSite | String | True | Site name where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickSiteId | String | True | DCM site Id where the DCM creative was shown and clicked on for the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickSitePlacement | String | True | DCM site placement name of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickSitePlacementId | String | True | DCM site placement Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmClickSpotId | String | True | DCM Floodlight configuration Id of the DCM click matching the Google Analytics session (Analytics 360 only). | ||
DcmFloodlightActivity | String | True | DCM Floodlight activity name associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightActivityAndGroup | String | True | DCM Floodlight activity name and group name associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightActivityGroup | String | True | DCM Floodlight activity group name associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightActivityGroupId | String | True | DCM Floodlight activity group Id associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightActivityId | String | True | DCM Floodlight activity Id associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightAdvertiserId | String | True | DCM Floodlight advertiser Id associated with the floodlight conversion (Analytics 360 only). | ||
DcmFloodlightSpotId | String | True | DCM Floodlight configuration Id associated with the floodlight conversion (Analytics 360 only). | ||
DcmLastEventAd | String | True | DCM ad name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAdId | String | True | DCM ad Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAdType | String | True | DCM ad type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAdTypeId | String | True | DCM ad type Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAdvertiser | String | True | DCM advertiser name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAdvertiserId | String | True | DCM advertiser Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventAttributionType | String | True | There are two possible values: ClickThrough and ViewThrough. If the last DCM event associated with the Google Analytics session was a click, then the value will be ClickThrough. If the last DCM event associated with the Google Analytics session was an ad impression, then the value will be ViewThrough (Analytics 360 only). | ||
DcmLastEventCampaign | String | True | DCM campaign name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCampaignId | String | True | DCM campaign Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCreativeId | String | True | DCM creative Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCreative | String | True | DCM creative name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventRenderingId | String | True | DCM rendering Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCreativeType | String | True | DCM creative type name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCreativeTypeId | String | True | DCM creative type Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventCreativeVersion | String | True | DCM creative version of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventSite | String | True | Site name where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventSiteId | String | True | DCM site Id where the DCM creative was shown and clicked on for the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventSitePlacement | String | True | DCM site placement name of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventSitePlacementId | String | True | DCM site placement Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
DcmLastEventSpotId | String | True | DCM Floodlight configuration Id of the last DCM event (impression or click within the DCM lookback window) associated with the Google Analytics session (Analytics 360 only). | ||
LandingContentGroup1 | String | True | Content group of users' landing pages. | ||
LandingContentGroup2 | String | True | Content group of users' landing pages. | ||
LandingContentGroup3 | String | True | Content group of users' landing pages. | ||
LandingContentGroup4 | String | True | Content group of users' landing pages. | ||
LandingContentGroup5 | String | True | Content group of users' landing pages. | ||
LandingContentGroup6 | String | True | Content group of users' landing pages. | ||
LandingContentGroup7 | String | True | Content group of users' landing pages. | ||
LandingContentGroup8 | String | True | Content group of users' landing pages. | ||
LandingContentGroup9 | String | True | Content group of users' landing pages. | ||
LandingContentGroup10 | String | True | Content group of users' landing pages. | ||
LandingContentGroup11 | String | True | Content group of users' landing pages. | ||
LandingContentGroup12 | String | True | Content group of users' landing pages. | ||
LandingContentGroup13 | String | True | Content group of users' landing pages. | ||
LandingContentGroup14 | String | True | Content group of users' landing pages. | ||
LandingContentGroup15 | String | True | Content group of users' landing pages. | ||
LandingContentGroup16 | String | True | Content group of users' landing pages. | ||
LandingContentGroup17 | String | True | Content group of users' landing pages. | ||
LandingContentGroup18 | String | True | Content group of users' landing pages. | ||
LandingContentGroup19 | String | True | Content group of users' landing pages. | ||
LandingContentGroup20 | String | True | Content group of users' landing pages. | ||
PreviousContentGroup1 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup2 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup3 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup4 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup5 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup6 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup7 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup8 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup9 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup10 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup11 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup12 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup13 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup14 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup15 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup16 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup17 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup18 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup19 | String | True | Refers to content group that was visited before another content group. | ||
PreviousContentGroup20 | String | True | Refers to content group that was visited before another content group. | ||
ContentGroup1 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup2 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup3 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup4 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup5 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup6 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup7 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup8 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup9 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup10 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup11 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup12 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup13 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup14 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup15 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup16 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup17 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup18 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup19 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
ContentGroup20 | String | True | The content group on a property. A content group is a collection of content providing a logical structure that can be determined by tracking code or page title/URL regex match, or predefined rules. | ||
UserAgeBracket | String | True | Age bracket of users. | ||
UserGender | String | True | Gender of users. | ||
InterestOtherCategory | String | True | Indicates that users are more likely to be interested in learning about the specified category, and more likely to be ready to purchase. | ||
InterestAffinityCategory | String | True | Indicates that users are more likely to be interested in learning about the specified category. | ||
InterestInMarketCategory | String | True | Indicates that users are more likely to be ready to purchase products or services in the specified category. | ||
DfpLineItemId | String | True | The Id of the Google Ad Manager line item. | ||
DfpLineItemName | String | True | The name of the Google Ad Manager line item. | ||
AcquisitionCampaign | String | True | The campaign through which users were acquired, derived from users' first session. | ||
AcquisitionMedium | String | True | The medium through which users were acquired, derived from users' first session. | ||
AcquisitionSource | String | True | The source through which users were acquired, derived from users' first session. | ||
AcquisitionSourceMedium | String | True | The combined value of ga:userAcquisitionSource and ga:acquisitionMedium. | ||
AcquisitionTrafficChannel | String | True | Traffic channel through which users were acquired. It is extracted from users' first session. Traffic channel is computed based on the default channel grouping rules (at view level if available) at the time of user acquisition. | ||
BrowserSize | String | True | The viewport size of users' browsers. A session-scoped dimension, browser size captures the initial dimensions of the viewport in pixels and is formatted as width x height, for example, 1920x960. | ||
CampaignCode | String | True | For manual campaign tracking, it is the value of the utm_id campaign tracking parameter. | ||
ChannelGrouping | String | True | The Channel Group associated with an end user's session for this View (defined by the View's Channel Groupings). | ||
CheckoutOptions | String | True | User options specified during the checkout process, e.g., FedEx, DHL, UPS for delivery options; Visa, MasterCard, AmEx for payment options. This dimension should be used with ga:shoppingStage (Enhanced Ecommerce). | ||
CityId | String | True | 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. | ||
Cohort | String | True | Name of the cohort to which a user belongs. Depending on how cohorts are defined, a user can belong to multiple cohorts, similar to how a user can belong to multiple segments. | ||
CohortNthDay | String | True | Day offset relative to the cohort definition date. For example, if a cohort is defined with the first visit date as 2015-09-01, then for the date 2015-09-04, ga:cohortNthDay will be 3. | ||
CohortNthMonth | String | True | Month offset relative to the cohort definition date. The semantics of this dimension differs based on whether lifetime value is requested. For a cohorts report not requesting lifetime value: This is the week offset from the cohort definition start date. For example, if cohort is defined as 2015-09-01<= first session date<= 2015-09-30. Then, for 2015-09-01<= date<= 2015-09-30, ga:cohortNthMonth = 0. 2015-10-01<= date<= 2015-10-31, ga:cohortNthMonth = 2. and so on. For a cohorts request requesting lifetime value: ga:cohortNthMonth is calculated relative to the users acquisition date. It is not dependent on the cohort definition date. For example, if we define a cohort as 2015-10-01<= first session date<= 2015-09-30. And a user was acquired on 2015-09-04. Then, for 2015-09-04<= date<= 2015-10-04, ga:cohortNthMonth = 0 2015-10-04<= date<= 2015-11-04, ga:cohortNthMonth = 1, and so on. | ||
CohortNthWeek | String | True | Week offset relative to the cohort definition date. The semantics of this dimension differs based on whether lifetime value is requested. For a cohorts report not requesting lifetime value: This is the week offset from the cohort definition start date. For example, if cohort is defined as 2015-09-01<= first session date<= 2015-09-07. Then, for 2015-09-01<= date<= 2015-09-07, ga:cohortNthWeek = 0. 2015-09-08<= date<= 2015-09-14, ga:cohortNthWeek = 1. etc. For a cohorts request requesting lifetime value: ga:cohortNthWeek is calculated relative to the users acquisition date. It is not dependent on the cohort definition date. For example, if we define a cohort as 2015-09-01<= first session date<= 2015-09-07. And a user was acquired on 2015-09-04. Then, for 2015-09-04<= date<= 2015-09-10, ga:cohortNthWeek = 0 2015-09-11<= date<= 2015-09-17, ga:cohortNthWeek = 1 | ||
ContinentId | String | True | Users' continent ID, derived from users' IP addresses or Geographical IDs. | ||
CountryIsoCode | String | True | Users' country's ISO code (in ISO-3166-1 alpha-2 format), derived from their IP addresses or Geographical IDs. For example, BR for Brazil, CA for Canada. | ||
DataSource | String | True | The data source of a hit. By default, hits sent from analytics.js are reported as | ||
DbmClickAdvertiser | String | True | DBM advertiser name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickAdvertiserId | String | True | DBM advertiser Id of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickCreativeId | String | True | DBM creative Id of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickExchange | String | True | DBM exchange name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickExchangeId | String | True | DBM exchange Id of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickInsertionOrder | String | True | DBM insertion order name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickInsertionOrderId | String | True | DBM insertion order Id of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickLineItem | String | True | DBM line item name of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickLineItemId | String | True | DBM line item Id of the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickSite | String | True | DBM site name where the DBM creative was shown and clicked on for the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmClickSiteId | String | True | DBM site Id where the DBM creative was shown and clicked on for the DBM click matching the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventAdvertiser | String | True | DBM advertiser name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventAdvertiserId | String | True | DBM advertiser Id of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventCreativeId | String | True | DBM creative Id of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventExchange | String | True | DBM exchange name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventExchangeId | String | True | DBM exchange Id of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventInsertionOrder | String | True | DBM insertion order name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventInsertionOrderId | String | True | DBM insertion order Id of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventLineItem | String | True | DBM line item name of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventLineItemId | String | True | DBM line item Id of the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventSite | String | True | DBM site name where the DBM creative was shown and clicked on for the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DbmLastEventSiteId | String | True | DBM site Id where the DBM creative was shown and clicked on for the last DBM event (impression or click within the DBM lookback window) associated with the Google Analytics session (Analytics 360 only, requires integration with DBM). | ||
DsAdGroup | String | True | DS Ad Group (Analytics 360 only, requires integration with DS). | ||
DsAdGroupId | String | True | DS Ad Group Id (Analytics 360 only, requires integration with DS). | ||
DsAdvertiser | String | True | DS Advertiser (Analytics 360 only, requires integration with DS). | ||
DsAdvertiserId | String | True | DS Advertiser Id (Analytics 360 only, requires integration with DS). | ||
DsAgency | String | True | DS Agency (Analytics 360 only, requires integration with DS). | ||
DsAgencyId | String | True | DS Agency Id (Analytics 360 only, requires integration with DS). | ||
DsCampaign | String | True | DS Campaign (Analytics 360 only, requires integration with DS). | ||
DsCampaignId | String | True | DS Campaign Id (Analytics 360 only, requires integration with DS). | ||
DsEngineAccount | String | True | DS Engine Account (Analytics 360 only, requires integration with DS). | ||
DsEngineAccountId | String | True | DS Engine Account Id (Analytics 360 only, requires integration with DS). | ||
DsKeyword | String | True | DS Keyword (Analytics 360 only, requires integration with DS). | ||
DsKeywordId | String | True | DS Keyword Id (Analytics 360 only, requires integration with DS). | ||
ExperimentCombination | String | True | The user-scoped Id of the experiment and variant that users were exposed to during an experiment. | ||
ExperimentName | String | True | The user-scoped name of the content experiment that users were exposed to when the metrics were reported. | ||
InternalPromotionCreative | String | True | The creative content designed for a promotion (Enhanced Ecommerce). | ||
InternalPromotionId | String | True | The Id of the promotion (Enhanced Ecommerce). | ||
InternalPromotionName | String | True | The name of the promotion (Enhanced Ecommerce). | ||
InternalPromotionPosition | String | True | The position of the promotion on the web page or application screen (Enhanced Ecommerce). | ||
IsTrueViewVideoAd | String | True | A boolean, Yes or No, indicating whether the ad is an AdWords TrueView video ad. | ||
MetroId | String | True | The three digit Designated Market Area (DMA) code from where traffic arrived, derived from users' IP addresses or Geographical IDs. | ||
NthHour | String | True | The index for each hour in the specified date range. The index for the first hour of the first day (i.e., start-date) in the date range is 0, for the next hour 1, and so on. | ||
OrderCouponCode | String | True | Code for the order-level coupon (Enhanced Ecommerce). | ||
ProductBrand | String | True | The brand name under which the product is sold (Enhanced Ecommerce). | ||
ProductCategoryHierarchy | String | True | The hierarchical category in which the product is classified (Enhanced Ecommerce). | ||
ProductCategoryLevel1 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel2 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel3 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel4 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel5 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel6 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel7 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel8 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel9 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel10 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel11 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel12 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel13 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel14 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel15 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel16 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel17 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel18 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel19 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCategoryLevel20 | String | True | Level (1-5) in the product category hierarchy, starting from the top (Enhanced Ecommerce). | ||
ProductCouponCode | String | True | Code for the product-level coupon (Enhanced Ecommerce). | ||
ProductListName | String | True | The name of the product list in which the product appears (Enhanced Ecommerce). | ||
ProductListPosition | String | True | The position of the product in the product list (Enhanced Ecommerce). | ||
ProductVariant | String | True | The specific variation of a product, e.g., XS, S, M, L for size; or Red, Blue, Green, Black for color (Enhanced Ecommerce). | ||
RegionId | String | True | Users' region ID, derived from their IP addresses or Geographical IDs. In U.S., a region is a state, New York, for example. The region IDs are the same as the Criteria IDs listed at https://developers.google.com/analytics/devguides/collection/protocol/v1/geoid. | ||
RegionIsoCode | String | True | Users' region ISO code in ISO-3166-2 format, derived from their IP addresses or Geographical IDs. | ||
ShoppingStage | String | True | Various stages of the shopping experience that users completed in a session, e.g., PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc. (Enhanced Ecommerce). | ||
SubContinentCode | String | True | Users' sub-continent code in UN M.49 format, derived from their IP addresses or Geographical IDs. For example, 061 for Polynesia, 154 for Northern Europe. | ||
Dimension1 | String | True | The value of the requested custom dimension-01. | ||
Dimension2 | String | True | The value of the requested custom dimension-02. | ||
Dimension3 | String | True | The value of the requested custom dimension-03. | ||
dimension4 | String | True | The value of the requested custom dimension-04. | ||
dimension5 | String | True | The value of the requested custom dimension-05. | ||
Dimension6 | String | True | The value of the requested custom dimension-06. | ||
Dimension7 | String | True | The value of the requested custom dimension-07. | ||
Dimension8 | String | True | The value of the requested custom dimension-08. | ||
Dimension9 | String | True | The value of the requested custom dimension-09. | ||
Dimension10 | String | True | The value of the requested custom dimension-10. | ||
Dimension11 | String | True | The value of the requested custom dimension-11. | ||
Dimension12 | String | True | The value of the requested custom dimension-12. | ||
Dimension13 | String | True | The value of the requested custom dimension-13. | ||
Dimension14 | String | True | The value of the requested custom dimension-14. | ||
Dimension15 | String | True | The value of the requested custom dimension-15. | ||
Dimension16 | String | True | The value of the requested custom dimension-16. | ||
Dimension17 | String | True | The value of the requested custom dimension-17. | ||
Dimension18 | String | True | The value of the requested custom dimension-18. | ||
Dimension19 | String | True | The value of the requested custom dimension-19. | ||
Dimension20 | String | True | The value of the requested custom dimension-20. | ||
CustomVarName1 | String | True | The name for the requested custom variable-01. | ||
CustomVarName2 | String | True | The name for the requested custom variable-02. | ||
CustomVarName3 | String | True | The name for the requested custom variable-03. | ||
CustomVarName4 | String | True | The name for the requested custom variable-04. | ||
CustomVarName5 | String | True | The name for the requested custom variable-05. | ||
CustomVarValue1 | String | True | The value for the requested custom variable-01. | ||
CustomVarValue2 | String | True | The value for the requested custom variable-02. | ||
CustomVarValue3 | String | True | The value for the requested custom variable-03. | ||
CustomVarValue4 | String | True | The value for the requested custom variable-04. | ||
CustomVarValue5 | String | True | The value for the requested custom variable-05. | ||
Users | Integer | False | True | The total number of users for the requested time period. | |
NewUsers | Integer | False | The number of sessions marked as a user's first sessions. | ||
PercentNewSessions | Decimal | False | The percentage of sessions by users who had never visited the property before. | ||
1dayUsers | Integer | False | Total number of 1-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension to query this metric. For a given date, the returned value will be the total number of unique users for the 1-day period ending on the given date. | ||
7dayUsers | Integer | False | Total number of 7-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension to query this metric. For a given date, the returned value will be the total number of unique users for the 7-day period ending on the given date. | ||
14dayUsers | Integer | False | Total number of 14-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension to query this metric. For a given date, the returned value will be the total number of unique users for the 14-day period ending on the given date. | ||
28dayUsers | Integer | False | Total number of 28-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension to query this metric. For a given date, the returned value will be the total number of unique users for the 28-day period ending on the given date. | ||
30dayUsers | Integer | False | Total number of 30-day active users for each day in the requested time period. At least one of ga:nthDay, ga:date, or ga:day must be specified as a dimension to query this metric. For a given date, the returned value will be the total number of unique users for the 30-day period ending on the given date. | ||
Sessions | Integer | False | True | The total number of sessions. | |
Bounces | Integer | False | The total number of single page (or single interaction hit) sessions for the property. | ||
BounceRate | Decimal | False | The percentage of single-page session (i.e., session in which the person left the property from the first page). | ||
SessionDuration | String | False | Total duration (in seconds) of users' sessions. | ||
AvgSessionDuration | String | False | The average duration (in seconds) of users' sessions. | ||
OrganicSearches | Integer | False | The number of organic searches happened in a session. This metric is search engine agnostic. | ||
Impressions | Integer | False | Total number of campaign impressions. | ||
AdClicks | Integer | False | Total number of times users have clicked on an ad to reach the property. | ||
AdCost | Decimal | False | Derived cost for the advertising campaign. Its currency is the one you set in the AdWords account. | ||
CPM | Decimal | False | Cost per thousand impressions. | ||
CPC | Decimal | False | Cost to advertiser per click. | ||
CTR | Decimal | False | Click-through-rate for the ad. This is equal to the number of clicks divided by the number of impressions for the ad (e.g., how many times users clicked on one of the ads where that ad appeared). | ||
CostPerTransaction | Decimal | False | The cost per transaction for the property. | ||
CostPerGoalConversion | Decimal | False | The cost per goal conversion for the property. | ||
CostPerConversion | Decimal | False | The cost per conversion (including ecommerce and goal conversions) for the property. | ||
RPC | Decimal | False | RPC or revenue-per-click, the average revenue (from ecommerce sales and/or goal value) you received for each click on one of the search ads. | ||
ROAS | Decimal | False | Return On Ad Spend (ROAS) is the total transaction revenue and goal value divided by derived advertising cost. | ||
Goal1Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal2Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal3Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal4Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal5Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal6Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal7Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal8Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal9Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal10Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal11Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal12Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal13Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal14Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal15Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal16Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal17Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal18Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal19Starts | Integer | False | The total number of starts for the requested goal number. | ||
Goal20Starts | Integer | False | The total number of starts for the requested goal number. | ||
GoalStartsAll | Integer | False | Total number of starts for all goals defined in the profile. | ||
Goal1Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal2Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal3Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal4Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal5Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal6Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal7Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal8Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal9Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal10Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal11Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal12Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal13Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal14Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal15Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal16Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal17Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal18Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal19Completions | Integer | False | The total number of completions for the requested goal number. | ||
Goal20Completions | Integer | False | The total number of completions for the requested goal number. | ||
GoalCompletionsAll | Integer | False | Total number of completions for all goals defined in the profile. | ||
Goal1Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal2Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal3Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal4Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal5Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal6Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal7Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal8Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal9Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal10Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal11Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal12Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal13Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal14Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal15Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal16Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal17Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal18Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal19Value | Decimal | False | The total numeric value for the requested goal number. | ||
Goal20Value | Decimal | False | The total numeric value for the requested goal number. | ||
GoalValueAll | Decimal | False | Total numeric value for all goals defined in the profile. | ||
GoalValuePerSession | Decimal | False | The average goal value of a session. | ||
Goal1ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal2ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal3ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal4ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal5ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal6ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal7ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal8ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal9ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal10ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal11ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal12ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal13ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal14ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal15ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal16ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal17ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal18ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal19ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
Goal20ConversionRate | Decimal | False | Percentage of sessions resulting in a conversion to the requested goal number. | ||
GoalConversionRateAll | Decimal | False | The percentage of sessions which resulted in a conversion to at least one of the goals. | ||
Goal1Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal2Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal3Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal4Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal5Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal6Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal7Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal8Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal9Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal10Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal11Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal12Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal13Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal14Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal15Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal16Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal17Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal18Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal19Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
Goal20Abandons | Integer | False | The number of times users started conversion activity on the requested goal number without actually completing it. | ||
GoalAbandonsAll | Integer | False | The overall number of times users started goals without actually completing them. | ||
Goal1AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal2AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal3AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal4AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal5AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal6AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal7AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal8AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal9AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal10AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal11AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal12AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal13AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal14AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal15AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal16AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal17AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal18AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal19AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
Goal20AbandonRate | Decimal | False | The rate at which the requested goal number was abandoned. | ||
GoalAbandonRateAll | Decimal | False | Goal abandonment rate. | ||
PageValue | Decimal | False | The average value of this page or set of pages, which is equal to (ga:transactionRevenue + ga:goalValueAll) / ga:uniquePageviews. | ||
Entrances | Integer | False | The number of entrances to the property measured as the first pageview in a session, typically used with landingPagePath. | ||
EntranceRate | Decimal | False | The percentage of pageviews in which this page was the entrance. | ||
Pageviews | Integer | False | The total number of pageviews for the property. | ||
PageviewsPerSession | Float | False | The average number of pages viewed during a session, including repeated views of a single page. | ||
ContentGroupUniqueViews1 | Integer | False | 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. | ||
ContentGroupUniqueViews2 | Integer | False | 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. | ||
ContentGroupUniqueViews3 | Integer | False | 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. | ||
ContentGroupUniqueViews4 | Integer | False | 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. | ||
ContentGroupUniqueViews5 | Integer | False | 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. | ||
ContentGroupUniqueViews6 | Integer | False | 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. | ||
ContentGroupUniqueViews7 | Integer | False | 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. | ||
ContentGroupUniqueViews8 | Integer | False | 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. | ||
ContentGroupUniqueViews9 | Integer | False | 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. | ||
ContentGroupUniqueViews10 | Integer | False | 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. | ||
ContentGroupUniqueViews11 | Integer | False | 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. | ||
ContentGroupUniqueViews12 | Integer | False | 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. | ||
ContentGroupUniqueViews13 | Integer | False | 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. | ||
ContentGroupUniqueViews14 | Integer | False | 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. | ||
ContentGroupUniqueViews15 | Integer | False | 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. | ||
ContentGroupUniqueViews16 | Integer | False | 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. | ||
ContentGroupUniqueViews17 | Integer | False | 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. | ||
ContentGroupUniqueViews18 | Integer | False | 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. | ||
ContentGroupUniqueViews19 | Integer | False | 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. | ||
ContentGroupUniqueViews20 | Integer | False | 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. | ||
UniquePageviews | Integer | False | Unique Pageviews is the number of sessions during which the specified page was viewed at least once. A unique pageview is counted for each page URL + page title combination. | ||
TimeOnPage | String | False | Time (in seconds) users spent on a particular page, calculated by subtracting the initial view time for a particular page from the initial view time for a subsequent page. This metric does not apply to exit pages of the property. | ||
AvgTimeOnPage | String | False | The average time users spent viewing this page or a set of pages. | ||
Exits | Integer | False | The number of exits from the property. | ||
ExitRate | Decimal | False | The percentage of exits from the property that occurred out of the total pageviews. | ||
SearchResultViews | Integer | False | The number of times a search result page was viewed. | ||
SearchUniques | Integer | False | Total number of unique keywords from internal searches within a session. For example, if | ||
AvgSearchResultViews | Float | False | The average number of times people viewed a page as a result of a search. | ||
SearchSessions | Integer | False | The total number of sessions that included an internal search. | ||
PercentSessionsWithSearch | Decimal | False | The percentage of sessions with search. | ||
SearchDepth | Integer | False | The total number of subsequent page views made after a use of the site's internal search feature. | ||
AvgSearchDepth | Float | False | The average number of pages people viewed after performing a search. | ||
SearchRefinements | Integer | False | The total number of times a refinement (transition) occurs between internal keywords search within a session. For example, if the sequence of keywords is | ||
PercentSearchRefinements | Decimal | False | The percentage of the number of times a refinement (i.e., transition) occurs between internal keywords search within a session. | ||
SearchDuration | String | False | The session duration when the site's internal search feature is used. | ||
AvgSearchDuration | String | False | The average time (in seconds) users, after searching, spent on the property. | ||
SearchExits | Integer | False | The number of exits on the site that occurred following a search result from the site's internal search feature. | ||
SearchExitRate | Decimal | False | The percentage of searches that resulted in an immediate exit from the property. | ||
SearchGoal1ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal2ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal3ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal4ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal5ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal6ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal7ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal8ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal9ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal10ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal11ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal12ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal13ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal14ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal15ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal16ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal17ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal18ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal19ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoal20ConversionRate | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to the requested goal number. | ||
SearchGoalConversionRateAll | Decimal | False | The percentage of search sessions (i.e., sessions that included at least one search) which resulted in a conversion to at least one of the goals. | ||
GoalValueAllPerSearch | Decimal | False | The average goal value of a search. | ||
PageLoadTime | Integer | False | 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. | ||
PageLoadSample | Integer | False | The sample set (or count) of pageviews used to calculate the average page load time. | ||
AvgPageLoadTime | Float | False | The average time (in seconds) pages from the sample set take to load, from initiation of the pageview (e.g., a click on a page link) to load completion in the browser. | ||
DomainLookupTime | Integer | False | The total time (in milliseconds) all samples spent in DNS lookup for this page. | ||
AvgDomainLookupTime | Float | False | The average time (in seconds) spent in DNS lookup for this page. | ||
PageDownloadTime | Integer | False | The total time (in milliseconds) to download this page among all samples. | ||
AvgPageDownloadTime | Float | False | The average time (in seconds) to download this page. | ||
RedirectionTime | Integer | False | The total time (in milliseconds) all samples spent in redirects before fetching this page. If there are no redirects, this is 0. | ||
AvgRedirectionTime | Float | False | The average time (in seconds) spent in redirects before fetching this page. If there are no redirects, this is 0. | ||
ServerConnectionTime | Integer | False | Total time (in milliseconds) all samples spent in establishing a TCP connection to this page. | ||
AvgServerConnectionTime | Float | False | The average time (in seconds) spent in establishing a TCP connection to this page. | ||
ServerResponseTime | Integer | False | 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. | ||
AvgServerResponseTime | Float | False | The average time (in seconds) the site's server takes to respond to users' requests; this includes the network time from users' locations to the server. | ||
SpeedMetricsSample | Integer | False | The sample set (or count) of pageviews used to calculate the averages of site speed metrics. This metric is used in all site speed average calculations, including avgDomainLookupTime, avgPageDownloadTime, avgRedirectionTime, avgServerConnectionTime, and avgServerResponseTime. | ||
DomInteractiveTime | Integer | False | The time (in milliseconds), including the network time from users' locations to the site's server, the browser takes to parse the document (DOMInteractive). At this time, users can interact with the Document Object Model even though it is not fully loaded. | ||
AvgDomInteractiveTime | Float | False | The average time (in seconds), 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. | ||
DomContentLoadedTime | Integer | False | 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). When parsing of the document is finished, the Document Object Model (DOM) is ready, but the referenced style sheets, images, and subframes may not be finished loading. This is often the starting point of Javascript framework execution, e.g., JQuery's onready() callback. | ||
AvgDomContentLoadedTime | Float | False | The average time (in seconds) the browser takes to parse the document. | ||
DomLatencyMetricsSample | Integer | False | Sample set (or count) of pageviews used to calculate the averages for site speed DOM metrics. This metric is used to calculate ga:avgDomContentLoadedTime and ga:avgDomInteractiveTime. | ||
Screenviews | Integer | False | The total number of screenviews. | ||
UniqueScreenviews | Integer | False | The number of unique screen views. Screen views in different sessions are counted as separate screen views. | ||
ScreenviewsPerSession | Float | False | The average number of screenviews per session. | ||
TimeOnScreen | String | False | The time spent viewing the current screen. | ||
AvgScreenviewDuration | String | False | Average time (in seconds) users spent on a screen. | ||
TotalEvents | Integer | False | The total number of events for the profile, across all categories. | ||
UniqueDimensionCombinations | Integer | False | Unique Dimension Combinations counts the number of unique dimension-value combinations for each dimension in a report. This lets you build combined (concatenated) dimensions post-processing, which allows for more flexible reporting without having to update your tracking implementation or use additional custom-dimension slots. For more information, see https://support.google.com/analytics/answer/7084499. | ||
UniqueEvents | Integer | False | The number of unique events. Events in different sessions are counted as separate events. | ||
EventValue | Integer | False | Total value of events for the profile. | ||
AvgEventValue | Float | False | The average value of an event. | ||
SessionsWithEvent | Integer | False | The total number of sessions with events. | ||
EventsPerSessionWithEvent | Float | False | The average number of events per session with event. | ||
Transactions | Integer | False | The total number of transactions. | ||
TransactionsPerSession | Decimal | False | The average number of transactions in a session. | ||
TransactionRevenue | Decimal | False | The total sale revenue (excluding shipping and tax) of the transaction. | ||
RevenuePerTransaction | Decimal | False | The average revenue of an ecommerce transaction. | ||
TransactionRevenuePerSession | Decimal | False | Average transaction revenue for a session. | ||
TransactionShipping | Decimal | False | The total cost of shipping. | ||
TransactionTax | Decimal | False | Total tax for the transaction. | ||
TotalValue | Decimal | False | Total value for the property (including total revenue and total goal value). | ||
ItemQuantity | Integer | False | Total number of items purchased. For example, if users purchase 2 frisbees and 5 tennis balls, this will be 7. | ||
UniquePurchases | Integer | False | The number of product sets purchased. For example, if users purchase 2 frisbees and 5 tennis balls from the site, this will be 2. | ||
RevenuePerItem | Decimal | False | The average revenue per item. | ||
ItemRevenue | Decimal | False | The total revenue from purchased product items. | ||
ItemsPerPurchase | Float | False | The average quantity of this item (or group of items) sold per purchase. | ||
LocalTransactionRevenue | Decimal | False | Transaction revenue in local currency. | ||
LocalTransactionShipping | Decimal | False | Transaction shipping cost in local currency. | ||
LocalTransactionTax | Decimal | False | Transaction tax in local currency. | ||
LocalItemRevenue | Decimal | False | Product revenue in local currency. | ||
SocialInteractions | Integer | False | The total number of social interactions. | ||
UniqueSocialInteractions | Integer | False | 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. | ||
SocialInteractionsPerSession | Float | False | The number of social interactions per session. | ||
UserTimingValue | Integer | False | Total number of milliseconds for user timing. | ||
UserTimingSample | Integer | False | The number of hits sent for a particular userTimingCategory, userTimingLabel, or userTimingVariable. | ||
AvgUserTimingValue | Float | False | The average elapsed time. | ||
Exceptions | Integer | False | The number of exceptions sent to Google Analytics. | ||
ExceptionsPerScreenview | Decimal | False | The number of exceptions thrown divided by the number of screenviews. | ||
FatalExceptions | Integer | False | The number of exceptions where isFatal is set to true. | ||
FatalExceptionsPerScreenview | Decimal | False | The number of fatal exceptions thrown divided by the number of screenviews. | ||
DcmFloodlightQuantity | Integer | False | The number of DCM Floodlight conversions (Analytics 360 only). | ||
DcmFloodlightRevenue | Decimal | False | DCM Floodlight revenue (Analytics 360 only). | ||
AdsenseRevenue | Decimal | False | The total revenue from AdSense ads. | ||
AdsenseAdUnitsViewed | Integer | False | The number of AdSense ad units viewed (requires integration with AdSense). An ad unit is a set of ads displayed as a result of one piece of the AdSense ad code. For details, see https://support.google.com/adsense/answer/32715?hl=en. | ||
AdsenseAdsViewed | Integer | False | The number of AdSense ads viewed (requires integration with AdSense). Multiple ads can be displayed within an ad Unit. | ||
AdsenseAdsClicks | Integer | False | The number of times AdSense ads on the site were clicked (requires integration with AdSense). | ||
AdsensePageImpressions | Integer | False | The number of pageviews during which an AdSense ad was displayed (requires integration with AdSense). A page impression can have multiple ad Units. | ||
AdsenseCTR | Decimal | False | The percentage of page impressions resulted in a click on an AdSense ad (requires integration with AdSense). | ||
AdsenseECPM | Decimal | False | The estimated cost per thousand page impressions (requires integration with AdSense). It is the AdSense Revenue per 1,000 page impressions. | ||
AdsenseExits | Integer | False | The number of sessions ended due to a user clicking on an AdSense ad (requires integration with AdSense). | ||
AdsenseViewableImpressionPercent | Decimal | False | The percentage of viewable impressions (requires integration with AdSense). | ||
AdsenseCoverage | Decimal | False | The percentage of ad requests that returned at least one ad (requires integration with AdSense). | ||
TotalPublisherImpressions | Integer | False | An ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we'll display two impressions. | ||
TotalPublisherCoverage | Decimal | False | Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help you identify sites where the publisher account (AdSense, AdX, DFP) isn't able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100 | ||
TotalPublisherMonetizedPageviews | Integer | False | This measures the total number of pageviews on the property that were shown with an ad from one of the linked publisher accounts (AdSense, AdX, DFP). Note that a single page can have multiple ad units. | ||
TotalPublisherImpressionsPerSession | Float | False | The ratio of linked publisher account (AdSense, AdX, DFP) ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions). | ||
TotalPublisherViewableImpressionsPercent | Decimal | False | The percentage of viewable ad impressions. An impression is considered a viewable impression when it has appeared within users' browsers and has the opportunity to be seen. | ||
TotalPublisherClicks | Integer | False | The number of times ads from a linked publisher account (AdSense, AdX, DFP) were clicked on the site. | ||
TotalPublisherCTR | Decimal | False | The percentage of pageviews that resulted in a click on a linked publisher account (AdSense, AdX, DFP) ad. | ||
TotalPublisherRevenue | Decimal | False | The total estimated revenue from all linked publisher account (AdSense, AdX, DFP) ads. | ||
TotalPublisherRevenuePer1000Sessions | Decimal | False | The total estimated revenue from all linked publisher accounts (AdSense, AdX, DFP) per 1,000 Analytics sessions. | ||
TotalPublisherECPM | Decimal | False | The effective cost per thousand pageviews. It is the total estimated revenue from all linked publisher accounts (AdSense, AdX, DFP) per 1,000 pageviews. | ||
AdxImpressions | Integer | False | True | An Ad Exchange ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we'll display two impressions. | |
AdxCoverage | Decimal | False | True | Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help identify sites where the Ad Exchange account isn't able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100 | |
AdxMonetizedPageviews | Integer | False | This measures the total number of pageviews on the property that were shown with an ad from the linked Ad Exchange account. Note that a single page can have multiple ad units. | ||
AdxImpressionsPerSession | Float | False | The ratio of Ad Exchange ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions). | ||
AdxViewableImpressionsPercent | Decimal | False | The percentage of viewable ad impressions. An impression is considered a viewable impression when it has appeared within users' browsers and has the opportunity to be seen. | ||
AdxClicks | Integer | False | True | The number of times AdX ads were clicked on the site. | |
AdxCTR | Decimal | False | True | The percentage of pageviews that resulted in a click on an Ad Exchange ad. | |
AdxRevenue | Decimal | False | True | The total estimated revenue from Ad Exchange ads. | |
AdxRevenuePer1000Sessions | Decimal | False | True | The total estimated revenue from Ad Exchange ads per 1,000 Analytics sessions. Note that this metric is based on sessions to the site, not on ad impressions. | |
AdxECPM | Decimal | False | The effective cost per thousand pageviews. It is the Ad Exchange revenue per 1,000 pageviews. | ||
DfpImpressions | Integer | False | A DFP ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we'll display two impressions (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpCoverage | Decimal | False | Coverage is the percentage of ad requests that returned at least one ad. Generally, coverage can help identify sites where the DFP account isn't able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100 (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpMonetizedPageviews | Integer | False | This measures the total number of pageviews on the property that were shown with an ad from the linked DFP account. Note that a single page can have multiple ad units (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpImpressionsPerSession | Float | False | The ratio of DFP ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions) (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpViewableImpressionsPercent | Decimal | False | The percentage of viewable ad impressions. An impression is considered a viewable impression when it has appeared within users' browsers and has the opportunity to be seen (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpClicks | Integer | False | The number of times DFP ads were clicked on the site (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpCTR | Decimal | False | The percentage of pageviews that resulted in a click on an DFP ad (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpRevenue | Decimal | False | DFP revenue is an estimate of the total ad revenue based on served impressions (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpRevenuePer1000Sessions | Decimal | False | The total estimated revenue from DFP ads per 1,000 Analytics sessions. Note that this metric is based on sessions to the site, not on ad impressions (DFP linking enabled and Hide DFP Revenue not enabled). | ||
DfpECPM | Decimal | False | The effective cost per thousand pageviews. It is the DFP revenue per 1,000 pageviews (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillImpressions | Integer | False | Backfill Impressions is the sum of all AdSense or Ad Exchance ad impressions served as backfill through DFP. An ad impression is reported whenever an individual ad is displayed on the website. For example, if a page with two ad units is viewed once, we'll display two impressions (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillCoverage | Decimal | False | Backfill Coverage is the percentage of backfill ad requests that returned at least one ad. Generally, coverage can help identify sites where the publisher account isn't able to provide targeted ads. (Ad Impressions / Total Ad Requests) * 100. If both AdSense and Ad Exchange are providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillMonetizedPageviews | Integer | False | This measures the total number of pageviews on the property that were shown with at least one ad from the linked backfill account(s). Note that a single monetized pageview can include multiple ad impressions (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillImpressionsPerSession | Float | False | The ratio of backfill ad impressions to Analytics sessions (Ad Impressions / Analytics Sessions). If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillViewableImpressionsPercent | Decimal | False | The percentage of backfill ad impressions that were viewable. An impression is considered a viewable impression when it has appeared within the users' browsers and had the opportunity to be seen. If AdSense and Ad Exchange are both providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillClicks | Integer | False | The number of times backfill ads were clicked on the site. If AdSense and Ad Exchange are both providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillCTR | Decimal | False | The percentage of backfill impressions that resulted in a click on an ad. If AdSense and Ad Exchange are both providing backfill ads, this metric is the weighted average of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillRevenue | Decimal | False | The total estimated revenue from backfill ads. If AdSense and Ad Exchange are both providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillRevenuePer1000Sessions | Decimal | False | The total estimated revenue from backfill ads per 1,000 Analytics sessions. Note that this metric is based on sessions to the site and not ad impressions. If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BackfillECPM | Decimal | False | The effective cost per thousand pageviews. It is the DFP Backfill Revenue per 1,000 pageviews. If both AdSense and Ad Exchange are providing backfill ads, this metric is the sum of the two backfill accounts (DFP linking enabled and Hide DFP Revenue not enabled). | ||
BuyToDetailRate | Decimal | False | Unique purchases divided by views of product detail pages (Enhanced Ecommerce). | ||
CartToDetailRate | Decimal | False | Product adds divided by views of product details (Enhanced Ecommerce). | ||
CohortActiveUsers | Integer | False | This metric is relevant in the context of ga:cohortNthDay/ga:cohortNthWeek/ga:cohortNthMonth. It indicates the number of users in the cohort who are active in the time window corresponding to the cohort nth day/week/month. For example, for ga:cohortNthWeek = 1, number of users (in the cohort) who are active in week 1. If a request doesn't have any of ga:cohortNthDay/ga:cohortNthWeek/ga:cohortNthMonth, this metric will have the same value as ga:cohortTotalUsers. | ||
CohortAppviewsPerUser | Float | False | App views per user for a cohort. | ||
CohortAppviewsPerUserWithLifetimeCriteria | Float | False | App views per user for the acquisition dimension for a cohort. | ||
CohortGoalCompletionsPerUser | Float | False | Goal completions per user for the acquisition dimension for a cohort. | ||
CohortGoalCompletionsPerUserWithLifetimeCriteria | Float | False | Goal completions per user for a cohort. | ||
CohortPageviewsPerUser | Float | False | Pageviews per user for a cohort. | ||
CohortPageviewsPerUserWithLifetimeCriteria | Float | False | Pageviews per user for the acquisition dimension for a cohort. | ||
CohortRetentionRate | Decimal | False | Cohort retention rate. | ||
CohortRevenuePerUser | Decimal | False | Revenue per user for a cohort. | ||
CohortRevenuePerUserWithLifetimeCriteria | Decimal | False | Revenue per user for the acquisition dimension for a cohort. | ||
CohortSessionDurationPerUser | String | False | Session duration per user for a cohort. | ||
CohortSessionDurationPerUserWithLifetimeCriteria | String | False | Session duration per user for the acquisition dimension for a cohort. | ||
CohortSessionsPerUser | Float | False | Sessions per user for a cohort. | ||
CohortSessionsPerUserWithLifetimeCriteria | Float | False | Sessions per user for the acquisition dimension for a cohort. | ||
CohortTotalUsers | Integer | False | Number of users belonging to the cohort, also known as cohort size. | ||
CohortTotalUsersWithLifetimeCriteria | Integer | False | This is relevant in the context of a request which has the dimensions ga:acquisitionTrafficChannel/ga:acquisitionSource/ga:acquisitionMedium/ga:acquisitionCampaign. It represents the number of users in the cohorts who are acquired through the current channel/source/medium/campaign. For example, for ga:acquisitionTrafficChannel=Direct, it represents the number users in the cohort, who were acquired directly. If none of these mentioned dimensions are present, then its value is equal to ga:cohortTotalUsers. | ||
DbmCPA | Decimal | False | DBM Revenue eCPA (Analytics 360 only, requires integration with DBM). | ||
DbmCPC | Decimal | False | DBM Revenue eCPC (Analytics 360 only, requires integration with DBM). | ||
DbmCPM | Decimal | False | DBM Revenue eCPM (Analytics 360 only, requires integration with DBM). | ||
DbmCTR | Decimal | False | DBM CTR (Analytics 360 only, requires integration with DBM). | ||
DbmClicks | Integer | False | DBM Total Clicks (Analytics 360 only, requires integration with DBM). | ||
DbmConversions | Integer | False | DBM Total Conversions (Analytics 360 only, requires integration with DBM). | ||
DbmCost | Decimal | False | DBM Cost (Analytics 360 only, requires integration with DBM). | ||
DbmImpressions | Integer | False | DBM Total Impressions (Analytics 360 only, requires integration with DBM). | ||
DbmROAS | Decimal | False | DBM ROAS (Analytics 360 only, requires integration with DBM). | ||
DcmCPC | Decimal | False | DCM Cost Per Click (Analytics 360 only). | ||
DcmCTR | Decimal | False | DCM Click Through Rate (Analytics 360 only). | ||
DcmClicks | Integer | False | DCM Total Clicks (Analytics 360 only). | ||
DcmCost | Decimal | False | DCM Total Cost (Analytics 360 only). | ||
DcmImpressions | Integer | False | DCM Total Impressions (Analytics 360 only). | ||
DcmROAS | Decimal | False | DCM Return On Ad Spend (ROAS) (Analytics 360 only). | ||
DcmRPC | Decimal | False | DCM Revenue Per Click (Analytics 360 only). | ||
DsCPC | Decimal | False | DS Cost to advertiser per click (Analytics 360 only, requires integration with DS). | ||
DsCTR | Decimal | False | DS Click Through Rate (Analytics 360 only, requires integration with DS). | ||
DsClicks | Integer | False | DS Clicks (Analytics 360 only, requires integration with DS). | ||
DsCost | Decimal | False | DS Cost (Analytics 360 only, requires integration with DS). | ||
DsImpressions | Integer | False | DS Impressions (Analytics 360 only, requires integration with DS). | ||
DsProfit | Decimal | False | DS Profit (Analytics 360 only, requires integration with DS). | ||
DsReturnOnAdSpend | Decimal | False | DS Return On Ad Spend (Analytics 360 only, requires integration with DS). | ||
DsRevenuePerClick | Decimal | False | DS Revenue Per Click (Analytics 360 only, requires integration with DS). | ||
Hits | Integer | False | Total number of hits for the view (profile). This metric sums all hit types, including pageview, custom event, ecommerce, and other types. Because this metric is based on the view (profile), not on the property, it is not the same as the property's hit volume. | ||
InternalPromotionCTR | Decimal | False | The rate at which users clicked through to view the internal promotion (ga:internalPromotionClicks / ga:internalPromotionViews) - (Enhanced Ecommerce). | ||
InternalPromotionClicks | Integer | False | The number of clicks on an internal promotion (Enhanced Ecommerce). | ||
InternalPromotionViews | Integer | False | The number of views of an internal promotion (Enhanced Ecommerce). | ||
LocalProductRefundAmount | Decimal | False | Refund amount in local currency for a given product (Enhanced Ecommerce). | ||
LocalRefundAmount | Decimal | False | Total refund amount in local currency for the transaction (Enhanced Ecommerce). | ||
ProductAddsToCart | Integer | False | Number of times the product was added to the shopping cart (Enhanced Ecommerce). | ||
ProductCheckouts | Integer | False | Number of times the product was included in the check-out process (Enhanced Ecommerce). | ||
ProductDetailViews | Integer | False | Number of times users viewed the product-detail page (Enhanced Ecommerce). | ||
ProductListCTR | Decimal | False | The rate at which users clicked through on the product in a product list (ga:productListClicks / ga:productListViews) - (Enhanced Ecommerce). | ||
ProductListClicks | Integer | False | Number of times users clicked the product when it appeared in the product list (Enhanced Ecommerce). | ||
ProductListViews | Integer | False | Number of times the product appeared in a product list (Enhanced Ecommerce). | ||
ProductRefundAmount | Decimal | False | Total refund amount associated with the product (Enhanced Ecommerce). | ||
ProductRefunds | Integer | False | Number of times a refund was issued for the product (Enhanced Ecommerce). | ||
ProductRemovesFromCart | Integer | False | Number of times the product was removed from the shopping cart (Enhanced Ecommerce). | ||
ProductRevenuePerPurchase | Decimal | False | Average product revenue per purchase (commonly used with Product Coupon Code) (ga:itemRevenue / ga:uniquePurchases) - (Enhanced Ecommerce). | ||
QuantityAddedToCart | Integer | False | Number of product units added to the shopping cart (Enhanced Ecommerce). | ||
QuantityCheckedOut | Integer | False | Number of product units included in check out (Enhanced Ecommerce). | ||
QuantityRefunded | Integer | False | Number of product units refunded (Enhanced Ecommerce). | ||
QuantityRemovedFromCart | Integer | False | Number of product units removed from a shopping cart (Enhanced Ecommerce). | ||
RefundAmount | Decimal | False | Currency amount refunded for a transaction (Enhanced Ecommerce). | ||
RevenuePerUser | Decimal | False | The total sale revenue (excluding shipping and tax) of the transaction divided by the total number of users. | ||
SessionsPerUser | Float | False | The total number of sessions divided by the total number of users. | ||
TotalRefunds | Integer | False | Number of refunds that have been issued (Enhanced Ecommerce). | ||
TransactionsPerUser | Float | False | Total number of transactions divided by total number of users. | ||
Metric1 | Integer | False | The value of the requested custom metric-01. | ||
Metric2 | Integer | False | The value of the requested custom metric-02. | ||
Metric3 | Integer | False | The value of the requested custom metric-03. | ||
Metric4 | Integer | False | The value of the requested custom metric-04. | ||
Metric5 | Integer | False | The value of the requested custom metric-05. | ||
Metric6 | Integer | False | The value of the requested custom metric-06. | ||
Metric7 | Integer | False | The value of the requested custom metric-07. | ||
Metric8 | Integer | False | The value of the requested custom metric-08. | ||
Metric9 | Integer | False | The value of the requested custom metric-09. | ||
Metric10 | Integer | False | The value of the requested custom metric-10. | ||
Metric11 | Integer | False | The value of the requested custom metric-11. | ||
Metric12 | Integer | False | The value of the requested custom metric-12. | ||
Metric13 | Integer | False | The value of the requested custom metric-13. | ||
Metric14 | Integer | False | The value of the requested custom metric-14. | ||
Metric15 | Integer | False | The value of the requested custom metric-15. | ||
Metric16 | Integer | False | The value of the requested custom metric-16. | ||
Metric17 | Integer | False | The value of the requested custom metric-17. | ||
Metric18 | Integer | False | The value of the requested custom metric-18. | ||
Metric19 | Integer | False | The value of the requested custom metric-19. | ||
Metric20 | Integer | False | The value of the requested custom metric-20. | ||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves Goal Completion data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses Date instead of the default GoalCompletionLocation dimension:
SELECT Date, GoalStartsAll, GoalCompletionsAll, GoalValueAll, GoalValuePerSession, GoalConversionRateAll, GoalAbandonsAll, GoalAbandonRateAll FROM GoalCompletionsFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will find Goal Completions for a specific Goal Completion Location:
SELECT GoalCompletionLocation, GoalCompletionsAll FROM GoalCompletions WHERE GoalCompletionLocation = '/mypath'All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM GoalCompletion WHERE StartDate = '90daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT GoalCompletionLocation, GoalStartsAll, GoalCompletionsAll, GoalValueAll, GoalValuePerSession, GoalConversionRateAll, GoalAbandonsAll, GoalAbandonRateAll FROM GoalCompletions
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
GoalCompletionLocation | String | True | True | The page path or screen name that matched any destination-type goal completion. | |
GoalStartsAll | Integer | False | True | The total number of starts for all goals defined for your profile. | |
GoalCompletionsAll | Integer | False | True | The total number of completions for all goals defined for your profile. | |
GoalValueAll | Double | False | True | The total numeric value for all goals defined for your profile. | |
GoalValuePerSession | Double | False | True | The average goal value of a session on your property. | |
GoalConversionRateAll | Double | False | True | The percentage of sessions that resulted in a conversion to at least one of your goals. | |
GoalAbandonsAll | Integer | False | True | The overall number of times users started goals without actually completing them. | |
GoalAbandonRateAll | Double | False | True | The rate at which goals were abandoned. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
A Goals resource describes a goal for one of a user's profiles.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Id [KEY] | String | The Goal Id. | |||
WebPropertyId [KEY] | String | The Web property Id to which this goal belongs. The web property Id is of the form UA-XXXXX-YY. | |||
Kind | String | The Resource type for Analytics profile. | |||
SelfLink | String | The Link for this goal. | |||
AccountId | String | The Account Id to which this goal belongs. | |||
InternalWebPropertyId | String | The Internal Id for the web property to which this goal belongs. | |||
ProfileId | String | The View (Profile) Id to which this goal belongs. | |||
Name | String | The Goal name. | |||
Active | Boolean | Determines whether this goal is active. | |||
Value | Double | The Goal value. | |||
Type | String | The Goal type. Possible values are URL_DESTINATION, VISIT_TIME_ON_SITE, VISIT_NUM_PAGES, and EVENT. | |||
Created | Datetime | The Time this goal was created. | |||
Updated | Datetime | The Time this goal was last modified. | |||
ParentLink | String | The Parent link for a goal. Points to the view (profile) to which this goal belongs. | |||
UrlDestinationDetails | String | Details for the goal of the type URL_DESTINATION. | |||
VisitTimeOnSiteDetails | String | Details for the goal of the type VISIT_TIME_ON_SITE. | |||
VisitNumPagesDetails | String | The Value used for this comparison. | |||
EventDetails | String | Details for the goal of the type EVENT. |
Lists all Profiles to which the user has access.
The Profiles table exposes all profiles that the user has access to. The AccountId and WebPropertyId fields are available for filtering in the WHERE clause with = operator. For example:
SELECT * FROM Profiles WHERE AccountId = '123456'
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Id [KEY] | String | Profile Id. | |||
Kind | String | The Resource type for Analytics profile. | |||
SelfLink | String | Link for this profile. | |||
AccountId | String | The Account Id to which this profile belongs. | |||
WebPropertyId | String | The Web property Id of the form UA-XXXXX-YY to which this profile belongs. | |||
InternalWebPropertyId | String | The Internal Id for the Web property to which this profile belongs. | |||
Name | String | Name of this profile. | |||
Currency | String | The currency type associated with this profile. | |||
Timezone | String | The Time zone for which this profile has been configured. | |||
WebsiteURL | String | Website URL for this profile. | |||
DefaultPage | String | The Default page for this profile. | |||
ExcludeQueryParameters | String | The query parameters that are excluded from this profile. | |||
SiteSearchQueryParameters | String | The site search query parameters for this profile. | |||
SiteSearchCategoryParameters | String | Site search category parameters for this profile. | |||
Type | String | Profile type. | |||
Permissions | String | All the permissions that the user has for this profile. These include any implied permissions. | |||
Created | Datetime | The Time this profile was created. | |||
Updated | Datetime | The Time this profile was last modified. | |||
eCommerceTracking | Boolean | Indicates whether e-commerce tracking is enabled for this profile. | |||
ParentLink | String | The Parent link for this profile. Points to the Web property to which this profile belongs. | |||
ChildLink | String | The Child link for this profile. Points to the list of goals for this profile. |
Lists all Segments to which the user has access.
The Segments table exposes all segments that the user has access to. Filters are not available in the WHERE clause for this table but LIMIT is supported.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Id [KEY] | String | The Segment Id. | |||
Kind | String | The Resource type for Analytics segment. | |||
SelfLink | String | The Link for this segment. | |||
SegmentID | String | The Segment Id. Can be used with the segment parameter in Data Feed. | |||
Name | String | The Segment name. | |||
Definition | String | The Segment definition. | |||
Type | String | The Type for a segment. Possible values are BUILT_IN or CUSTOM. | |||
Created | Datetime | The Time the segment was created. | |||
Updated | Datetime | The Time the segment was last modified. |
Retrieves internal Site Content data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses PageTitle instead of the default PagePath dimension:
SELECT PageTitle, PageViews, UniquePageviews, AvgTimeOnPage, Entrances, BounceRate, EntranceRate, Exits, PageValue, TimeOnPage FROM SiteContentFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return the Page Paths in order of most Entrances to least:
SELECT PagePath, Entrances FROM SiteContent ORDER BY Entrances DESCAll reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM SiteContent WHERE StartDate = '90daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT PagePath, PageViews, UniquePageviews, AvgTimeOnPage, Entrances, BounceRate, EntranceRate, Exits, PageValue, TimeOnPage, ExitRate FROM SiteContent
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
Browser | String | True | The names of browsers used by users to your website. For example, Internet Explorer or Firefox. | ||
PagePath | String | True | True | A page on your website specified by path and/or query parameters. Use in conjunction with host name to get the full URL of the page. | |
PageTitle | String | True | The title of a page. Remember that multiple pages might have the same PageTitle. | ||
PageViews | Integer | False | True | The total number of page views for your property. | |
UniquePageviews | Integer | False | True | The number of different (unique) pages within a session. This takes into both the PagePath and PageTitle to determine uniqueness. | |
AvgTimeOnPage | Double | False | True | The average amount of time users spent viewing this page or a set of pages. | |
Entrances | Integer | False | True | The number of entrances to your property, measured as the first page view in a session. Typically used with LandingPagePath. | |
BounceRate | Double | False | True | The percentage of single-page sessions. | |
EntranceRate | Double | False | True | The percentage of page views in which this page was the entrance. | |
Exits | Integer | False | True | The number of exits from your property. | |
PageValue | Double | False | True | The average value of this page or set of pages. Page Value is the sum of TransactionRevenue and GoalValueAll, columns in the Ecommerce table, divided by UniquePageviews (for the page or set of pages). | |
TimeOnPage | Double | False | True | How long a user spent on a particular page in seconds, calculated by subtracting the initial view time for a particular page from the initial view time for a subsequent page. Thus, this metric does not apply to exit pages for your property. | |
ExitRate | Double | False | True | The percentage of exits from your property that occurred out of the total page views. | |
StartDate | String | The Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | The End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves internal Site Search data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses SearchStartPage instead of the default SearchKeyword dimension:
SELECT SearchStartPage, SearchSessions, PercentSessionsWithSearch, SearchUniques, SearchResultViews, AvgSearchResultViews, SearchExits, PercentSearchRefinements, SearchDuration, AvgSearchDuration, AvgSearchDepth FROM SiteSearchFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return the number of sessions for a 'software' Search Category:
SELECT SearchCategory, SearchSessions FROM SiteSearch WHERE SearchCategory = 'software'All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM SiteSearch WHERE StartDate = '90daysAgo' AND EndDate = 'Today'Because there are more than 10 Metrics available for the SiteSearch table, a query that selects all columns only returns the default Metrics for this table (see columns marked as default Metrics below). If you need to select other Metrics, select them explicitly instead of using '*'. The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or set in the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT SearchKeyword, SearchSessions, PercentSessionsWithSearch, SearchUniques, SearchResultViews, AvgSearchResultViews, SearchExits, PercentSearchRefinements, SearchDuration, AvgSearchDepth FROM SiteSearch
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
SearchKeyword | String | True | True | Search terms used by users within your property. | |
SearchCategory | String | True | The categories used for the internal search if you have this enabled for your profile. For example, product categories, such as electronics, furniture, or clothing. | ||
SearchStartPage | String | True | A page where the user initiated an internal search on your property. | ||
SearchSessions | Integer | False | True | The total number of sessions that included an internal search. | |
PercentSessionsWithSearch | Double | False | True | The percentage of sessions with search. | |
SearchUniques | Integer | False | True | The total number of unique keywords from internal searches within a session. | |
SearchResultViews | Integer | False | True | The number of times a search result page was viewed after performing a search. | |
AvgSearchResultViews | Double | False | True | The average number of times people viewed a search results page after performing a search. | |
SearchExits | Integer | False | True | The number of exits on your site that occurred following a search result from your internal search feature. | |
SearchExitRate | Double | False | The percentage of searches that resulted in an immediate exit from your property. | ||
SearchRefinements | Integer | False | The total number of times a refinement (transition) occurs between internal search keywords within a session. | ||
PercentSearchRefinements | Double | False | True | The percentage of number of times a refinement (i.e., transition) occurs between internal search keywords within a session. | |
SearchDuration | Double | False | True | The session duration on your property where a use of your internal search feature occurred. | |
AvgSearchDuration | Double | False | The average amount of time people spent on your property after searching. | ||
SearchDepth | Integer | False | The average number of subsequent page views made on your property after a use of your internal search feature. | ||
AvgSearchDepth | Double | False | True | The average number of pages people viewed after performing a search on your property. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves internal Site Speed data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses PagePath instead of the default Browser dimension:
SELECT PagePath, AvgPageLoadTime, AvgRedirectionTime, AvgDomainLookupTime, AvgServerConnectionTime, AvgServerResponseTime, AvgPageDownloadTime FROM SiteSpeedFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return Page Title for all pages with an average load time of more than 1.5 on mobile devices:
SELECT DeviceCategory, PageTitle, AvgPageLoadTime FROM SiteSpeed WHERE AvgPageLoadTime > 1.5 AND DeviceCategory = 'mobile'All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM SiteSpeed WHERE StartDate = '90daysAgo' AND EndDate = 'Today'Because there are more than 10 Metrics available for the SiteSpeed table, a query that selects all columns only returns the default Metrics for this table (see columns marked as default Metrics below). If you need to select other Metrics, select them explicitly instead of using '*'. The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT Browser, AvgPageLoadTime, AvgRedirectionTime, AvgDomainLookupTime, AvgServerConnectionTime, AvgServerResponseTime, AvgPageDownloadTime FROM SiteSpeed
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
Browser | String | True | True | The names of browsers used by users to your website. For example, Internet Explorer or Firefox. | |
DeviceCategory | String | True | The type of device: desktop, tablet, or mobile. | ||
PagePath | String | True | A page on your website specified by path and/or query parameters. Use in conjunction with host name to get the full URL of the page. | ||
PageTitle | String | True | The title of a page. Remember that multiple pages might have the same PageTitle. | ||
AvgPageLoadTime | Double | False | True | The average amount of time in seconds it takes for pages from the sample set to load, from initiation of the page view (e.g., a click on a page link) to load completion in the browser. | |
AvgRedirectionTime | Double | False | True | The average amount of time in seconds spent in redirects before fetching this page. If there are no redirects, the value for this metric is expected to be 0. | |
AvgDomainLookupTime | Double | False | True | The average amount of time in seconds spent in DNS lookup for this page. | |
AvgServerConnectionTime | Double | False | True | The average amount of time in seconds spent in establishing the TCP connection for this page. | |
AvgServerResponseTime | Double | False | True | The average amount of time in seconds your server takes to respond to a user request, including the network time from the location of the user to your server. | |
AvgPageDownloadTime | Double | False | True | The average amount of time in seconds to download this page. | |
PageLoadTime | Integer | False | The amount of time (in milliseconds) it takes for pages from the sample set to load from initiation of the page view (e.g., a click on a page link) to load completion in the browser. | ||
PageLoadSample | Integer | False | The sample set, or count of page views used to calculate the average page load time. | ||
DomainLookupTime | Integer | False | The total amount of time (in milliseconds) spent in DNS lookup for this page among all samples. | ||
PageDownloadTime | Integer | False | The total amount of time (in milliseconds) to download this page among all samples. | ||
RedirectionTime | Integer | False | The total amount of time (in milliseconds) spent in redirects before fetching this page among all samples. If there are no redirects, the value for this metric is expected to be 0. | ||
ServerConnectionTime | Integer | False | The total amount of time (in milliseconds) spent in establishing the TCP connection for this page among all samples. | ||
ServerResponseTime | Integer | False | The total amount of time (in milliseconds) your server takes to respond to a user request among all samples, including the network time from the location of the user to your server. | ||
SpeedMetricsSample | Integer | False | The sample set, or count, of page views used to calculate the averages for site speed metrics. This metric is used in all site speed average calculations. | ||
DomInteractiveTime | Integer | False | The time the browser takes (in milliseconds) to parse the document (DOMInteractive), including the network time from the location of the user to your server. At this time, the user can interact with the Document Object Model even though it is not fully loaded. | ||
DomContentLoadedTime | Integer | False | The time the browser takes (in milliseconds) to parse the document and execute deferred and parser-inserted scripts (DOMContentLoaded), including the network time from the location of the user to your server. Parsing of the document is finished and the Document Object Model is ready, but referenced style sheets, images, and subframes may not be finished loading. This event is often the starting point for JavaScript framework execution; e.g., JQuery's onready() callback. | ||
DomLatencyMetricsSample | Integer | False | The sample set, or count, of page views used to calculate the averages for site speed DOM metrics. This metric is used in the AvgDomContentLoadedTime and AvgDomInteractiveTime calculations. | ||
AvgDomInteractiveTime | Double | False | The average time in seconds, including the network time from the location of the user to your server, that it takes the browser to parse the document and execute deferred and parser-inserted scripts. | ||
AvgDomContentLoadedTime | Double | False | The average time in seconds it takes the browser to parse the document. | ||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. |
Retrieves all Traffic data.
Google Analytics only allows up to 10 Metrics and 7 Dimensions in a single query. Therefore, when issuing a query that selects all columns, only the default Metric columns will be selected for tables with more than 10 Metrics. The default Dimensions will be used unless you explicitly select other dimension columns. The following query uses Date instead of the default Source and Medium dimensions:
SELECT Date, Sessions, PercentNewSessions, NewUsers, BounceRate, PageviewsPerSession, AvgSessionDuration, GoalConversionRateAll, Transactions, RevenuePerTransaction, TransactionRevenue FROM TrafficFilters can also be used in the WHERE clause. Dimension fields support the =, !=, LIKE, and NOT LIKE operators. Metric fields support =, !=, >, >=, <, and <= operators. This query will return the number of Sessions using Google Chrome:
SELECT Browser, Sessions FROM Traffic WHERE Browser LIKE '%Chrome%'All reports in Google Analytics must cover a specific date range. The default behavior is to pull the last month of data if the StartDate and EndDate inputs are left unset. To override this behavior, the values can be set directly in the query. For example:
SELECT * FROM Traffic WHERE StartDate = '90daysAgo' AND EndDate = 'Today'The default dimension for the table will be used unless another dimension is specified in the select columns, the DefaultFilter, or the Dimensions column in the WHERE clause. See Retrieving Google Analytics Data for more information about SELECT * queries. The following queries return the same results:
SELECT Source, Medium, Sessions, Users, PercentNewSessions, NewUsers, BounceRate, PageviewsPerSession, AvgSessionDuration, GoalConversionRateAll, Transactions, TransactionRevenue FROM Traffic
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Language | String | True | The language provided by the HTTP Request for the browser. Values are given as an ISO-639 code. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
Browser | String | True | The names of browsers used by users to your website. For example, Internet Explorer or Firefox. | ||
OperatingSystem | String | True | The operating system used by your users. For example, Windows, Linux , Macintosh, iPhone, iPod. | ||
DeviceCategory | String | True | The type of device: desktop, tablet, or mobile. | ||
ChannelGrouping | String | True | The channel grouping the data is returned for. | ||
Source | String | True | True | The source of referrals to your property | |
Medium | String | True | True | The type of referrals to your property. | |
UserType | String | True | A boolean indicating if a user is new or returning. | ||
LandingPagePath | String | True | The first page in a user session or landing page. | ||
Campaign | String | True | When using manual campaign tracking, this is the value of the utm_campaign campaign tracking parameter. When using AdWords autotagging, this value is the name(s) of the online ad campaign that you use for your property. Otherwise, this value is: not set. | ||
SocialNetwork | String | True | The Name of the social network. This can be related to the referring social network for traffic sources or to the social network for social data hub activities. | ||
Sessions | Integer | False | True | Counts the total number of sessions. | |
Users | Integer | False | True | The Total number of users to your property for the requested time period. | |
PercentNewSessions | Double | False | True | The percentage of sessions by people who had never visited your property before. | |
NewUsers | Integer | False | True | The number of users whose visit to your property was marked as a first-time session. | |
BounceRate | Double | False | True | The percentage of single-page session. | |
PageviewsPerSession | Double | False | True | The average number of pages viewed during a session on your property. | |
AvgSessionDuration | Double | False | True | The average duration of user sessions represented in total seconds. | |
GoalConversionRateAll | Double | False | True | The percentage of sessions that resulted in a conversion to at least one of your goals. | |
Transactions | Integer | False | True | The total number of transactions. | |
RevenuePerTransaction | Decimal | False | The average revenue for an e-commerce transaction. | ||
TransactionRevenue | Decimal | False | True | The total sale revenue provided in the transaction, excluding shipping and tax. | |
TransactionRevenuePerSession | Decimal | False | The Average transaction revenue for a session on your property. | ||
StartDate | String | The Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | The End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. | |||
CohortTypes | String | Available only when using the V4 API. A comma-separated list of cohort types. The default value is FIRST_VISIT_DATE | |||
CohortStartDates | Date | Available only when using the V4 API. A comma-separated list of cohort start dates. | |||
CohortEndDates | Date | Available only when using the V4 API. A comma-separated list of cohort end dates. | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. | |||
Segments | String | Segments the data returned for your request. Either a SegmentId or a custom segment. | |||
Profile | Integer | The Profile Id or website URL to retrieve data from. |
List information on a user's activity.
This view requires column 'ClientID' to be specified in order to execute a query. Unfortunately, we don't expose a 'Clients' or 'Users' table (or equivalent) to display client IDs. This is an API limitation.
Because of this, the only way to retrieve a ClientID is by following the below steps:
Client IDs will be displayed under column 'Client Id'. Use one of those values when building the query in the Cloud, e.g.:
SELECT * FROM UserActivity WHERE ClientId = '194067010.1581918826'
Note: Profile is also required for this table.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ClientId | String | The Client Id or User Id associated with the user. This can be found in the 'User Explorer' section of Google Analytics' UI. | |||
ActivityTime | String | Timestamp of the activity. | |||
Source | String | The source of referrals. For manual campaign tracking, it is the value of the utm_source campaign tracking parameter. For AdWords autotagging, it is google. If you use neither, it is the domain of the source (e.g., document.referrer) referring the users. It may also contain a port address. If users arrived without a referrer, its value is (direct). | |||
Medium | String | The type of referrals. For manual campaign tracking, it is the value of the utm_medium campaign tracking parameter. For AdWords autotagging, it is cpc. If users came from a search engine detected by Google Analytics, it is organic. If the referrer is not a search engine, it is referral. If users came directly to the property and document.referrer is empty, its value is (none). | |||
ChannelGrouping | String | The Channel Group associated with an end user's session for this View (defined by the View's Channel Groupings). | |||
Campaign | String | For manual campaign tracking, it is the value of the utm_campaign campaign tracking parameter. For AdWords autotagging, it is the name(s) of the online ad campaign(s) you use for the property. If you use neither, its value is (not set). | |||
Keyword | String | For manual campaign tracking, it is the value of the utm_term campaign tracking parameter. For AdWords traffic, it contains the best matching targeting criteria. For the display network, where multiple targeting criteria could have caused the ad to show up, it returns the best matching targeting criteria as selected by Ads. This could be display_keyword, site placement, boomuserlist, user_interest, age, or gender. Otherwise its value is (not set). | |||
Hostname | String | The hostname from which the tracking request was made. | |||
LandingPagePath | String | The first page in users' sessions, or the landing page. | |||
ActivityType | String | Type of this activity. | |||
Event | String | This field contains all the details pertaining to an event. It is set if activityType equals EVENT. | |||
PageView | String | This is set if activityType equals PAGEVIEW. This field contains all the details about the visitor and the page that was visited. | |||
AppView | String | This is set if activityType equals SCREEN_VIEW. | |||
Ecommerce | String | This is set if activityType equals ECOMMERCE. | |||
Goals | String | This is set if activityType equals GOAL. | |||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
SamplesReadCounts | String | A comma-separated list of samples read counts when the response data is sampled. | |||
SamplingSpaceSizes | String | A comma-separated list of samples space sizes counts when the response data is sampled. |
Lists Web Properties to which the user has access.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Id [KEY] | String | The Web property Id. | |||
Kind | String | The Resource type for Analytics web property. | |||
SelfLink | String | The Link for this web property. | |||
AccountId | String | Account Id to which this web property belongs. | |||
InternalWebPropertyId | String | The Internal Id for the web property. | |||
DefaultProfileId | String | The Default view (profile) Id. | |||
IndustryVertical | String | The industry vertical/category selected for this web property | |||
Level | String | The Level for this web property. | |||
Name | String | The Name of this web property. | |||
ProfileCount | Integer | The View (Profile) count for this web property. | |||
WebsiteURL | String | The Website URL for this web property. | |||
Permissions | String | All the permissions that the user has for this web property. These include any implied permissions. | |||
Created | Datetime | The Time this web property was created. | |||
Updated | Datetime | The Time this web property was last modified. | |||
ParentLink | String | The Parent link for this profile. Points to the Account to which this profile belongs. | |||
ChildLink | String | The Child link for this web property. Points to the list of views (profiles) for this web property. |
Stored procedures are function-like interfaces that extend the functionality of the Cloud beyond simple SELECT operations with Google Analytics.
Stored procedures accept a list of parameters, perform their intended function, and then return any relevant response data from Google Analytics, along with an indication of whether the procedure succeeded or failed.
Name | Description |
CreateCustomSchema | Creates a custom schema file based on the specified Dimensions and Metrics. |
Creates a custom schema file based on the specified Dimensions and Metrics.
Creates a custom schema file based on the specified Dimensions and Metrics.
A custom schema may be used for a more tailored approach to your data. Custom options may include comma-separated lists for specific data.
Name | Type | Required | Description |
TableName | String | True | The name for the new table. |
Description | String | False | An optional description for the table. |
WriteToFile | String | False | Whether to write to an output file. Defaults to true, must be set to false to write to FileStream or FileData. |
Dimensions | String | False | A comma-separated list of dimensions to include in the schema file. Enter ColumnAlias=ColumnName Example: Alias1=Column1,Alias2=column2. Here is a list of the possible values: https://ga-dev-tools.web.app/dimensions-metrics-explorer/ |
Metrics | String | True | A comma-separated list of metrics to include in the schema file. Enter ColumnAlias=ColumnName Example: Alias1=Column1,Alias2=column2. Here is a list of the possible values: https://ga-dev-tools.web.app/dimensions-metrics-explorer/ |
Profile | String | False | The Profile Id or website URL to retrieve data from. This acts as the Report's default Profile when no value is specified for either the Profile pseudo-column or the Profile connection property. |
Name | Type | Description |
Success | String | Whether the schema was created successfully. |
SchemaFile | String | The generated schema file. |
FileData | String | The generated schema encoded in base64. Only returned if WriteToFile set to false and FileStream is not set. |
The CData Cloud models the Google Analytics 4 API as relational tables, views, and stored procedures. The provided tables give you an overview of your account information and the profiles available for Google Analytics queries. Google Analytics supports the queryting of Dimensions and Metrics in a large number of arrangements. Some sample views are provided based on common Google Analytics reports.
You can also create your own custom views based on any combination of Dimensions and Metrics you need. API limitations and requirements are documented in this section; you can use the SupportEnhancedSQL feature, set by default, to circumvent most of these limitations. However, there is a strict limit of nine dimensions and ten metrics per query, unless otherwise stated in the specfic table or view pages.
To use Google Analytics 4 Data Model, set Schema to GoogleAnalytics4.
Views are tables that cannot be modified, such as Accounts, Properties, Events, Acquisitions, and Engagement. Typically, data that are read-only and cannot be updated are shown as views. Two types of views are made available:
Additional predefined date fields are available:
month = '2022-05-01'NOTE: The default time interval for views is 30 days.
Aggregation
Aggregation is the process of reducing and summarizing data. You can apply aggregation at multiple levels:
The following examples show the syntax of aggregation queries:
SELECT Date,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18' SELECT Hour,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18' SELECT Day,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18' SELECT Week,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18' SELECT Month,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18' SELECT Year,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'Some comments about the aggregation code examples:
NOTE: choosing "Date" as a metric overrides any other date metric you select. Only daily data is returned.
Stored Procedures are function-like interfaces to the data source. You can use these to search, update, and modify information in the data source.
Fully Qualified queries supports both OR and And operator together. OR operator is only supported with same columns if it is used together with AND for filtering dimensions or metrics. For Example, the below query might give unexpected result:
SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' And [EndDate] = '2023-03-22' And [PagePath] LIKE '%as' OR [Country] LIKE 'US'Given below are few valid queries:
SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' And [EndDate] = '2023-03-22' And ([Country] LIKE 'US' Or [Country] LIKE '%In')
SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' And [EndDate] = '2023-03-22' Or [PagePath] LIKE '%as'
SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' Or [PagePath] LIKE 'A' Or Country LIKE '%In'
SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' AND Country LIKE '%In'
SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' AND (Country LIKE 'India' OR Country LIKE '%US')
SELECT * FROM [Tech] WHERE [StartDate] = '2021-01-01' AND [EndDate] = '2021-05-18' AND NewUsers >= 26 AND NewUsers < 35 AND (Browser IN ('Chrome', 'Edge') OR Browser = 'Edge')
SELECT * FROM [TechDeviceModelReport] WHERE [Date] >= '2020-05-13' AND [Date] <= '2023-06-13' AND DeviceModel != '(not set)' AND DeviceModel != '(test)' AND (NewUsers = 15 OR NewUsers = 20)
SELECT * FROM Tech WHERE StartDate = '2017-01-01' AND EndDate = '2023-05-02' and CONTAINS (Browser, 'ed') or CONTAINS (Browser, 'ch')
Views are similar to tables in the way that data is represented; however, views are read-only.
Queries can be executed against a view as if it were a normal table.
Name | Description |
Accounts | Lists all Accounts to which the user has access. |
AccountSummaries | Lists summaries of all Accounts to which the user has access. |
Acquisitions | A base view that retrieves Acquisitions data. |
AcquisitionsFirstUserCampaignReport | A predefined view that retrieves Acquisitions first user Campaign data. |
AcquisitionsFirstUserGoogleAdsAdGroupNameReport | A predefined view that retrieves user Acquisitions first user Google Ads ad group name data. |
AcquisitionsFirstUserGoogleAdsNetworkTypeReport | A predefined view that retrieves Acquisitions first user Google Ads ad network type platform data. |
AcquisitionsFirstUserMediumReport | A predefined view that retrieves Acquisitions first user medium data. |
AcquisitionsFirstUserSourceMediumReport | Usage information for the operation AcquisitionsFirstUserSourceMediumReport.rsd. |
AcquisitionsFirstUserSourcePlatformReport | A predefined view that retrieves Acquisitions first user source platform data. |
AcquisitionsFirstUserSourceReport | A predefined view that retrieves Acquisitions first user source data. |
AcquisitionsSessionCampaignReport | A predefined view that retrieves Acquisitions session campaign report data. |
AcquisitionsSessionDefaultChannelGroupingReport | A predefined view that retrieves Acquisitions session default channel grouping report data. |
AcquisitionsSessionMediumReport | A predefined view that retrieves Acquisitions session medium report data. |
AcquisitionsSessionSourceMediumReport | A predefined view that retrieves Acquisitions session source medium report data. |
AcquisitionsSessionSourcePlatformReport | A predefined view that retrieves Acquisitions session source platform report data. |
AcquisitionsSessionSourceReport | A predefined view that retrieves Acquisitions session source report data. |
ActiveUsers | A base view that retrieves Active Users data. |
DemographicAgeReport | A predefined view that retrieves Demographics UserAgeBracket data. |
DemographicCityReport | A predefined view that retrieves Demographics City data. |
DemographicCountryReport | A predefined view that retrieves Demographics Country data. |
DemographicGenderReport | A predefined view that retrieves Demographics UserGender data. |
DemographicInterestsReport | A predefined view that retrieves Demographics BrandingInterest data. |
DemographicLanguageReport | A predefined view that retrieves Demographics Language data. |
DemographicRegionReport | A predefined view that retrieves Demographics Region data. |
Demographics | A base view that retrieves Demographics data. |
EcommPurchasesItemBrandReport | A predefined view that retrieves Ecommerce purchase item brand data. |
EcommPurchasesItemCategory2Report | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemCategory3Report | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemCategory4Report | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemCategory5Report | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemCategoryReport | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemCategoryReportCombined | A predefined view that retrieves Ecommerce purchase item category data. |
EcommPurchasesItemIdReport | A predefined view that retrieves Ecommerce purchase item data. |
EcommPurchasesItemNameReport | A predefined view that retrieves Ecommerce purchase item data. |
Engagement | A base view that retrieves Engagement data |
EngagementContentGroupReport | A predefined view that retrieves Engagement Content Group Report data. |
EngagementConversionsReport | A predefined view that retrieves Engagement conversions data. |
EngagementEventsReport | A predefined view that retrieves Engagement events data. |
EngagementPagesPathReport | A predefined view that retrieves Engagement Pages path report data. |
EngagementPagesTitleAndScreenClassReport | A predefined view that retrieves Engagement Pages title and screen class data. |
EngagementPagesTitleAndScreenNameReport | A predefined view that retrieves Engagement Pages Title And ScreenName data. |
Events | A base view that retrieves Event data |
GamesReporting | A base view that retrieves Games Reporting data. |
GlobalAccessObject | Retrieves data for all the available dimensions and metrics. |
MetaData | Retrieves metadata information for standard and custom dimensions or metrics. |
Monetization | A base view that retrieves Monetization data. |
MonetizationPublisherAdsAdFormatReport | A predefined view that retrieves publisher ads page ad format data. |
MonetizationPublisherAdsAdSourceReport | A predefined view that retrieves publisher ads ad source data. |
MonetizationPublisherAdsAdUnitReport | A predefined view that retrieves publisher ads ad unit data. |
MonetizationPublisherAdsPagePathReport | A predefined view that retrieves publisher ads page path data. |
Properties | Lists all Properties to which the user has access. |
PropertiesDataStreams | Lists all data streams under a property to which the user has access. Attribute Parent (e.g: 'properties/123') or Name (e.g: 'properties/123/webDataStreams/456') is required to query the table. |
PropertiesFireBaseLinks | Lists all FirebaseLinks on a property to which the user has access. |
PropertiesGoogleAdsLinks | Lists all GoogleAdsLinks on a property to which the user has access. |
Tech | A base view that retrieves Tech data. |
TechAppVersionReport | A predefined view that retrieves Tech App Version data. |
TechBrowserReport | A predefined view that retrieves Tech Browser data. |
TechDeviceCategoryReport | A predefined view that retrieves Tech Device Category data. |
TechDeviceModelReport | A predefined view that retrieves Tech Device Model data. |
TechOSSystemReport | A predefined view that retrieves Tech os system data. |
TechOSVersionReport | A predefined view that retrieves Tech Os version data. |
TechPlatformDeviceCategoryReport | A predefined view that retrieves Tech platform device category data. |
TechPlatformReport | A predefined view that retrieves Tech platform data. |
TechScreenResolutionReport | A predefined view that retrieves Tech Screen Resolution data. |
Lists all Accounts to which the user has access.
The Accounts table exposes every account the user has access to. The provider uses the GoogleAnalytics4 API to process WHERE clause conditions built with the Name column, which supports the = operator.
The following query is processed server-side:
SELECT * FROM Accounts WHERE Name = 'accounts/54516992'The rest of the filter is executed client-side within the provider.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
CreateTime | Datetime | Time the account was created | |||
DisplayName | String | display name for the account | |||
Name | String | Account name | |||
RegionCode | String | Country for the account | |||
UpdateTime | Datetime | Time the account was last modified |
Lists summaries of all Accounts to which the user has access.
The AccountSummaries table exposes summaries of all accounts accessible by the caller.
The following query is processed server-side:
SELECT * FROM AccountSummaries
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Account | String | Account name referred to by this account summary. | |||
DisplayName | String | display name for the account referred to by this account summary. | |||
Name | String | Account summary name. | |||
Propertysummaries | String | Summaries for child accounts of the specific account. |
A base view that retrieves Acquisitions data.
Retrieves data for Acquisitions report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions.
The following is an example query:
SELECT Conversions, NewUsers FROM Acquisitions
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, FirstGroupCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM Acquisitions
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
FirstUserGoogleAdsAdGroupName | String | True | The Ad Group Name in Google Ads that first acquired the user. | ||
FirstUserGoogleAdsAdNetworkType | String | True | The advertising network that first acquired the user. | ||
FirstUserCampaignName | String | True | Name of the marketing campaign that first acquired the user. | ||
FirstUserCreativeId | String | True | The campaign creative ID that first acquired the users. | ||
FirstUserMedium | String | True | True | The medium that first acquired the user to the website or app. | |
FirstUserSource | String | True | The source that first acquired the user to the website or app. | ||
SessionCampaignName | String | True | Campaign that referred the user's session. | ||
SessionDefaultChannelGrouping | String | True | Channel groupings are rule-based definitions of your traffic sources. These default system definitions reflect Analytics' current view of what constitutes each channel. | ||
SessionMedium | String | True | Channel that referred the user's session. | ||
SessionSource | String | True | The source that initiated a session on your website or app. | ||
EventName | String | True | The name of the event. | ||
BrandingInterest | String | True | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. | ||
Country | String | True | Country from which user activity originated. | ||
City | String | True | City from which user activity originated. | ||
Language | String | True | Language setting for the device from which activity originated. | ||
UserAgeBracket | String | True | User age brackets. | ||
UserGender | String | True | User gender. | ||
Region | String | True | Geographic region from which activity originated. | ||
UnifiedScreenClass | String | True | The page title (web) or screen class (app) on which the event was logged. | ||
PagePath | String | True | The portion of the URL between the hostname and query string for web. | ||
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views. | |
EngagedSessionsPerUser | Decimal | False | True | Average number of engaged sessions per user. | |
EventCount | Integer | False | True | The count of events. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Sessions | Integer | False | True | The number of sessions that began on the site or app. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users device. | |
ScreenPageViews | Integer | False | False | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
EventCountPerUser | Decimal | False | False | Average number of events triggered by each user. | |
SessionsPerUser | Decimal | False | False | The average number of sessions per user (Sessions divided by Active Users). | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user Campaign data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserCampaignReport
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserCampaignName | String | True | True | The Name of the marketing campaign that first acquired the user. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves user Acquisitions first user Google Ads ad group name data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserGoogleAdsAdGroupName | String | True | True | The Ad Group Name in Google Ads that first acquired the user. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user Google Ads ad network type platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE FirstUserGoogleAdsNetworkType = 'test' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE PropertyId = 342020667 AND FirstUserGoogleAdsNetworkType = 'test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserGoogleAdsAdNetworkType | String | True | True | The source platform that first acquired the user. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user medium data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserMediumReport WHERE FirstUserMedium = 'test' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date = '20221115' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE PropertyId = 342020667 AND FirstUserMedium = 'test' AND Date = '01/05/2023'' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserMediumReport WHERE FirstUserMedium = 'test'
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserMedium | String | True | True | The medium that first acquired the user of the website or app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
Usage information for the operation AcquisitionsFirstUserSourceMediumReport.rsd.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date = '01/05/2023'' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourceMediumReport
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserSource | String | True | True | The source that first acquired the user to the website or app. | |
FirstUserMedium | String | True | True | The medium that first acquired the user to the website or app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user source platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE FirstUserSourcePlatform = 'Test' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE PropertyId = 342020667 AND FirstUserSourcePlatform = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourcePlatformReport WHERE FirstUserSourcePlatform = 'Test'
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserSourcePlatform | String | True | True | The source platform that first acquired the user. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user source data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsFirstUserSourceReport WHERE FirstUserSource = '(direct)' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE PropertyId = 342020667 AND FirstUserSource = '(direct)' AND Date = '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourceReport WHERE FirstUserSource = '(direct)'
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
FirstUserSource | String | True | True | The source that first acquired the user of the website or app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session campaign report data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE SessionDefaultChannelGrouping = 'Direct' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE PropertyId = 342020667 AND SessionDefaultChannelGrouping = 'Direct' AND Date = '01/05/2023' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE SessionDefaultChannelGrouping = 'Direct'
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionCampaignName | String | True | True | Campaign that referred the user | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Sessions | Integer | False | True | The number of sessions that began on the site or app. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session default channel grouping report data.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionDefaultChannelGrouping | String | True | True | Channel groupings are rule-based definitions of your traffic sources. These default system definitions reflect Analytics current view of what constitutes each channel. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session medium report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsSessionMediumReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsSessionMediumReport WHERE SessionMedium = 'test' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsSessionMediumReport WHERE PropertyId = 342020667 AND SessionMedium = 'test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsSessionMediumReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionMediumReport WHERE SessionMedium = 'test'
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionMedium | String | True | True | The Channel that referred the user | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Sessions | Integer | False | True | The number of sessions that began on the site or app. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source medium report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourceMediumReport
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionMedium | String | True | True | Channel that referred the user | |
SessionSource | String | True | True | The source that initiated a session on your website or app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Sessions | Integer | False | True | The number of sessions that began on the site or app. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source platform report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date = '01/05/2023' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourcePlatformReport
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionSourcePlatform | String | True | True | The source platform of the session | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM AcquisitionsSessionSourceReport WHERE PropertyId = 342020667 SELECT * FROM AcquisitionsSessionSourceReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date = '01/01/2022' SELECT * FROM AcquisitionsSessionSourceReport WHERE PropertyId = 342020667 AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date >= '01/01/2022' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date <= '01/01/2022' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date > '01/01/2022' SELECT * FROM AcquisitionsSessionSourceReport WHERE Date < '01/01/2022'
CustomChannelGroups are added as dimension columns. We can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourceReport
NOTE: CustomChannelGroupName is for reference purpose only. The exact value will depend on the channelGroupName added. The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
SessionSource | String | True | True | The source that initiated a session on your website or app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Sessions | Integer | False | True | The number of sessions that began on the site or app. | |
EventsPerSession | Decimal | False | True | The average number of events per session. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
UserEngagementDuration | Integer | False | False | The total amount of time (in seconds) the website or app was in the foreground of users |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A base view that retrieves Active Users data.
Retrieves data for ActiveUsers report. At least one metric must be specified in the query. This endpoint uses the realtime report API endpoint to get more up to date data than the standard reporting endpoint. The realtime reporting API supports a maximum of four dimensions compared to the standard nine for the standard report API.
The following is an example query:
SELECT ActiveUsers, Platform FROM ActiveUsers
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AppVersion | String | True | The app versionName (Android) or short bundle version (iOS). | ||
City | String | True | The city from which the user activity originated. | ||
Country | String | True | The country from which the user activity originated. | ||
DeviceCategory | String | True | The type of device: Desktop, Tablet, or Mobile. | ||
Platform | String | True | True | The platform on which your app or website ran. | |
AudienceName | String | True | The given name of an Audience. | ||
UnifiedScreenName | String | True | The page title (web) or screen name (app) on which the event was logged. | ||
ActiveUsers | Integer | False | True | The total number of active users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics UserAgeBracket data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicAgeReport WHERE PropertyId = 342020667 SELECT * FROM DemographicAgeReport WHERE UserAgeBracket = '18-24' SELECT * FROM DemographicAgeReport WHERE Date = '01/05/2023' SELECT * FROM DemographicAgeReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND UserAgeBracket = '18-24' SELECT * FROM DemographicAgeReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicAgeReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicAgeReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicAgeReport WHERE Date > '01/01/2022' SELECT * FROM DemographicAgeReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
UserAgeBracket | String | True | True | User age brackets. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics City data.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
City | String | True | True | The City from which user activity originated. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics Country data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicCountryReport WHERE PropertyId = 342020667 SELECT * FROM DemographicCountryReport WHERE Country = 'America' SELECT * FROM DemographicCountryReport WHERE Date = '01/05/2023' SELECT * FROM DemographicCountryReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Country = 'America' SELECT * FROM DemographicCountryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicCountryReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicCountryReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicCountryReport WHERE Date > '01/01/2022' SELECT * FROM DemographicCountryReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Country | String | True | True | The Country from which user activity originated. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics UserGender data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicGenderReport WHERE PropertyId = 342020667 SELECT * FROM DemographicGenderReport WHERE UserGender = 'Female' SELECT * FROM DemographicGenderReport WHERE Date = '01/01/2022' SELECT * FROM DemographicGenderReport WHERE PropertyId = 342020667 AND Date = '01/01/2022' AND UserGender = 'Female' SELECT * FROM DemographicGenderReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicGenderReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicGenderReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicGenderReport WHERE Date > '01/01/2022' SELECT * FROM DemographicGenderReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
UserGender | String | True | True | User gender. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics BrandingInterest data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicInterestsReport WHERE PropertyId = 342020667 SELECT * FROM DemographicInterestsReport WHERE BrandingInterest = 'Marketing' SELECT * FROM DemographicInterestsReport WHERE Date = '01/05/2023' SELECT * FROM DemographicInterestsReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND BrandingInterest = 'Marketing' SELECT * FROM DemographicInterestsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicInterestsReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicInterestsReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicInterestsReport WHERE Date > '01/01/2022' SELECT * FROM DemographicInterestsReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
BrandingInterest | String | True | True | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics Language data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicLanguageReport WHERE PropertyId = 342020667 SELECT * FROM DemographicLanguageReport WHERE Language = 'English' SELECT * FROM DemographicLanguageReport WHERE Date = '01/05/2023' SELECT * FROM DemographicLanguageReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Language = 'English' SELECT * FROM DemographicLanguageReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicLanguageReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicLanguageReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicLanguageReport WHERE Date > '01/01/2022' SELECT * FROM DemographicLanguageReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Language | String | True | True | The Language setting for the device from which activity originated. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Demographics Region data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM DemographicRegionReport WHERE PropertyId = 342020667 SELECT * FROM DemographicRegionReport WHERE Region = 'California' SELECT * FROM DemographicRegionReport WHERE Date = '01/05/2023' SELECT * FROM DemographicRegionReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Region = 'California' SELECT * FROM DemographicRegionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM DemographicRegionReport WHERE Date >= '01/01/2022' SELECT * FROM DemographicRegionReport WHERE Date <= '01/01/2022' SELECT * FROM DemographicRegionReport WHERE Date > '01/01/2022' SELECT * FROM DemographicRegionReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Region | String | True | True | The Geographic region from which activity originated. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A base view that retrieves Demographics data.
Retrieves data for Demographics report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions.
The following is an example query:
SELECT Conversions, TotalRevenue FROM Demographics
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
BrandingInterest | String | True | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. | ||
Country | String | True | True | Country from which user activity originated. | |
City | String | True | City from which user activity originated. | ||
Language | String | True | Language setting for the device from which activity originated. | ||
UserAgeBracket | String | True | User age brackets. | ||
UserGender | String | True | User gender. | ||
Region | String | True | Geographic region from which activity originated. | ||
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views. | |
EngagedSessionsPerUser | Decimal | False | True | Average number of engaged sessions per user. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item brand data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemBrandReport WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemBrandReport WHERE ItemBrand = 'test' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemBrandReport WHERE PropertyId = 342020667 AND ItemBrand = 'test' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemBrandReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemBrand | String | True | True | The Brand name of the item. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategory2Report WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategory2Report WHERE ItemCategory2 = 'Apparel' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory2Report WHERE PropertyId = 342020667 AND ItemCategory2 = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory2 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategory3Report WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategory3Report WHERE ItemCategory3 = 'Apparel' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory3Report WHERE PropertyId = 342020667 AND ItemCategory3 = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory3 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategory4Report WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategory4Report WHERE ItemCategory4 = 'Apparel' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory4Report WHERE PropertyId = 342020667 AND ItemCategory4 = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory4 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategory5Report WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategory5Report WHERE ItemCategory4 = 'Apparel' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory5Report WHERE PropertyId = 342020667 AND ItemCategory5 = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory5 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategoryReport WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategoryReport WHERE ItemCategory = 'Apparel' SELECT * FROM EcommPurchasesItemCategoryReport WHERE PropertyId = 342020667 AND ItemCategory = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory = 'Apparel' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory2 = 'Mens' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory3 = 'Summer' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory4 = 'Shirts' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory5 = 'T-shirts' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE PropertyId = 342020667 AND ItemCategory = 'Apparel' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemCategory | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category. | |
ItemCategory2 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category2 | |
ItemCategory3 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3. | |
ItemCategory4 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4. | |
ItemCategory5 | String | True | True | A Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. | |
ItemsViewed | Integer | False | True | The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemIdReport WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemIdReport WHERE ItemId = '1234' SELECT * FROM EcommPurchasesItemIdReport WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemIdReport WHERE PropertyId = 342020667 AND ItemId = '1234' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemIdReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemIdReport WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemIdReport WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemIdReport WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemIdReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemId | String | True | True | ID of the item. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EcommPurchasesItemNameReport WHERE PropertyId = 342020667 SELECT * FROM EcommPurchasesItemNameReport WHERE ItemName = 'test' SELECT * FROM EcommPurchasesItemNameReport WHERE Date = '01/05/2023' SELECT * FROM EcommPurchasesItemNameReport WHERE PropertyId = 342020667 AND ItemName = 'test' AND Date = '01/05/2023' SELECT * FROM EcommPurchasesItemNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EcommPurchasesItemNameReport WHERE Date >= '01/01/2022' SELECT * FROM EcommPurchasesItemNameReport WHERE Date <= '01/01/2022' SELECT * FROM EcommPurchasesItemNameReport WHERE Date > '01/01/2022' SELECT * FROM EcommPurchasesItemNameReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ItemName | String | True | True | The name of the item. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, this is the replacement for the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
PurchaseToViewRate | Decimal | False | True | The total cost of shipping. | |
ItemsPurchased | Decimal | False | True | The total amount of tax. The ItemPurchaseQuantity metric has been renamed to this metric. | |
ItemRevenue | Decimal | False | True | The total revenue from items only. Item revenue is the product of its price and quantity. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A base view that retrieves Engagement data
Retrieves data for Engagement report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions.
The following are example queries:
SELECT NewUsers, TotalRevenue FROM Engagement
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. A two digit integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A two-digit number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A two-digit number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
ContentGroup | String | True | A category that applies to items of published content | ||
EventName | String | True | The name of the event | ||
UnifiedPageScreen | String | True | The page path (web) or screen class (app) on which the event was logged | ||
UnifiedScreenClass | String | True | True | The page title (web) or screen class (app) on which the event was logged | |
UnifiedScreenName | String | True | The page title (web) or screen name (app) on which the event was logged | ||
PagePath | String | True | The portion of the URL between the hostname and query string for web | ||
PageTitle | String | True | The web page titles used on your site | ||
Conversions | Integer | False | True | The count of conversion events | |
EngagedSessionsPerUser | Decimal | False | True | Average number of engaged sessions per user | |
EventCount | Integer | False | True | The count of events | |
EventCountPerUser | Decimal | False | True | Average number of events triggered by each user | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time | |
ScreenPageViews | Integer | False | True | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app | |
userEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users' device | |
ViewsPerUser | Decimal | False | True | Average number of screens viewed by each user | |
SessionsPerUser | Decimal | False | False | The average number of sessions per user (Sessions divided by Active Users). | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table |
A predefined view that retrieves Engagement Content Group Report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EngagementContentGroupReport WHERE PropertyId = 342020667 SELECT * FROM EngagementContentGroupReport WHERE ContentGroup = 'CData Test' SELECT * FROM EngagementContentGroupReport WHERE Date = '01/05/2023' SELECT * FROM EngagementContentGroupReport WHERE PropertyId = 342020667 AND ContentGroup = 'CData Test' AND Date = '01/05/2023' SELECT * FROM EngagementContentGroupReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EngagementContentGroupReport WHERE Date >= '01/01/2022' SELECT * FROM EngagementContentGroupReport WHERE Date <= '01/01/2022' SELECT * FROM EngagementContentGroupReport WHERE Date > '01/01/2022' SELECT * FROM EngagementContentGroupReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ContentGroup | String | True | True | A category that applies to items of published content. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
ScreenPageViews | Integer | False | True | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users device. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Engagement conversions data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EngagementConversionsReport WHERE PropertyId = 342020667 SELECT * FROM EngagementConversionsReport WHERE EventName = 'page_view' SELECT * FROM EngagementConversionsReport WHERE Date = '01/05/2023' SELECT * FROM EngagementConversionsReport WHERE PropertyId = 342020667 AND EventName = 'page_view' AND Date = '01/05/2023' SELECT * FROM EngagementConversionsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EngagementConversionsReport WHERE Date >= '01/01/2022' SELECT * FROM EngagementConversionsReport WHERE Date <= '01/01/2022' SELECT * FROM EngagementConversionsReport WHERE Date > '01/01/2022' SELECT * FROM EngagementConversionsReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
EventName | String | True | True | The name of the event. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventCountPerUser | Decimal | False | True | Average number of events triggered by each user. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Engagement events data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EngagementEventsReport WHERE PropertyId = 342020667 SELECT * FROM EngagementEventsReport WHERE EventName = 'page_view' SELECT * FROM EngagementEventsReport WHERE Date = '01/05/2023' SELECT * FROM EngagementEventsReport WHERE PropertyId = 342020667 AND EventName = 'page_view' AND Date = '01/05/2023' SELECT * FROM EngagementEventsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EngagementEventsReport WHERE Date >= '01/01/2022' SELECT * FROM EngagementEventsReport WHERE Date <= '01/01/2022' SELECT * FROM EngagementEventsReport WHERE Date > '01/01/2022' SELECT * FROM EngagementEventsReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
EventName | String | True | True | The name of the event. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
EventCountPerUser | Decimal | False | True | Average number of events triggered by each user. | |
EventCount | Integer | False | True | The count of events. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Engagement Pages path report data.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
PagePath | String | True | True | The portion of the URL between the hostname and query string for web. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
ScreenPageViews | Integer | False | True | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users device. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Engagement Pages title and screen class data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE PropertyId = 342020667 SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE UnifiedScreenClass = 'CData Test' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date = '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE PropertyId = 342020667 AND UnifiedScreenClass = 'CData Test' AND Date = '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date >= '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date <= '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date > '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
UnifiedScreenClass | String | True | True | The page title (web) or screen class (app) on which the event was logged. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
ScreenPageViews | Integer | False | True | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users device. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Engagement Pages Title And ScreenName data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE PropertyId = 342020667 SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE UnifiedScreenName = 'CData Test' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date = '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE PropertyId = 342020667 AND UnifiedScreenName = 'CData Test' AND Date = '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date >= '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date <= '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date > '01/01/2022' SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
UnifiedScreenName | String | True | True | The page title (web) or screen name (app) on which the event was logged. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
ScreenPageViews | Integer | False | True | The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The number of distinct users who visited the site or app. | |
UserEngagementDuration | Integer | False | True | The total amount of time (in seconds) the website or app was in the foreground of users device. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A base view that retrieves Event data
Retrieves data for Events reports. At least one metric must be specified in the query. This endpoint uses the real-time report API endpoint to get more up-to-date data than the standard reporting endpoint. The real-time reporting API supports a maximum of four dimensions compared to nine for the standard report API.
The following is an example query:
SELECT EventCount, Platform FROM Events
Since PagePath and PlatTitle dimensions are not available in the runRealReport endpoint, use the connection property ReportType = reports to leverage the result with these dimensions.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AppVersion | String | True | The application's versionName (Android) or short bundle version (iOS) | ||
City | String | True | The city from which the user activity originated | ||
Country | String | True | The country from which the user activity originated | ||
DeviceCategory | String | True | The type of device: Desktop, Tablet, or Mobile | ||
Platform | String | True | The platform on which your app or website ran | ||
AudienceName | String | True | The given name of an Audience | ||
UnifiedScreenName | String | True | The page title (web) or screen name (app) on which the event was logged | ||
EventName | String | True | True | The name of the event | |
PagePath | String | True | The portion of the URL between the hostname and query string for web. This works when connection propertyReportType=reports;. | ||
PageTitle | String | True | The web page titles used on your site. This works when connection property ReportType=reports; | ||
EventCount | Integer | False | True | Number of times an individual event was triggered | |
Conversions | Integer | False | True | The count of conversion events |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A base view that retrieves Games Reporting data.
Retrieves data for GamesReporting report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions.
The following is an example query:
SELECT AveragePurchaseRevenue, AverageRevenuePerUser FROM GamesReporting
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. A two digit integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A two-digit number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A two-digit number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
AudienceName | String | True | The given name of an Audience. | ||
FirstUserCampaignName | String | True | Name of the marketing campaign that first acquired the user. | ||
FirstUserCreativeId | String | True | The campaign creative ID that first acquired the user. | ||
FirstUserGoogleAdsAdGroupId | String | True | The Ad Group Id in Google Ads that first acquired the user. | ||
FirstUserGoogleAdsAdGroupName | String | True | The Ad Group Name in Google Ads that first acquired the user. | ||
FirstUserGoogleAdsAdNetworkType | String | True | The advertising network that first acquired the user. | ||
FirstUserMedium | String | True | True | The medium that first acquired the user to the website or app. | |
FirstUserSource | String | True | The source that first acquired the user to the website or app. | ||
AveragePurchaseRevenue | Decimal | False | True | The average purchase revenue in the transaction group of events. | |
AveragePurchaseRevenuePerPayingUser | Decimal | False | True | Average revenue per paying user (ARPPU) is the total purchase revenue per active user that logged a purchase event. The summary metric is for the time period selected. | |
AverageRevenuePerUser | Decimal | False | True | Average revenue per active user (ARPU). The summary metric is for the time period selected. | |
EngagedSessionsPerUser | Decimal | False | True | Average number of engaged sessions per user. | |
FirstTimeBuyersPerNewUsers | Decimal | False | True | Percentage of unique new users to the game who made their first in-app purchase. | |
FirstTimePurchasers | Integer | False | True | The number of users that completed their first purchase event. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table. |
Retrieves data for all the available dimensions and metrics.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
achievementId | String | True | The achievement Id in a game for an event. Populated by the event parameter achievementid. | ||
adFormat | String | True | Describes the way ads looked and where they were located. Typical formats include Interstitial, Banner, Rewarded, and Native advanced. | ||
adSourceName | String | True | The source network that served the ad. Typical sources include AdMob Network, Liftoff, Facebook Audience Network, and Mediated house ads. | ||
adUnitName | String | True | The name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users. | ||
appVersion | String | True | The apps versionName (Android) or short bundle version (iOS). | ||
audienceId | String | True | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the reports date range. Current user behavior does not affect historical audience membership in reports. | ||
audienceName | String | True | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports. | ||
brandingInterest | String | True | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. | ||
browser | String | True | The browsers used to view your website. | ||
campaignId | String | True | The identifier of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns. | ||
campaignName | String | True | The name of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns. | ||
character | String | True | The player character in a game for an event. Populated by the event parameter character. | ||
city | String | True | The city from which the user activity originated. | ||
cityId | String | True | The geographic Id of the city from which the user activity originated, derived from their IP address. | ||
cohort | String | True | The cohorts name in the request. A cohort is a set of users who started using your website or app in any consecutive group of days. If a cohort name is not specified in the request, cohorts are named by their zero based index: cohort_0, cohort_1, etc. | ||
cohortNthDay | String | True | Day offset relative to the firstSessionDate for the users in the cohort. For example, if a cohort is selected with the start and end date of 2020-03-01, then for the date 2020-03-02, cohortNthDay is 0001. | ||
cohortNthMonth | String | True | Month offset relative to the firstSessionDate for the users in the cohort. Month boundaries align with calendar month boundaries. For example, if a cohort is selected with the start and end date in March 2020, then for any date in April 2020, cohortNthMonth is 0001. | ||
cohortNthWeek | String | True | Week offset relative to the firstSessionDate for the users in the cohort. Weeks start on Sunday and end on Saturday. For example, if a cohort is selected with the start and end date in the range 2020-11-08 to 2020-11-14, then for the dates in the range 2020-11-15 to 2020-11-21, cohortNthWeek is 0001. | ||
contentGroup | String | True | A category that applies to items of published content. Populated by the event parameter content_group. | ||
contentId | String | True | The identifier of the selected content. Populated by the event parameter content_id. | ||
contentType | String | True | The category of the selected content. Populated by the event parameter content_type. | ||
continent | String | True | The continent from which the user activity originated. For example, Americas or Asia. | ||
continentId | String | True | The geographic Id of the continent from which the user activity originated, derived from their IP address. | ||
country | String | True | The country from which the user activity originated. | ||
countryId | String | True | The geographic Id of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard. | ||
date | String | True | The date of the event, formatted as YYYYMMDD. | ||
dateHour | String | True | The combined values of date and hour formatted as YYYYMMDDHH. | ||
dateHourMinute | String | True | The combined values of date, hour, and minute formatted as YYYYMMDDHHMM. | ||
day | String | True | The day of the month, a two-digit number from 01 to 31. | ||
dayOfWeek | String | True | The integer day of the week. It returns values in the range [0,6] with Sunday as the first day of the week. | ||
dayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
defaultChannelGroup | String | True | The conversion's default channel group is based primarily on source and medium. | ||
deviceCategory | String | True | The type of device: Desktop, Tablet, or Mobile. | ||
deviceModel | String | True | The mobile device model (example: iPhone 10,6). | ||
eventName | String | True | The name of the event. | ||
fileExtension | String | True | The extension of the downloaded file (for example, pdf or txt). Automatically populated if Enhanced Measurement is enabled . | ||
fileName | String | True | The page path of the downloaded file . Automatically populated if Enhanced Measurement is enabled. | ||
firstSessionDate | String | True | The date the user's first session occurred, formatted as YYYYMMDD. | ||
firstUserCampaignId | String | True | Identifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns. | ||
firstUserCampaignName | String | True | Name of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns. | ||
firstUserDefaultChannelGroup | String | True | The default channel group that first acquired the user. Default channel group is based primarily on source and medium. | ||
firstUserGoogleAdsAccountName | String | True | The Account name from Google Ads that first acquired the user. | ||
firstUserGoogleAdsAdGroupId | String | True | The Ad Group Id in Google Ads that first acquired the user. | ||
firstUserGoogleAdsAdGroupName | String | True | The Ad Group Name in Google Ads that first acquired the user. | ||
firstUserGoogleAdsAdNetworkType | String | True | The advertising network that first acquired the user. | ||
firstUserGoogleAdsCampaignId | String | True | Identifier of the Google Ads marketing campaign that first acquired the user. | ||
firstUserGoogleAdsCampaignName | String | True | Name of the Google Ads marketing campaign that first acquired the user. | ||
firstUserGoogleAdsCampaignType | String | True | The campaign type of the Google Ads campaign that first acquired the user. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max. | ||
firstUserGoogleAdsCreativeId | String | True | The Id of the Google Ads creative that first acquired the user. Creative IDs identify individual ads. | ||
firstUserGoogleAdsCustomerId | String | True | The Customer Id from Google Ads that first acquired the user. Customer IDs in Google Ads uniquely identify Google Ads accounts. | ||
firstUserGoogleAdsKeyword | String | True | The matched keyword that first acquired the user. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers. | ||
firstUserGoogleAdsQuery | String | True | The search query that first acquired the user. | ||
firstUserManualAdContent | String | True | The ad content that first acquired the user. Populated by the utm_content parameter. | ||
firstUserManualTerm | String | True | The term that first acquired the user. Populated by the utm_term parameter. | ||
firstUserMedium | String | True | The medium that first acquired the user to your website or app. | ||
firstUserSource | String | True | The source that first acquired the user to your website or app. | ||
firstUserSourceMedium | String | True | The combined values of the dimensions firstUserSource and firstUserMedium. | ||
firstUserSourcePlatform | String | True | The source platform that first acquired the user. Please do not depend on this field returning Manual for traffic that uses UTMs; this field will update from returning Manual to returning (not set) for an upcoming feature launch. | ||
fullPageUrl | String | True | The hostname, page path, and query string for web pages visited | ||
googleAdsAccountName | String | True | The Account name from Google Ads for the campaign that led to the conversion event. Corresponds to customer.descriptive_name in the Google Ads API. | ||
googleAdsAdGroupId | String | True | The ad group id attributed to the conversion event. | ||
googleAdsAdGroupName | String | True | The ad group name attributed to the conversion event. | ||
googleAdsAdNetworkType | String | True | The advertising network type of the conversion. | ||
googleAdsCampaignId | String | True | The campaign Id for the Google Ads campaign attributed to the conversion event. | ||
googleAdsCampaignName | String | True | The campaign name for the Google Ads campaign attributed to the conversion event. | ||
googleAdsCampaignType | String | True | The campaign type for the Google Ads campaign attributed to the conversion event. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max. | ||
googleAdsCreativeId | String | True | The Id of the Google Ads creative attributed to the conversion event. Creative IDs identify individual ads. | ||
googleAdsCustomerId | String | True | The Customer Id from Google Ads for the campaign that led to conversion event. Customer IDs in Google Ads uniquely identify Google Ads accounts. | ||
googleAdsKeyword | String | True | The matched keyword that led to the conversion event. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers. | ||
googleAdsQuery | String | True | The search query that led to the conversion event. | ||
groupId | String | True | The player group Id in a game for an event. Populated by the event parameter group_id. | ||
hostName | String | True | Includes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com. | ||
hour | String | True | The two-digit hour of the day that the event was logged. This dimension ranges from 0-23 and is reported in your property's timezone. | ||
isConversionEvent | String | True | The string 'true' if the event is a conversion. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default. | ||
isoWeek | String | True | ISO week number, where each week starts on Monday. Example values include 01, 02, and 53. | ||
isoYear | String | True | The ISO year of the event. Example values include 2022 and 2023. | ||
isoYearIsoWeek | String | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
itemAffiliation | String | True | The name or code of the affiliate (partner/vendor if any) associated with an individual item. Populated by the 'affiliation' item parameter. | ||
itemBrand | String | True | Brand name of the item. | ||
itemCategory | String | True | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category. | ||
itemCategory2 | String | True | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 2. | ||
itemCategory3 | String | True | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category 3. | ||
itemCategory4 | String | True | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category 4. | ||
itemCategory5 | String | True | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category 5. | ||
itemId | String | True | The Id of the item. | ||
itemListId | String | True | The Id of the item list. | ||
itemListName | String | True | The name of the item list. | ||
itemListPosition | String | True | The position of an item (e.g., a product you sell) in a list. This dimension is populated in tagging by the index parameter in the items array. | ||
itemLocationID | String | True | The physical location associated with the item (e.g. the physical store location). It is recommended to use the [Google Place ID] that corresponds to the associated item. A custom location Id can also be used. This field is populated in tagging by the location_id parameter in the items array. | ||
itemName | String | True | The name of the item. | ||
itemPromotionCreativeName | String | True | The name of the item-promotion creative. | ||
itemPromotionCreativeSlot | String | True | The name of the promotional creative slot associated with the item. This dimension can be specified in tagging by the creative_slot parameter at the event or item level. If the parameter is specified at both the event and item level, the item-level parameter is used. | ||
itemPromotionId | String | True | The Id of the item promotion. | ||
itemPromotionName | String | True | The name of the promotion for the item. | ||
itemVariant | String | True | The specific variation of a product. e.g., XS, S, M, L for size; or Red, Blue, Green, Black for color. Populated by the item_variant parameter. | ||
landingPage | String | True | The page path associated with the first pageview in a session. | ||
landingPagePlusQueryString | String | True | The page path + query string associated with the first pageview in a session. | ||
language | String | True | The language setting of the user's browser or device. e.g. English | ||
languageCode | String | True | The language setting (ISO 639) of the user's browser or device. e.g. en-us | ||
level | String | True | The players level in a game. Populated by the event parameter level. | ||
linkClasses | String | True | The HTML class attribute for an outbound link | ||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). |
Retrieves metadata information for standard and custom dimensions or metrics.
Retrieves metadata information for standard and custom dimensions / metrics. If PropertyID connection property not set, dimensions and metrics common to all properties will be retrieved.
The following is an example query:
SELECT * FROM Metadata
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ApiName | String | The API name for the dimension / metric. | |||
CustomDefinition | Boolean | Whether the dimension / metric is custom. | |||
Description | String | Description of how the dimension / metric is used and calculated. | |||
Type | String | Datatype of the dimension or metric. | |||
FieldType | String | Whether the field is a dimension or metric. | |||
UIName | String | The dimension or metric name within the Google Analytics user interface. |
A base view that retrieves Monetization data.
Retrieves data for Monetization report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions.
The following is an example query:
SELECT ItemsAddedToCart, CartToViewRate FROM Monetization
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
Country | String | True | The country of users, derived from IP addresses. | ||
City | String | True | The cities of property users, derived from IP addresses. | ||
AdFormat | String | True | Format of the ad(e.g., text, image, video). | ||
AdSourceName | String | True | Demand source that provided the ad. | ||
AdUnitName | String | True | Space on the website or app that displayed the ad. | ||
ItemBrand | String | True | Brand name of the item. | ||
ItemCategory | String | True | Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category. | ||
ItemCategory2 | String | True | Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category2 | ||
ItemCategory3 | String | True | Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3. | ||
ItemCategory4 | String | True | Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4. | ||
ItemCategory5 | String | True | Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5. | ||
ItemId | String | True | ID of the item. | ||
ItemListId | String | True | The ID of the item list. | ||
ItemListName | String | True | The name of the item list. | ||
ItemName | String | True | True | The name of the item. | |
ItemPromotionCreativeName | String | True | The name of the item-promotion creative. | ||
ItemPromotionId | String | True | ID of the item promotion. | ||
ItemPromotionName | String | True | Name of the promotion for the item. | ||
OrderCoupon | String | True | Code for the order-level coupon. | ||
UnifiedPageScreen | String | True | The page path (web) or screen class (app) on which the event was logged. | ||
TransactionId | String | True | The ID of the ecommerce transaction. | ||
adUnitExposure | Integer | False | The amount of time the ad unit was exposed to the user. This metric is not compatible with item-scoped dimensions. | ||
ItemsAddedToCart | Integer | False | True | The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric. | |
CartToViewRate | Integer | False | True | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s). | |
ItemsCheckedOut | Integer | False | True | Number of times users started the checkout process. Since Checkouts is not compatible with item-scoped dimensions, hence this is the replacement of the Checkouts metric. | |
EcommercePurchases | Integer | False | The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions. | ||
EventCount | Integer | False | The count of events. This metric is not compatible with item-scoped dimensions. This metric is not compatible with item-scoped dimensions. | ||
FirstTimePurchasers | Integer | False | True | The number of users that completed their first purchase event. | |
ItemsClickedInList | Integer | False | True | The number of times users clicked an item when it appeared in a list. Since ItemListClicks is not compatible with item-scoped dimensions, hence this is the replacement of the ItemListClicks metric. | |
ItemListClickThroughRate | Decimal | False | True | Rate at which users clicked the item in an item list to view the item details. | |
ItemsViewedInList | Integer | False | True | The number of times the item list was viewed. Since ItemListViews is not compatible with item-scoped dimensions, hence this is the replacement of the ItemListViews metric. | |
PromotionClicks | Integer | False | The number of times an item promotion was clicked. ItemPromotionClicks metric has been renamed to this metric. | ||
ItemPromotionClickThroughRate | Decimal | False | The number of users who selected a promotion(s) divided by the number of users who viewed the same promotion(s). | ||
PromotionViews | Integer | False | The number of times an item promotion was viewed. ItemPromotionViews metric has been renamed to this metric. | ||
ItemsPurchased | Decimal | False | The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric. | ||
ItemRevenue | Decimal | False | The total revenue from items only. Item revenue is the product of its price and quantity. | ||
ItemsViewed | Integer | False | The number of times the item details were viewed. ItemViews metric has been renamed to this metric. | ||
PublisherAdClicks | Integer | False | The number of times an ad was clicked on the publisher's site. | ||
PublisherAdImpressions | Integer | False | The number of times an ad was displayed on the publisher's site. | ||
PurchaseToViewRate | Decimal | False | The total cost of shipping. | ||
TotalAdRevenue | Integer | False | Sum of all advertising revenue. | ||
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves publisher ads page ad format data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE PropertyId = 342020667 SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE AdFormat = 'image' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE PropertyId = 342020667 AND AdFormat = 'image' AND Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date >= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date <= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date > '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AdFormat | String | True | True | Format of the ad(e.g., text, image, video). | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
PublisherAdImpressions | Integer | False | True | The number of times an ad was displayed on the publishers site. | |
adUnitExposure | Integer | False | True | The amount of time the ad unit was exposed to the user. | |
PublisherAdClicks | Integer | False | True | The number of times an ad was clicked on the publisherss site. | |
TotalAdRevenue | Integer | False | True | Sum of all advertising revenue. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves publisher ads ad source data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE PropertyId = 342020667 SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE AdSourceName = 'test' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE PropertyId = 342020667 AND AdSourceName = 'test' AND Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date >= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date <= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date > '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AdSourceName | String | True | True | Demand source that provided the ad. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
PublisherAdImpressions | Integer | False | True | The number of times an ad was displayed on the publishers site. | |
adUnitExposure | Integer | False | True | The amount of time the ad unit was exposed to the user. | |
PublisherAdClicks | Integer | False | True | The number of times an ad was clicked on the publishers site. | |
TotalAdRevenue | Integer | False | True | Sum of all advertising revenue. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves publisher ads ad unit data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE PropertyId = 342020667 SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE AdUnitName = 'Test' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE PropertyId = 342020667 AND AdUnitName = 'Test' AND Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date >= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date <= '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date > '01/01/2022' SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AdUnitName | String | True | True | Space on the website or app that displayed the ad. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
PublisherAdImpressions | Integer | False | True | The number of times an ad was displayed on the publishers site. | |
adUnitExposure | Integer | False | True | The amount of time the ad unit was exposed to the user. | |
PublisherAdClicks | Integer | False | True | The number of times an ad was clicked on the publishers site. | |
TotalAdRevenue | Integer | False | True | Sum of all advertising revenue. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves publisher ads page path data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PropertyId = 342020667 SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PagePath = '/cdataH.test.io/' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PropertyId = 342020667 AND PagePath = '/cdataH.test.io/' AND Date = '01/05/2023' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date >= '01/01/2022' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date <= '01/01/2022' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date > '01/01/2022' SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
PagePath | String | True | True | The portion of the URL between the hostname and query string for web. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
PublisherAdImpressions | Integer | False | True | The number of times an ad was displayed on the publishers site. | |
adUnitExposure | Integer | False | True | The amount of time the ad unit was exposed to the user. | |
PublisherAdClicks | Integer | False | True | The number of times an ad was clicked on the publishers site. | |
TotalAdRevenue | Integer | False | True | Sum of all advertising revenue. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
Lists all Properties to which the user has access.
SELECT * FROM Properties WHERE Id = '54516992' SELECT * FROM Properties WHERE Parent = 'accounts/54516992'
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
CreateTime | Datetime | Time the property was created. | |||
CurrencyCode | String | The currency type used in reports involving monetary values. | |||
DisplayName | String | Display name for the property. | |||
IndustryCategory | String | Industry associated with the property. | |||
Id | Integer | Property Id. | |||
Parent | String | Name of the property's logical parent. | |||
TimeZone | String | Reporting Time Zone. | |||
UpdateTime | Datetime | Time the property was last modified. |
Lists all data streams under a property to which the user has access. Attribute Parent (e.g: 'properties/123') or Name (e.g: 'properties/123/webDataStreams/456') is required to query the table.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
SELECT * FROM PropertiesDataStreams WHERE Parent = 'properties/123' SELECT * FROM PropertiesDataStreams WHERE Name = 'properties/123/webDataStreams/456'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
CreateTime | Datetime | Time the stream was created. | |||
DisplayName | String | Display name for the data stream. | |||
Name | String | Web data stream name. | |||
Parent | String | Name of the web data stream's logical parent. | |||
Type | String | Name of the web data stream's logical parent. | |||
webStreamData | String | Data specific to web streams. | |||
androidAppStreamData | String | Data specific to Android app streams. | |||
iosAppStreamData | String | Data specific to iOS app streams. | |||
UpdateTime | Datetime | Time the stream was last modified. | |||
PropertyId | Integer | The Property Id value to be used when querying this table. |
Lists all FirebaseLinks on a property to which the user has access.
Lists all FirebaseLinks on a property to which the user has access. The provider uses the GoogleAnalytics4 API to process WHERE clause conditions built with the Parent column and the = operator. Queries are processed server-side.
The following is an example query:
SELECT * FROM PropertiesFirebaseLinks WHERE Parent = 'properties/54516992'
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
CreateTime | Datetime | Time the FirebaseLink was created. | |||
MaximumUserAccess | String | Maximum user access to the property allowed to admins of the linked Firebase project. | |||
Name | String | FirebaseLink name. | |||
Parent | String | Name of the FirebaseLink's logical parent. | |||
Project | String | Firebase project resource name. | |||
PropertyId | Integer | The Property Id value to be used when querying this table. |
Lists all GoogleAdsLinks on a property to which the user has access.
Lists all GoogleAdsLinks on a property to which the user has access.
The provider will use the GoogleAnalytics4 API to process WHERE clause conditions built with the Parent column with the = operator.
Queries are processed server-side, and a value for the attribute Parent is required to query this table. The following is an example query:
SELECT * FROM PropertiesGoogleAdsLinks WHERE Parent = 'properties/54516992'The rest of the filter is executed client-side within the provider.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
CanManageClients | Boolean | Whether the link if for a Google Ads manager account. | |||
AdsPersonalizationEnabled | Boolean | Whether to enable personalized advertising. | |||
CreateTime | Datetime | Time the link was created. | |||
CustomerId | String | Google Ads customer ID. | |||
EmailAddress | String | Email address of the user that created the link. | |||
Name | String | GoogleAdsLinks name. | |||
Parent | String | Name of the GoogleAdsLink's logical parent. | |||
UpdateTime | Datetime | Time the link was last modified. | |||
PropertyId | Integer | The Property Id value to be used when querying this table. |
A base view that retrieves Tech data.
Retrieves data for Tech report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions.
The following is an example query:
SELECT Conversions, EngagementRate, EventCount FROM Tech
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Date | Date | True | The date of the session formatted as YYYYMMDD. | ||
Year | Integer | True | The year of the session. A four-digit year from 2005 to the current year. | ||
Month | Integer | True | The month of the session. An integer from 01 to 12. | ||
Week | Integer | True | The week of the session. A number from 01 to 53. Each week starts on Sunday. | ||
Day | Integer | True | The day of the month. A number from 01 to 31. | ||
DayOfWeekName | String | True | The day of the week in English. This dimension has values of Sunday, Monday, etc. | ||
IsoWeek | Integer | True | ISO week number, where each week starts on Monday. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 01, 02, 53. | ||
IsoYear | Integer | True | The ISO year of the event. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 2022 2023. | ||
IsoYearIsoWeek | Integer | True | The combined values of isoWeek and isoYear. Example values include 201652 and 201701. | ||
YearMonth | Integer | True | The combined values of year and month. Example values include 202212 or 202301. | ||
YearWeek | Integer | True | The combined values of year and week. Example values include 202253 or 202301. | ||
Hour | Integer | True | An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time. | ||
AppVersion | String | True | Version of the app. | ||
Browser | String | True | True | Browser used to engage with the site. | |
DeviceCategory | String | True | Type of device used to engage with the site/app: Desktop, Tablet, or Mobile. | ||
DeviceModel | String | True | Model of the device used to engage with the site/app. | ||
OperatingSystem | String | True | Operating systems used by visitors to the app or website. | ||
OperatingSystemVersion | String | True | Version of the operating systems used by visitors to the app or website. | ||
OperatingSystemWithVersion | String | True | Operating system name and version. | ||
Platform | String | True | Platform for the app or site (Android, iOS, Web). | ||
ScreenResolution | String | True | Resolution of the screen used to engage with the site/app. | ||
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. | |
StartDate | String | Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
EndDate | String | End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo). | |||
Dimensions | String | A comma-separated list of dimensions to retrieve in addition to the columns defined in the schema. Set to empty string to retrieve no dimensions. | |||
Metrics | String | A comma-separated list of metrics to retrieve in addition to the columns defined in the schema. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech App Version data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechAppVersionReport WHERE PropertyId = 342020667 SELECT * FROM TechAppVersionReport WHERE AppVersion = 'test' SELECT * FROM TechAppVersionReport WHERE Date = '01/05/2023' SELECT * FROM TechAppVersionReport WHERE PropertyId = 342020667 AND AppVersion = 'test' AND Date = '01/05/2023' SELECT * FROM TechAppVersionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechAppVersionReport WHERE Date >= '01/01/2022' SELECT * FROM TechAppVersionReport WHERE Date <= '01/01/2022' SELECT * FROM TechAppVersionReport WHERE Date > '01/01/2022' SELECT * FROM TechAppVersionReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
AppVersion | String | True | True | Version of the app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech Browser data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechBrowserReport WHERE PropertyId = 342020667 SELECT * FROM TechBrowserReport WHERE Browser = 'chrome' SELECT * FROM TechBrowserReport WHERE Date = '01/05/2023' SELECT * FROM TechBrowserReport WHERE PropertyId = 342020667 AND Browser = 'chrome' AND Date = '01/05/2023' SELECT * FROM TechBrowserReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechBrowserReport WHERE Date >= '01/01/2022' SELECT * FROM TechBrowserReport WHERE Date <= '01/01/2022' SELECT * FROM TechBrowserReport WHERE Date > '01/01/2022' SELECT * FROM TechBrowserReport WHERE Date < '01/01/2022'
The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Browser | String | True | True | Browser used to engage with the site. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech Device Category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechDeviceCategoryReport WHERE PropertyId = 342020667 SELECT * FROM TechDeviceCategoryReport WHERE DeviceCategory = 'desktop' SELECT * FROM TechDeviceCategoryReport WHERE Date = '01/05/2023' SELECT * FROM TechDeviceCategoryReport WHERE PropertyId = 342020667 AND DeviceCategory = 'desktop' AND Date = '01/05/2023' SELECT * FROM TechDeviceCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechDeviceCategoryReport WHERE Date >= '01/01/2022' SELECT * FROM TechDeviceCategoryReport WHERE Date <= '01/01/2022' SELECT * FROM TechDeviceCategoryReport WHERE Date > '01/01/2022' SELECT * FROM TechDeviceCategoryReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
DeviceCategory | String | True | True | Type of device used to engage with the site/app: Desktop, Tablet, or Mobile. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech Device Model data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechDeviceModelReport WHERE PropertyId = 342020667 SELECT * FROM TechDeviceModelReport WHERE DeviceModel = 'test' SELECT * FROM TechDeviceModelReport WHERE Date = '01/01/2022' SELECT * FROM TechDeviceModelReport WHERE PropertyId = 342020667 AND DeviceModel = 'test' AND Date = '01/01/2022' SELECT * FROM TechDeviceModelReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechDeviceModelReport WHERE Date >= '01/01/2022' SELECT * FROM TechDeviceModelReport WHERE Date <= '01/01/2022' SELECT * FROM TechDeviceModelReport WHERE Date > '01/01/2022' SELECT * FROM TechDeviceModelReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
DeviceModel | String | True | True | Model of the device used to engage with the site/app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech os system data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechOSSystemReport WHERE PropertyId = 342020667 SELECT * FROM TechOSSystemReport WHERE OperatingSystem = 'Windows' SELECT * FROM TechOSSystemReport WHERE Date = '01/05/2023' SELECT * FROM TechOSSystemReport WHERE PropertyId = 342020667 AND OperatingSystem = 'Windows' AND Date = '01/05/2023' SELECT * FROM TechOSSystemReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechOSSystemReport WHERE Date >= '01/01/2022' SELECT * FROM TechOSSystemReport WHERE Date <= '01/01/2022' SELECT * FROM TechOSSystemReport WHERE Date > '01/01/2022' SELECT * FROM TechOSSystemReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
OperatingSystem | String | True | True | Operating systems used by visitors to the app or website. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech Os version data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechOSVersionReport WHERE PropertyId = 342020667 SELECT * FROM TechOSVersionReport WHERE OperatingSystemVersion = '10' SELECT * FROM TechOSVersionReport WHERE Date = '01/01/2022' SELECT * FROM TechOSVersionReport WHERE PropertyId = 342020667 AND OperatingSystem = '10' AND Date = '01/01/2022' SELECT * FROM TechOSVersionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechOSVersionReport WHERE Date >= '01/01/2022' SELECT * FROM TechOSVersionReport WHERE Date <= '01/01/2022' SELECT * FROM TechOSVersionReport WHERE Date > '01/01/2022' SELECT * FROM TechOSVersionReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
OperatingSystemVersion | String | True | True | Version of the operating systems used by visitors to the app or website. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech platform device category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667 SELECT * FROM TechPlatformDeviceCategoryReport WHERE Platform = 'web' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date = '01/05/2023' SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667 AND DeviceCategory = 'desktop' SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667 AND Platform = 'web' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date >= '01/01/2022' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date <= '01/01/2022' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date > '01/01/2022' SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
DeviceCategory | String | True | True | Type of device used to engage with the site/app: Desktop, Tablet, or Mobile. | |
Platform | String | True | True | Platform for the app or site (Android, iOS, Web). | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667 SELECT * FROM TechPlatformReport WHERE Platform = 'web' SELECT * FROM TechPlatformReport WHERE Date = '01/05/2023' SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667 AND Platform = 'web' AND Date = '01/05/2023' SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667 AND Platform = 'web' SELECT * FROM TechPlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechPlatformReport WHERE Date >= '01/01/2022' SELECT * FROM TechPlatformReport WHERE Date <= '01/01/2022' SELECT * FROM TechPlatformReport WHERE Date > '01/01/2022' SELECT * FROM TechPlatformReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
Platform | String | True | True | Platform for the app or site (Android, iOS, Web). | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
A predefined view that retrieves Tech Screen Resolution data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
For example, the following queries are processed server-side:
SELECT * FROM TechScreenResolutionReport WHERE PropertyId = 342020667 SELECT * FROM TechScreenResolutionReport WHERE ScreenResolution = '1920x1080' SELECT * FROM TechScreenResolutionReport WHERE Date = '01/05/2023' SELECT * FROM TechScreenResolutionReport WHERE PropertyId = 342020667 AND ScreenResolution = '1920x1080' AND Date = '01/05/2023' SELECT * FROM TechScreenResolutionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023' SELECT * FROM TechScreenResolutionReport WHERE Date >= '01/01/2022' SELECT * FROM TechScreenResolutionReport WHERE Date <= '01/01/2022' SELECT * FROM TechScreenResolutionReport WHERE Date > '01/01/2022' SELECT * FROM TechScreenResolutionReport WHERE Date < '01/01/2022'The rest of the filter is executed client-side in the Cloud.
Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
ScreenResolution | String | True | True | Resolution of the screen used to engage with the site/app. | |
Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
Conversions | Integer | False | True | The count of conversion events. | |
EngagementRate | Decimal | False | True | The percentage of engaged sessions. | |
EngagedSessions | Integer | False | True | The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views. | |
EventCount | Integer | False | True | The count of events. | |
NewUsers | Integer | False | True | The number of users who interacted with the site or launched the app for the first time. | |
TotalRevenue | Integer | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
TotalUsers | Integer | False | True | The total number of users. |
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
Name | Type | Description |
PropertyId | String | The Property Id value to be used when querying this table. |
Stored procedures are function-like interfaces that extend the functionality of the Cloud beyond simple SELECT operations with Google Analytics.
Stored procedures accept a list of parameters, perform their intended function, and then return any relevant response data from Google Analytics, along with an indication of whether the procedure succeeded or failed.
Name | Description |
CreateCustomSchema | Creates a custom schema file based on the specified Dimensions and Metrics. |
GetSignalsSettings | Get Settings values for Google Signals. |
Creates a custom schema file based on the specified Dimensions and Metrics.
Creates a custom schema file based on the specified Dimensions and Metrics.
A custom schema may be used for a more tailored approach to your data. Custom options may include comma-separated lists for specific data.
Name | Type | Required | Description |
TableName | String | True | The name for the new table. |
Description | String | False | An optional description for the table. |
WriteToFile | String | False | Whether to write to an output file. Defaults totrue and must be set to false to write to FileStream or FileData. |
Dimensions | String | False | A comma-separated list of dimensions to include in the schema file. Here is a list of the possible values: https://ga-dev-tools.web.app/ga4/dimensions-metrics-explorer/ |
Metrics | String | False | A comma-separated list of metrics to include in the schema file. Here is a list of the possible values: https://ga-dev-tools.web.app/ga4/dimensions-metrics-explorer/ |
PropertyId | String | False | The Property Id to retrieve data from. If not specified, dimensions and metrics common to all properties will be retrieved. |
ReportyType | String | False | The type of report to be created using this custom schema. Available values are: 'RealTime' and 'Standard' (default) |
Name | Type | Description |
Success | String | Whether the schema was created successfully. |
SchemaFile | String | The generated schema file. |
FileData | String | The generated schema encoded in base64. Only returned if WriteToFile set to false and FileStream is not set. |
Get Settings values for Google Signals.
Name | Type | Required | Description |
PropertyId | String | False | The Id of the property for which Google signals settings to retrieve. Format:PropertyId=1234 |
Name | Type | Description |
Name | String | Resource name of this setting. |
State | String | Status of this setting. |
Consent | String | Terms of Service acceptance. |
You can query the system tables described in this section to access schema information, information on data source functionality, and batch operation statistics.
The following tables return database metadata for Google Analytics:
The following tables return information about how to connect to and query the data source:
The following table returns query statistics for data modification queries:
Lists the available databases.
The following query retrieves all databases determined by the connection string:
SELECT * FROM sys_catalogs
Name | Type | Description |
CatalogName | String | The database name. |
Lists the available schemas.
The following query retrieves all available schemas:
SELECT * FROM sys_schemas
Name | Type | Description |
CatalogName | String | The database name. |
SchemaName | String | The schema name. |
Lists the available tables.
The following query retrieves the available tables and views:
SELECT * FROM sys_tables
Name | Type | Description |
CatalogName | String | The database containing the table or view. |
SchemaName | String | The schema containing the table or view. |
TableName | String | The name of the table or view. |
TableType | String | The table type (table or view). |
Description | String | A description of the table or view. |
IsUpdateable | Boolean | Whether the table can be updated. |
Describes the columns of the available tables and views.
The following query returns the columns and data types for the Traffic table:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Traffic'
Name | Type | Description |
CatalogName | String | The name of the database containing the table or view. |
SchemaName | String | The schema containing the table or view. |
TableName | String | The name of the table or view containing the column. |
ColumnName | String | The column name. |
DataTypeName | String | The data type name. |
DataType | Int32 | An integer indicating the data type. This value is determined at run time based on the environment. |
Length | Int32 | The storage size of the column. |
DisplaySize | Int32 | The designated column's normal maximum width in characters. |
NumericPrecision | Int32 | The maximum number of digits in numeric data. The column length in characters for character and date-time data. |
NumericScale | Int32 | The column scale or number of digits to the right of the decimal point. |
IsNullable | Boolean | Whether the column can contain null. |
Description | String | A brief description of the column. |
Ordinal | Int32 | The sequence number of the column. |
IsAutoIncrement | String | Whether the column value is assigned in fixed increments. |
IsGeneratedColumn | String | Whether the column is generated. |
IsHidden | Boolean | Whether the column is hidden. |
IsArray | Boolean | Whether the column is an array. |
IsReadOnly | Boolean | Whether the column is read-only. |
IsKey | Boolean | Indicates whether a field returned from sys_tablecolumns is the primary key of the table. |
Lists the available stored procedures.
The following query retrieves the available stored procedures:
SELECT * FROM sys_procedures
Name | Type | Description |
CatalogName | String | The database containing the stored procedure. |
SchemaName | String | The schema containing the stored procedure. |
ProcedureName | String | The name of the stored procedure. |
Description | String | A description of the stored procedure. |
ProcedureType | String | The type of the procedure, such as PROCEDURE or FUNCTION. |
Describes stored procedure parameters.
The following query returns information about all of the input parameters for the CreateCustomSchema stored procedure:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateCustomSchema' AND Direction=1 OR Direction=2
Name | Type | Description |
CatalogName | String | The name of the database containing the stored procedure. |
SchemaName | String | The name of the schema containing the stored procedure. |
ProcedureName | String | The name of the stored procedure containing the parameter. |
ColumnName | String | The name of the stored procedure parameter. |
Direction | Int32 | An integer corresponding to the type of the parameter: input (1), input/output (2), or output(4). input/output type parameters can be both input and output parameters. |
DataTypeName | String | The name of the data type. |
DataType | Int32 | An integer indicating the data type. This value is determined at run time based on the environment. |
Length | Int32 | The number of characters allowed for character data. The number of digits allowed for numeric data. |
NumericPrecision | Int32 | The maximum precision for numeric data. The column length in characters for character and date-time data. |
NumericScale | Int32 | The number of digits to the right of the decimal point in numeric data. |
IsNullable | Boolean | Whether the parameter can contain null. |
IsRequired | Boolean | Whether the parameter is required for execution of the procedure. |
IsArray | Boolean | Whether the parameter is an array. |
Description | String | The description of the parameter. |
Ordinal | Int32 | The index of the parameter. |
Describes the primary and foreign keys.
The following query retrieves the primary key for the Traffic table:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Traffic'
Name | Type | Description |
CatalogName | String | The name of the database containing the key. |
SchemaName | String | The name of the schema containing the key. |
TableName | String | The name of the table containing the key. |
ColumnName | String | The name of the key column. |
IsKey | Boolean | Whether the column is a primary key in the table referenced in the TableName field. |
IsForeignKey | Boolean | Whether the column is a foreign key referenced in the TableName field. |
PrimaryKeyName | String | The name of the primary key. |
ForeignKeyName | String | The name of the foreign key. |
ReferencedCatalogName | String | The database containing the primary key. |
ReferencedSchemaName | String | The schema containing the primary key. |
ReferencedTableName | String | The table containing the primary key. |
ReferencedColumnName | String | The column name of the primary key. |
Describes the foreign keys.
The following query retrieves all foreign keys which refer to other tables:
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Name | Type | Description |
CatalogName | String | The name of the database containing the key. |
SchemaName | String | The name of the schema containing the key. |
TableName | String | The name of the table containing the key. |
ColumnName | String | The name of the key column. |
PrimaryKeyName | String | The name of the primary key. |
ForeignKeyName | String | The name of the foreign key. |
ReferencedCatalogName | String | The database containing the primary key. |
ReferencedSchemaName | String | The schema containing the primary key. |
ReferencedTableName | String | The table containing the primary key. |
ReferencedColumnName | String | The column name of the primary key. |
ForeignKeyType | String | Designates whether the foreign key is an import (points to other tables) or export (referenced from other tables) key. |
Describes the primary keys.
The following query retrieves the primary keys from all tables and views:
SELECT * FROM sys_primarykeys
Name | Type | Description |
CatalogName | String | The name of the database containing the key. |
SchemaName | String | The name of the schema containing the key. |
TableName | String | The name of the table containing the key. |
ColumnName | String | The name of the key column. |
KeySeq | String | The sequence number of the primary key. |
KeyName | String | The name of the primary key. |
Describes the available indexes. By filtering on indexes, you can write more selective queries with faster query response times.
The following query retrieves all indexes that are not primary keys:
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Name | Type | Description |
CatalogName | String | The name of the database containing the index. |
SchemaName | String | The name of the schema containing the index. |
TableName | String | The name of the table containing the index. |
IndexName | String | The index name. |
ColumnName | String | The name of the column associated with the index. |
IsUnique | Boolean | True if the index is unique. False otherwise. |
IsPrimary | Boolean | True if the index is a primary key. False otherwise. |
Type | Int16 | An integer value corresponding to the index type: statistic (0), clustered (1), hashed (2), or other (3). |
SortOrder | String | The sort order: A for ascending or D for descending. |
OrdinalPosition | Int16 | The sequence number of the column in the index. |
Returns information on the available connection properties and those set in the connection string.
When querying this table, the config connection string should be used:
jdbc:cdata:googleanalytics:config:
This connection string enables you to query this table without a valid connection.
The following query retrieves all connection properties that have been set in the connection string or set through a default value:
SELECT * FROM sys_connection_props WHERE Value <> ''
Name | Type | Description |
Name | String | The name of the connection property. |
ShortDescription | String | A brief description. |
Type | String | The data type of the connection property. |
Default | String | The default value if one is not explicitly set. |
Values | String | A comma-separated list of possible values. A validation error is thrown if another value is specified. |
Value | String | The value you set or a preconfigured default. |
Required | Boolean | Whether the property is required to connect. |
Category | String | The category of the connection property. |
IsSessionProperty | String | Whether the property is a session property, used to save information about the current connection. |
Sensitivity | String | The sensitivity level of the property. This informs whether the property is obfuscated in logging and authentication forms. |
PropertyName | String | A camel-cased truncated form of the connection property name. |
Ordinal | Int32 | The index of the parameter. |
CatOrdinal | Int32 | The index of the parameter category. |
Hierarchy | String | Shows dependent properties associated that need to be set alongside this one. |
Visible | Boolean | Informs whether the property is visible in the connection UI. |
ETC | String | Various miscellaneous information about the property. |
Describes the SELECT query processing that the Cloud can offload to the data source.
See SQL Compliance for SQL syntax details.
Below is an example data set of SQL capabilities. Some aspects of SELECT functionality are returned in a comma-separated list if supported; otherwise, the column contains NO.
Name | Description | Possible Values |
AGGREGATE_FUNCTIONS | Supported aggregation functions. | AVG, COUNT, MAX, MIN, SUM, DISTINCT |
COUNT | Whether COUNT function is supported. | YES, NO |
IDENTIFIER_QUOTE_OPEN_CHAR | The opening character used to escape an identifier. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | The closing character used to escape an identifier. | ] |
SUPPORTED_OPERATORS | A list of supported SQL operators. | =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR |
GROUP_BY | Whether GROUP BY is supported, and, if so, the degree of support. | NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE |
OJ_CAPABILITIES | The supported varieties of outer joins supported. | NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS |
OUTER_JOINS | Whether outer joins are supported. | YES, NO |
SUBQUERIES | Whether subqueries are supported, and, if so, the degree of support. | NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED |
STRING_FUNCTIONS | Supported string functions. | LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE |
NUMERIC_FUNCTIONS | Supported numeric functions. | ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE |
TIMEDATE_FUNCTIONS | Supported date/time functions. | NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT |
REPLICATION_SKIP_TABLES | Indicates tables skipped during replication. | |
REPLICATION_TIMECHECK_COLUMNS | A string array containing a list of columns which will be used to check for (in the given order) to use as a modified column during replication. | |
IDENTIFIER_PATTERN | String value indicating what string is valid for an identifier. | |
SUPPORT_TRANSACTION | Indicates if the provider supports transactions such as commit and rollback. | YES, NO |
DIALECT | Indicates the SQL dialect to use. | |
KEY_PROPERTIES | Indicates the properties which identify the uniform database. | |
SUPPORTS_MULTIPLE_SCHEMAS | Indicates if multiple schemas may exist for the provider. | YES, NO |
SUPPORTS_MULTIPLE_CATALOGS | Indicates if multiple catalogs may exist for the provider. | YES, NO |
DATASYNCVERSION | The CData Data Sync version needed to access this driver. | Standard, Starter, Professional, Enterprise |
DATASYNCCATEGORY | The CData Data Sync category of this driver. | Source, Destination, Cloud Destination |
SUPPORTSENHANCEDSQL | Whether enhanced SQL functionality beyond what is offered by the API is supported. | TRUE, FALSE |
SUPPORTS_BATCH_OPERATIONS | Whether batch operations are supported. | YES, NO |
SQL_CAP | All supported SQL capabilities for this driver. | SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX |
PREFERRED_CACHE_OPTIONS | A string value specifies the preferred cacheOptions. | |
ENABLE_EF_ADVANCED_QUERY | Indicates if the driver directly supports advanced queries coming from Entity Framework. If not, queries will be handled client side. | YES, NO |
PSEUDO_COLUMNS | A string array indicating the available pseudo columns. | |
MERGE_ALWAYS | If the value is true, The Merge Mode is forcibly executed in Data Sync. | TRUE, FALSE |
REPLICATION_MIN_DATE_QUERY | A select query to return the replicate start datetime. | |
REPLICATION_MIN_FUNCTION | Allows a provider to specify the formula name to use for executing a server side min. | |
REPLICATION_START_DATE | Allows a provider to specify a replicate startdate. | |
REPLICATION_MAX_DATE_QUERY | A select query to return the replicate end datetime. | |
REPLICATION_MAX_FUNCTION | Allows a provider to specify the formula name to use for executing a server side max. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | A list of tables which will skip dividing the replicate into chunks on the initial replicate. | |
CHECKCACHE_USE_PARENTID | Indicates whether the CheckCache statement should be done against the parent key column. | TRUE, FALSE |
CREATE_SCHEMA_PROCEDURES | Indicates stored procedures that can be used for generating schema files. |
The following query retrieves the operators that can be used in the WHERE clause:
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
Note that individual tables may have different limitations or requirements on the WHERE clause; refer to the Data Model section for more information.
Name | Type | Description |
NAME | String | A component of SQL syntax, or a capability that can be processed on the server. |
VALUE | String | Detail on the supported SQL or SQL syntax. |
Returns information about attempted modifications.
The following query retrieves the Ids of the modified rows in a batch operation:
SELECT * FROM sys_identity
Name | Type | Description |
Id | String | The database-generated Id returned from a data modification operation. |
Batch | String | An identifier for the batch. 1 for a single operation. |
Operation | String | The result of the operation in the batch: INSERTED, UPDATED, or DELETED. |
Message | String | SUCCESS or an error message if the update in the batch failed. |
The connection string properties are the various options that can be used to establish a connection. This section provides a complete list of the options you can configure in the connection string for this provider. Click the links for further details.
For more information on establishing a connection, see Establishing a Connection.
Property | Description |
AuthScheme | The type of authentication to use when connecting to Google Analytics. |
Schema | The type of schema to use. |
Profile | The Google Analytics View (Profile). |
Property | Description |
OAuthJWTCert | The JWT Certificate store. |
OAuthJWTCertType | The type of key store containing the JWT Certificate. |
OAuthJWTCertPassword | The password for the OAuth JWT certificate. |
OAuthJWTCertSubject | The subject of the OAuth JWT certificate. |
OAuthJWTIssuer | The issuer of the Java Web Token. |
OAuthJWTSubject | The user subject for which the application is requesting delegated access. |
Property | Description |
SSLServerCert | The certificate to be accepted from the server when connecting using TLS/SSL. |
Property | Description |
Verbosity | The verbosity level that determines the amount of detail included in the log file. |
Property | Description |
BrowsableSchemas | This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC. |
ApiVersion | Specify the API version you want to use with UniversalAnalytics. |
Property | Description |
DefaultFilter | A default filter to be applied to all queries. |
IgnorePermissionsException | Whether to ignore exceptions related to insufficient permissions for a specific profile. |
IncludeEmptyRows | This connection property can be set only when using the V4 API. If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows. |
MaxRows | Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses. |
Pagesize | The maximum number of results to return per page from Google Analytics. |
PropertyId | Property ID value to be used when querying reports views in V4 schema. |
PseudoColumns | This property indicates whether or not to include pseudo columns as columns to the table. |
ReportType | The type of Reports to get results in case of Events and ActiveUsers view. |
SamplingLevel | The desired sampling level. Can be set to run faster at the cost of accuracy or for higher accuracy but a decrease in query execution speed. Note: This property only applies when Schema is set to UniversalAnalytics. |
SupportEnhancedSQL | This property enhances SQL functionality beyond what can be supported through the API directly, by enabling in-memory client-side processing. |
Timeout | The value in seconds until the timeout error is thrown, canceling the operation. |
UseResourceQuotas | This connection property can be set only when using the V4 API. |
This section provides a complete list of the Authentication properties you can configure in the connection string for this provider.
Property | Description |
AuthScheme | The type of authentication to use when connecting to Google Analytics. |
Schema | The type of schema to use. |
Profile | The Google Analytics View (Profile). |
The type of authentication to use when connecting to Google Analytics.
string
"Auto"
The type of schema to use.
string
"GoogleAnalytics4"
The schemas available are UniversalAnalytics and GoogleAnalytics4. Note that the UniversalAnalytics API is deprecated on Google's side with support ending mid-2023.
The Google Analytics View (Profile).
string
""
This can be set to either the Id or website URL for the Profile. If not specified all the profiles returned would be used.
This is only used for the UniversalAnalytics Schema.
This section provides a complete list of the JWT OAuth properties you can configure in the connection string for this provider.
Property | Description |
OAuthJWTCert | The JWT Certificate store. |
OAuthJWTCertType | The type of key store containing the JWT Certificate. |
OAuthJWTCertPassword | The password for the OAuth JWT certificate. |
OAuthJWTCertSubject | The subject of the OAuth JWT certificate. |
OAuthJWTIssuer | The issuer of the Java Web Token. |
OAuthJWTSubject | The user subject for which the application is requesting delegated access. |
The JWT Certificate store.
string
""
The name of the certificate store for the client certificate.
The OAuthJWTCertType field specifies the type of the certificate store specified by OAuthJWTCert. If the store is password protected, specify the password in OAuthJWTCertPassword.
OAuthJWTCert is used in conjunction with the OAuthJWTCertSubject field in order to specify client certificates. If OAuthJWTCert has a value, and OAuthJWTCertSubject is set, a search for a certificate is initiated. Please refer to the OAuthJWTCertSubject field for details.
Designations of certificate stores are platform-dependent.
The following are designations of the most common User and Machine certificate stores in Windows:
MY | A certificate store holding personal certificates with their associated private keys. |
CA | Certifying authority certificates. |
ROOT | Root certificates. |
SPC | Software publisher certificates. |
In Java, the certificate store normally is a file containing certificates and optional private keys.
When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e. PKCS12 certificate store).
The type of key store containing the JWT Certificate.
string
"GOOGLEJSONBLJOB"
This property can take one of the following values:
USER | For Windows, this specifies that the certificate store is a certificate store owned by the current user. Note: This store type is not available in Java. |
MACHINE | For Windows, this specifies that the certificate store is a machine store. Note: this store type is not available in Java. |
PFXFILE | The certificate store is the name of a PFX (PKCS12) file containing certificates. |
PFXBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in PFX (PKCS12) format. |
JKSFILE | The certificate store is the name of a Java key store (JKS) file containing certificates. Note: this store type is only available in Java. |
JKSBLOB | The certificate store is a string (base-64-encoded) representing a certificate store in Java key store (JKS) format. Note: this store type is only available in Java. |
PEMKEY_FILE | The certificate store is the name of a PEM-encoded file that contains a private key and an optional certificate. |
PEMKEY_BLOB | The certificate store is a string (base64-encoded) that contains a private key and an optional certificate. |
PUBLIC_KEY_FILE | The certificate store is the name of a file that contains a PEM- or DER-encoded public key certificate. |
PUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains a PEM- or DER-encoded public key certificate. |
SSHPUBLIC_KEY_FILE | The certificate store is the name of a file that contains an SSH-style public key. |
SSHPUBLIC_KEY_BLOB | The certificate store is a string (base-64-encoded) that contains an SSH-style public key. |
P7BFILE | The certificate store is the name of a PKCS7 file containing certificates. |
PPKFILE | The certificate store is the name of a file that contains a PPK (PuTTY Private Key). |
XMLFILE | The certificate store is the name of a file that contains a certificate in XML format. |
XMLBLOB | The certificate store is a string that contains a certificate in XML format. |
GOOGLEJSON | The certificate store is the name of a JSON file containing the service account information. Only valid when connecting to a Google service. |
GOOGLEJSONBLOB | The certificate store is a string that contains the service account JSON. Only valid when connecting to a Google service. |
The password for the OAuth JWT certificate.
string
""
If the certificate store is of a type that requires a password, this property is used to specify that password in order to open the certificate store.
This is not required when using the GOOGLEJSON OAuthJWTCertType. Google JSON keys are not encrypted.
The subject of the OAuth JWT certificate.
string
"*"
When loading a certificate the subject is used to locate the certificate in the store.
If an exact match is not found, the store is searched for subjects containing the value of the property.
If a match is still not found, the property is set to an empty string, and no certificate is selected.
The special value "*" picks the first certificate in the certificate store.
The certificate subject is a comma separated list of distinguished name fields and values. For instance "CN=www.server.com, OU=test, C=US, [email protected]". Common fields and their meanings are displayed below.
Field | Meaning |
CN | Common Name. This is commonly a host name like www.server.com. |
O | Organization |
OU | Organizational Unit |
L | Locality |
S | State |
C | Country |
E | Email Address |
If a field value contains a comma it must be quoted.
The issuer of the Java Web Token.
string
""
The issuer of the Java Web Token. Enter the value of a delegated user Email Address.
This is not required when using the GOOGLEJSON OAuthJWTCertType. Google JSON keys contain a copy of the issuer account.
The issuer of the Java Web Token. Enter the value of a delegated user Email Address.
This is not required when using the GOOGLEJSON OAuthJWTCertType. Google JSON keys contain a copy of the issuer account.
The user subject for which the application is requesting delegated access.
string
""
The user subject for which the application is requesting delegated access. Enter the value of the Service Account Email.
The user subject for which the application is requesting delegated access. Enter the value of the Service Account Email.
This section provides a complete list of the SSL properties you can configure in the connection string for this provider.
Property | Description |
SSLServerCert | The certificate to be accepted from the server when connecting using TLS/SSL. |
The certificate to be accepted from the server when connecting using TLS/SSL.
string
""
If using a TLS/SSL connection, this property can be used to specify the TLS/SSL certificate to be accepted from the server. Any other certificate that is not trusted by the machine is rejected.
This property can take the following forms:
Description | Example |
A full PEM Certificate (example shortened for brevity) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
A path to a local file containing the certificate | C:\cert.cer |
The public key (example shortened for brevity) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
The MD5 Thumbprint (hex values can also be either space or colon separated) | ecadbdda5a1529c58a1e9e09828d70e4 |
The SHA1 Thumbprint (hex values can also be either space or colon separated) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
If not specified, any certificate trusted by the machine is accepted.
Use '*' to signify to accept all certificates. Note that this is not recommended due to security concerns.
This section provides a complete list of the Logging properties you can configure in the connection string for this provider.
Property | Description |
Verbosity | The verbosity level that determines the amount of detail included in the log file. |
The verbosity level that determines the amount of detail included in the log file.
string
"1"
The verbosity level determines the amount of detail that the Cloud reports to the Logfile. Verbosity levels from 1 to 5 are supported. These are detailed in the Logging page.
This section provides a complete list of the Schema properties you can configure in the connection string for this provider.
Property | Description |
BrowsableSchemas | This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC. |
ApiVersion | Specify the API version you want to use with UniversalAnalytics. |
This property restricts the schemas reported to a subset of the available schemas. For example, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
string
""
Listing the schemas from databases can be expensive. Providing a list of schemas in the connection string improves the performance.
Specify the API version you want to use with UniversalAnalytics.
string
"V4"
Set this property to V3 to use the Google Analytics v3 API or V4 to use the Google Analytics v4 API.
Note: ApiVersion is specific to UniversalAnalytics Schema only.
Note: ApiVersion v4 is not supported for these views Accounts, WebProperties, Segments, Profiles and Goals. So, the driver will make a request with V3 for mentioned views even if you have specified v4 in the ApiVersion connection property.
This section provides a complete list of the Miscellaneous properties you can configure in the connection string for this provider.
Property | Description |
DefaultFilter | A default filter to be applied to all queries. |
IgnorePermissionsException | Whether to ignore exceptions related to insufficient permissions for a specific profile. |
IncludeEmptyRows | This connection property can be set only when using the V4 API. If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows. |
MaxRows | Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses. |
Pagesize | The maximum number of results to return per page from Google Analytics. |
PropertyId | Property ID value to be used when querying reports views in V4 schema. |
PseudoColumns | This property indicates whether or not to include pseudo columns as columns to the table. |
ReportType | The type of Reports to get results in case of Events and ActiveUsers view. |
SamplingLevel | The desired sampling level. Can be set to run faster at the cost of accuracy or for higher accuracy but a decrease in query execution speed. Note: This property only applies when Schema is set to UniversalAnalytics. |
SupportEnhancedSQL | This property enhances SQL functionality beyond what can be supported through the API directly, by enabling in-memory client-side processing. |
Timeout | The value in seconds until the timeout error is thrown, canceling the operation. |
UseResourceQuotas | This connection property can be set only when using the V4 API. |
A default filter to be applied to all queries.
string
"EndDate='Today'"
A default filter to be applied to all queries. Convenient for setting default Dimensions, StartDate, EndDate, and Segments for all queries. These values will be overridden if set in the query. Example value: Dimensions='Year' AND EndDate='Today'
Whether to ignore exceptions related to insufficient permissions for a specific profile.
bool
false
Whether to ignore exceptions related to insufficient permissions for a specific profile.
This connection property can be set only when using the V4 API. If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows.
bool
true
Allowed Values:
TRUE | The provider includes the rows where all the retrieved metrics are equal to zero. |
FALSE | The provider does not include the rows where all the retrieved metrics are equal to zero. |
Note that it is still possible for no rows to be returned with this set to TRUE depending on the dimensions included in the query. This property will only work when the cardinality of the dimension is known over the date range (such as with the Date dimension). If the cardinality is unknown or not defined, such as with the ProductName dimension on the Ecommerce table, no results would be returned.
Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses.
int
-1
Limits the number of rows returned when no aggregation or GROUP BY is used in the query. This takes precedence over LIMIT clauses.
The maximum number of results to return per page from Google Analytics.
int
10000
The Pagesize property affects the maximum number of results to return per page from Google Analytics. Setting a higher value may result in better performance at the cost of additional memory allocated per page consumed.
Property ID value to be used when querying reports views in V4 schema.
string
""
Property ID value to be used when querying reports views in V4 schema.
This property indicates whether or not to include pseudo columns as columns to the table.
string
""
This setting is particularly helpful in Entity Framework, which does not allow you to set a value for a pseudo column unless it is a table column. The value of this connection setting is of the format "Table1=Column1, Table1=Column2, Table2=Column3". You can use the "*" character to include all tables and all columns; for example, "*=*".
The type of Reports to get results in case of Events and ActiveUsers view.
string
"RealtimeReports"
The ReportType available are RealtimeReports and Reports. For the Events and ActiveUsers view
RealtimeReports | Driver will use runRealtimeReport endpoint. |
Reports | Driver will use runReport endpoint. |
The desired sampling level. Can be set to run faster at the cost of accuracy or for higher accuracy but a decrease in query execution speed. Note: This property only applies when Schema is set to UniversalAnalytics.
string
"DEFAULT"
Allowed Values:
DEFAULT | Returns response with a sample size that balances speed and accuracy. |
FASTER | Available only when using the V3 API. Returns a fast response with a smaller sample size. |
HIGHER_PRECISION | Available only when using the V3 API. Returns a more accurate response using a large sample size, but this may result in the response being slower. |
SMALL | Similar to FASTER, but for the V4 API. |
LARGE | Similar to HIGHER_PRECISION, but for the V4 API. |
This property enhances SQL functionality beyond what can be supported through the API directly, by enabling in-memory client-side processing.
bool
true
When SupportEnhancedSQL = true, the Cloud offloads as much of the SELECT statement processing as possible to Google Analytics and then processes the rest of the query in memory. In this way, the Cloud can execute unsupported predicates, joins, and aggregation.
When SupportEnhancedSQL = false, the Cloud limits SQL execution to what is supported by the Google Analytics API.
The Cloud determines which of the clauses are supported by the data source and then pushes them to the source to get the smallest superset of rows that would satisfy the query. It then filters the rest of the rows locally. The filter operation is streamed, which enables the Cloud to filter effectively for even very large datasets.
The Cloud uses various techniques to join in memory. The Cloud trades off memory utilization against the requirement of reading the same table more than once.
The Cloud retrieves all rows necessary to process the aggregation in memory.
When SupportEnhancedSQL = true, the Cloud offloads as much of the SELECT statement processing as possible to Google Analytics and then processes the rest of the query in memory. In this way, the Cloud can execute unsupported predicates, joins, and aggregation.
When SupportEnhancedSQL = false, the Cloud limits SQL execution to what is supported by the Google Analytics API.
The Cloud determines which of the clauses are supported by the data source and then pushes them to the source to get the smallest superset of rows that would satisfy the query. It then filters the rest of the rows locally. The filter operation is streamed, which enables the Cloud to filter effectively for even very large datasets.
The Cloud uses various techniques to join in memory. The Cloud trades off memory utilization against the requirement of reading the same table more than once.
The Cloud retrieves all rows necessary to process the aggregation in memory.
The value in seconds until the timeout error is thrown, canceling the operation.
int
60
If Timeout = 0, operations do not time out. The operations run until they complete successfully or until they encounter an error condition.
If Timeout expires and the operation is not yet complete, the Cloud throws an exception.
This connection property can be set only when using the V4 API.
bool
false
If set to true, the provider will include the useResourceQuotas header in each request. This header will enable resource based quotas for a given request.