CData Python Connector for Google Analytics

Build 23.0.8839

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.

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839