Google Analytics Ingestion Source

See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Google Analytics connector.

In Gathr, it can be added as a channel to help in fetching customers’ and prospects’ data and transform it as needed before storing it in a desired data warehouse to run further analytics.

Data Source Configuration #

Configure the data source parameters as explained below.

Fetch From Source/Upload Data File #

To design the application, you can either fetch the sample data from the Google Analytics source by providing the data source connection details or upload a sample data file in one of the supported formats to see the schema details during the application design phase.

Upload Data File #

To design the application, please upload a data file containing sample records in a format supported by Gathr.

The sample data provided for application design should match the data source schema from which data will be fetched during runtime.

If Upload Data File method is selected to design the application, provide the below details.

File Format #

Select the format of the sample file depending on the file type.

Gathr-supported file formats for Google Analytics data sources are CSV, JSON, TEXT, Parquet and ORC.

For CSV file format, select its corresponding delimiter.

Header Included #

Enable this option to read the first row as a header if your Google Analytics sample data file is in CSV format.

Upload #

Please upload the sample file as per the file format selected above.

Fetch From Source #

If Fetch From Source method is selected to design the application, then the data source connection details will be used to get sample data.

Continue to configure the data source.

Connection Name #

Connections are the service identifiers. A connection name can be selected from the list if you have created and saved connection details for Google Analytics earlier. Or create one as explained in the topic - Google Analytics Connection →

Use the Test Connection option to ensure that the connection with the Google Analytics channel is established successfully.

A success message states that the connection is available. In case of any error in test connection, edit the connection to resolve the issue before proceeding further.

Entity #

Tables in Google Analytics are statically defined to model Google Analytics entities.

If you selected the Fetch From Source method to design the application, the Entities will list as per the configured connection. Select the entity to be read from Google Analytics.

If you selected the Upload Data File method to design the application, the exact name of the entity should be provided to read the data from Google Analytics.

If you selected the Fetch From Source method to design the application, the Fields would list as per the Entity chosen in the previous configuration parameter. Select the fields or provide a custom query to read the desired records from Google Analytics.

Fields #

The conditions to fetch source data from a Google Analytics table can be specified using this option.

Select Fields: Select the column(s) of the entity that should be read.

Custom Query: Provide an SQL query specifying the read conditions for the source data.

Example: SELECT "Id" FROM Companies

If you selected the Upload Data File method to design the application, provide a custom query to fetch records from the Google Analytics entity specified in the previous configuration.

Query #

The conditions to fetch source data from a Google Analytics table can be specified using this option.

Provide an SQL query specifying the read conditions for the source data.

Example: SELECT "Id" FROM Companies

Read Options #

This section contains additional read options.

API Version #

Specify the API version to use.

Property ID #

Property ID value to be used when querying reports views in V4 schema.

Partitioning #

This section contains partitioning-related configuration parameters.

Enable Partitioning #

This enables parallel reading of the data from the entity.

Partitioning is disabled by default.

If enabled, an additional option will appear to configure the partitioning conditions.

Column #

The selected column will be used to partition the data.

Max Rows per Partition: Enter the maximum number of rows to be read in a single request.

Example: 10,000

It implies that a maximum number of 10,000 rows can be read in one partition.

Advanced Configurations #

This section contains additional configuration parameters.

Fetch Size #

The fetch size determines the number of rows to be fetched per round trip. The default value is 1000.

Include Empty Rows #

This connection property can be set only when using the V4 API.

If set to false, the provider does not include rows if all the retrieved metrics are equal to zero.

The default is true which will include these rows.

Use Resource Quotas #

If set to true, the provider will include the Use Resource Quotas header in each request.

This header will enable resource based quotas for a given request.

Support Enhanced SQL #

When enabled, the system offloads as much of the SELECT statement processing as possible to Google Analytics and then processes the rest of the query in memory.

In this way, the connector can execute unsupported predicates, joins, and aggregation.

When disabled, the system limits SQL execution to what is supported by the Google Analytics API.

Ignore Permissions Exception #

Whether to ignore exceptions related to insufficient permissions for a specific profile.

Default Filter #

A default filter to be applied to all queries.

Convenient for setting default Dimensions, StartDate, EndDate, and Segments for all queries.

These values will be overridden if set in the query.

Example: Dimensions=‘Year’ AND EndDate=‘Today’.

Add Configuration: Additional properties can be added using this option as key-value pairs.

Schema #

Check the populated schema details. For more details, see Schema Preview →