Google Analytics Data Model
- Views
- Accounts
- AccountSummaries
- Acquisitions
- AcquisitionsFirstUserCampaignReport
- AcquisitionsFirstUserGoogleAdsAdGroupNameReport
- AcquisitionsFirstUserGoogleAdsNetworkTypeReport
- AcquisitionsFirstUserMediumReport
- AcquisitionsFirstUserSourceMediumReport
- AcquisitionsFirstUserSourcePlatformReport
- AcquisitionsFirstUserSourceReport
- AcquisitionsSessionCampaignReport
- AcquisitionsSessionDefaultChannelGroupingReport
- AcquisitionsSessionMediumReport
- AcquisitionsSessionSourceMediumReport
- AcquisitionsSessionSourcePlatformReport
- AcquisitionsSessionSourceReport
- ActiveUsers
- DemographicAgeReport
- DemographicCityReport
- DemographicCountryReport
- DemographicGenderReport
- DemographicInterestsReport
- DemographicLanguageReport
- DemographicRegionReport
- Demographics
- EcommPurchasesItemBrandReport
- EcommPurchasesItemCategory2Report
- EcommPurchasesItemCategory3Report
- EcommPurchasesItemCategory4Report
- EcommPurchasesItemCategory5Report
- EcommPurchasesItemCategoryReport
- EcommPurchasesItemCategoryReportCombined
- EcommPurchasesItemIdReport
- EcommPurchasesItemNameReport
- Engagement
- EngagementContentGroupReport
- EngagementConversionsReport
- EngagementEventsReport
- EngagementPagesPathReport
- EngagementPagesTitleAndScreenClassReport
- EngagementPagesTitleAndScreenNameReport
- Events
- GamesReporting
- GlobalAccessObject
- MetaData
- Monetization
- MonetizationPublisherAdsAdFormatReport
- MonetizationPublisherAdsAdSourceReport
- MonetizationPublisherAdsAdUnitReport
- MonetizationPublisherAdsPagePathReport
- Properties
- PropertiesDataStreams
- PropertiesFireBaseLinks
- PropertiesGoogleAdsLinks
- Tech
- TechAppVersionReport
- TechBrowserReport
- TechDeviceCategoryReport
- TechDeviceModelReport
- TechOSSystemReport
- TechOSVersionReport
- TechPlatformDeviceCategoryReport
- TechPlatformReport
- TechScreenResolutionReport
In this article
- Views
- Accounts
- AccountSummaries
- Acquisitions
- AcquisitionsFirstUserCampaignReport
- AcquisitionsFirstUserGoogleAdsAdGroupNameReport
- AcquisitionsFirstUserGoogleAdsNetworkTypeReport
- AcquisitionsFirstUserMediumReport
- AcquisitionsFirstUserSourceMediumReport
- AcquisitionsFirstUserSourcePlatformReport
- AcquisitionsFirstUserSourceReport
- AcquisitionsSessionCampaignReport
- AcquisitionsSessionDefaultChannelGroupingReport
- AcquisitionsSessionMediumReport
- AcquisitionsSessionSourceMediumReport
- AcquisitionsSessionSourcePlatformReport
- AcquisitionsSessionSourceReport
- ActiveUsers
- DemographicAgeReport
- DemographicCityReport
- DemographicCountryReport
- DemographicGenderReport
- DemographicInterestsReport
- DemographicLanguageReport
- DemographicRegionReport
- Demographics
- EcommPurchasesItemBrandReport
- EcommPurchasesItemCategory2Report
- EcommPurchasesItemCategory3Report
- EcommPurchasesItemCategory4Report
- EcommPurchasesItemCategory5Report
- EcommPurchasesItemCategoryReport
- EcommPurchasesItemCategoryReportCombined
- EcommPurchasesItemIdReport
- EcommPurchasesItemNameReport
- Engagement
- EngagementContentGroupReport
- EngagementConversionsReport
- EngagementEventsReport
- EngagementPagesPathReport
- EngagementPagesTitleAndScreenClassReport
- EngagementPagesTitleAndScreenNameReport
- Events
- GamesReporting
- GlobalAccessObject
- MetaData
- Monetization
- MonetizationPublisherAdsAdFormatReport
- MonetizationPublisherAdsAdSourceReport
- MonetizationPublisherAdsAdUnitReport
- MonetizationPublisherAdsPagePathReport
- Properties
- PropertiesDataStreams
- PropertiesFireBaseLinks
- PropertiesGoogleAdsLinks
- Tech
- TechAppVersionReport
- TechBrowserReport
- TechDeviceCategoryReport
- TechDeviceModelReport
- TechOSSystemReport
- TechOSVersionReport
- TechPlatformDeviceCategoryReport
- TechPlatformReport
- TechScreenResolutionReport
Google Analytics is a web analytics service provided by Google that allows website owners to track and analyze various aspects of their website’s performance and user interactions.
The Google Analytics connector models the Google Analytics 4 API as as relational tables and views.
The provided tables give you an overview of your account information and the profiles available for Google Analytics queries.
Google Analytics supports the querying of Dimensions and Metrics in a large number of arrangements. Some sample views are provided based on common Google Analytics reports.
Views
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.
Date Ranges and Aggregation
Date Ranges You can specify date ranges in the WHERE clause using the “Date” field with these operators: =, <,>
Additional predefined date fields are available:
- week
- month
- quarter
When filtering on these time intervals, you can use the = operator, specifying the date of first day of the time period. If you specify a different date, an error is returned. For example, to specify the month of May in the year 2022, use the following, specifying the first day of that month:
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:
Date: returns daily data in the query results.
Hour: returns data aggregated by hour across the specified date range. For example, querying two years worth of data and selecting “Hour” returns 24 rows of data (one for each hour) with two years data aggregated for each hour.
Day: returns data aggregated by da across the specified date range. For example, querying two years worth of data and selecting “Day” returns seven rows of data (one for each day) with two years data aggregated for each day
Week: returns data aggregated by week across the specified date range. For example, querying two years worth of data and selecting “Week” returns 104 rows of data (one for each week) with data aggregated for each week
Month: returns data aggregated by month across the specified date range. For example, querying two years worth of data and selecting “Month” returns 24 rows of data (one for each month) with data aggregated for each month.
Year: returns data aggregated by year across the specified date range. For example, querying two years worth of data and selecting “Year” returns two rows of data (one for each year) with data aggregated by year.
NOTE: choosing “Date” as a metric overrides any other date metric you select. Only daily data is returned.
Accounts
Lists all Accounts to which the user has access.
Table Specific Information
Select
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.
Columns
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 |
AccountSummaries
Lists summaries of all Accounts to which the user has access.
Table Specific Information
Select
The AccountSummaries table exposes summaries of all accounts accessible by the caller. The following query is processed server-side:
SELECT * FROM AccountSummaries
Columns
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. |
Acquisitions
A base view that retrieves Acquisitions data.
Table Specific Information
Select
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.
Columns
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 time zone 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-Columns
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. |
AcquisitionsFirstUserCampaignReport
A predefined view that retrieves Acquisitions first user Campaign data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserGoogleAdsAdGroupName supports the following operator: =
- Date supports the following 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.
Columns
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-Columns
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. |
AcquisitionsFirstUserGoogleAdsAdGroupNameReport
A predefined view that retrieves user Acquisitions first user Google Ads ad group name data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserGoogleAdsAdGroupName supports the following operator: =
- Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsFirstUserGoogleAdsNetworkTypeReport
A predefined view that retrieves Acquisitions first user Google Ads ad network type platform data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserGoogleAdsNetworkType supports the following operator: =
- Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsFirstUserMediumReport
A predefined view that retrieves Acquisitions first user medium data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserMedium supports the following operator: =
- Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsFirstUserSourceMediumReport
Usage information for the operation AcquisitionsFirstUserSourceMediumReport.rsd.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserGoogleAdsAdGroupName supports the following operator: =
- Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsFirstUserSourcePlatformReport
A predefined view that retrieves Acquisitions first user source platform data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
- PropertyId supports the following operator: =
- FirstUserSourcePlatform supports the following operator: =
- Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsFirstUserSourceReport
A predefined view that retrieves Acquisitions first user source data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
FirstUserSource supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsSessionCampaignReport
A predefined view that retrieves Acquisitions session campaign report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
SessionDefaultChannelGrouping supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsSessionDefaultChannelGroupingReport
A predefined view that retrieves Acquisitions session default channel grouping report data.
Columns
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-Columns
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. |
AcquisitionsSessionMediumReport
A predefined view that retrieves Acquisitions session medium report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
SessionMedium supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsSessionSourceMediumReport
A predefined view that retrieves Acquisitions session source medium report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsSessionSourcePlatformReport
A predefined view that retrieves Acquisitions session source platform report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
AcquisitionsSessionSourceReport
A predefined view that retrieves Acquisitions session source report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
ActiveUsers
A base view that retrieves Active Users data.
Table Specific Information
Select
Retrieves data for ActiveUsers report. 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 the standard nine for the standard report API.
The following is an example query:
SELECT ActiveUsers, Platform FROM ActiveUsers
Columns
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-Columns
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. |
DemographicAgeReport
A predefined view that retrieves Demographics UserAgeBracket data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
UserAgeBracket supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
DemographicCityReport
A predefined view that retrieves Demographics City data.
Columns
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-Columns
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. |
DemographicCountryReport
A predefined view that retrieves Demographics Country data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
Country supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
DemographicGenderReport
A predefined view that retrieves Demographics UserGender data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
UserGender supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
DemographicInterestsReport
A predefined view that retrieves Demographics BrandingInterest data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
BrandingInterest supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
DemographicLanguageReport
A predefined view that retrieves Demographics Language data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
Language supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
DemographicRegionReport
A predefined view that retrieves Demographics Region data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the ‘=’ operator.
Region supports the ‘=’ operator.
Date supports the ‘=,>=,<=,<,>’ 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 connector.
Columns
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-Columns
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. |
Demographics
A base view that retrieves Demographics data.
Table Specific Information
Select
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
Columns
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 time zone 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-Columns
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. |
EcommPurchasesItemBrandReport
A predefined view that retrieves Ecommerce purchase item brand data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemBrand supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategory2Report
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory2 supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategory3Report
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory3 supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategory4Report
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory4 supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategory5Report
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory5 supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategoryReport
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemCategoryReportCombined
A predefined view that retrieves Ecommerce purchase item category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemCategory supports the following operator: =
ItemCategory2 supports the following operator: =
ItemCategory3 supports the following operator: =
ItemCategory3 supports the following operator: =
ItemCategory5 supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemIdReport
A predefined view that retrieves Ecommerce purchase item data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemId supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EcommPurchasesItemNameReport
A predefined view that retrieves Ecommerce purchase item data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ItemName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
Engagement
A base view that retrieves Engagement data
Table Specific Information
Select
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
Columns
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 time zone 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-Columns
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 |
EngagementContentGroupReport
A predefined view that retrieves Engagement Content Group Report data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ContentGroup supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EngagementConversionsReport
A predefined view that retrieves Engagement conversions data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
EventName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EngagementEventsReport
A predefined view that retrieves Engagement events data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
EventName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EngagementPagesPathReport
A predefined view that retrieves Engagement Pages path report data.
Columns
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-Columns
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. |
EngagementPagesTitleAndScreenClassReport
A predefined view that retrieves Engagement Pages title and screen class data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
UnifiedScreenClass supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
EngagementPagesTitleAndScreenNameReport
A predefined view that retrieves Engagement Pages Title And ScreenName data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
UnifiedScreenName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
Events
A base view that retrieves Event data
Table Specific Information
Select
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.
Columns
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-Columns
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. |
GamesReporting
A base view that retrieves Games Reporting data.
Table Specific Information
Select
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
Columns
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 time zone 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-Columns
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. |
GlobalAccessObject
Retrieves data for all the available dimensions and metrics.
Columns
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 time zone. | ||
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). |
MetaData
Retrieves metadata information for standard and custom dimensions or metrics.
Table Specific Information
Select
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
Columns
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. |
Monetization
A base view that retrieves Monetization data.
Table Specific Information
Select
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
Columns
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 time zone 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-Columns
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. |
MonetizationPublisherAdsAdFormatReport
A predefined view that retrieves publisher ads page ad format data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
AdFormat supports the following operator: =
Date supports the following 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 connector.
Columns
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 publishers site. | |
TotalAdRevenue | Integer | False | True | Sum of all advertising revenue. |
Pseudo-Columns
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. |
MonetizationPublisherAdsAdSourceReport
A predefined view that retrieves publisher ads ad source data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
AdSourceName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
MonetizationPublisherAdsAdUnitReport
A predefined view that retrieves publisher ads ad unit data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
AdUnitName supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
MonetizationPublisherAdsPagePathReport
A predefined view that retrieves publisher ads page path data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
PagePath supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
Properties
Lists all Properties to which the user has access.
Table Specific Information
Select
The provider will use the GoogleAnalytics4 API to process WHERE clause conditions built with the following columns and operators: The rest of the filter is executed client-side within the provider.
Parent supports the following operators: =,IN
Id supports the following operators: =,IN
The following queries are processed server-side:
SELECT * FROM Properties WHERE Id = '54516992'
SELECT * FROM Properties WHERE Parent = 'accounts/54516992'
Columns
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. |
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.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
Parent supports the following operator: =
Name supports the following operator: =
The Name or Parent is required to make a request. For example, the following queries are processed server-side:
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 connector.
Columns
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. |
PropertiesFireBaseLinks
Lists all FirebaseLinks on a property to which the user has access.
Table Specific Information
Select
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'
Columns
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. |
PropertiesGoogleAdsLinks
Lists all GoogleAdsLinks on a property to which the user has access.
Table Specific Information
Select
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.
Columns
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. |
Tech
A base view that retrieves Tech data.
Table Specific Information
Select
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
Columns
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 time zone 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-Columns
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. |
TechAppVersionReport
A predefined view that retrieves Tech App Version data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
AppVersion supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechBrowserReport
A predefined view that retrieves Tech Browser data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
Browser supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechDeviceCategoryReport
A predefined view that retrieves Tech Device Category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
DeviceCategory supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechDeviceModelReport
A predefined view that retrieves Tech Device Model data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
DeviceModel supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechOSSystemReport
A predefined view that retrieves Tech os system data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
OperatingSystem supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechOSVersionReport
A predefined view that retrieves Tech Os version data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
OperatingSystemVersion supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechPlatformDeviceCategoryReport
A predefined view that retrieves Tech platform device category data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
Platform supports the following operator: =
Date supports the following operator: =
DeviceCategory supports the following 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 connector.
Columns
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-Columns
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. |
TechPlatformReport
A predefined view that retrieves Tech platform data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
OperatingPlatformSystem supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
TechScreenResolutionReport
A predefined view that retrieves Tech Screen Resolution data.
Select
The connector uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
PropertyId supports the following operator: =
ScreenResolution supports the following operator: =
Date supports the following 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 connector.
Columns
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-Columns
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. |
If you have any feedback on Gathr documentation, please email us!