Google Analytics MCF

Guide to integrate your Google Analytics MCF with Sprinkle

Datasource Concepts

Before setting up the datasource, learn about datasource concepts here

Step by Step Guide

STEP-1: Configure Connection

To learn about Connection, refer here

• Log into Sprinkle application

• Navigate to Datasources -> Connections Tab -> New Connection ->

• Select Google Analytics MCF

• Provide all the mandatory details

  • Name: Name to identify this connection

  • Connect to Google

  • Advance Settings: Refer here

• After pressing Connect to Google, you will see authorise screen to allow permissions required for sprinkle to read data. Press Allow

• Test Connection

• Create

STEP-2: Configure Datasource

To learn about datasource, refer here

• Navigate to Datasources -> Datasources Tab -> Add ->

• Select Google Analytics MCF

• Provide the name -> Create

• Connection Tab:

  • From the drop-down, select the name of connection created in STEP-2

  • Update

STEP-3: Create Dataset

Datasets Tab: To learn about Dataset, refer here. Add Dataset for each report/dataset that you want to integrate, providing following details

• Account Id (Required) : GA Account

• View Id (Required) : Select Project/View available in this account

• Metrics (Required) : Select upto 10 metrics

• Dimensions (Optional) : Select upto 7 dimensions to aggregate your metrics on

• Start Date (Required) : Pull the data from this date: Format is YYYY-MM-DD

• Destination Schema (Required) : Data warehouse schema where the table will be ingested into

• Destination Table name (Required) : It is the table name to be created on the warehouse. If not given, sprinkle will create like ds_<datasourcename>_<tablename>

• Destination Create Table Clause: Provide additional clauses to warehouse-create table queries such as clustering, partitioning, and more, useful for optimizing DML statements. Learn more on how to use this field.
• Create

STEP-4: Run and schedule Ingestion

In the Ingestion Jobs tab:

• Trigger the Job, using Run button

• To schedule, enable Auto-Run. Change the frequency if required

Advanced Connection Settings

• API Read Timeout (In seconds) : Maximum time of inactivity between two data packets when waiting for the server's response. The default value is 30 seconds.

• API Connection Timeout (In seconds) : Time period within which a connection between a client and a server must be established.

• Retry Limit : Number of retries allowed when an API call fails. For example if an API call fails and retry limit is 5 then it will check 5 times for that API call and if it succeeded then it will stop checking.

• Retry Sleep Time (In milliseconds) :Given time, after which retry should happen in case an API call fails.

• Incremental Batch Size (In days) : No. of days in one batch for which data is being downloaded during incremental ingestion.

• Version : It gives information about the version of Google Analytics MCF API being used.

• Max Records : Field sets the max limit on the number of records that can be downloaded during each API call.

Dataset Fields

All the datasets can have following fields.

• mcf_firstImpressionConversions

• mcf_firstImpressionValue

• mcf_impressionAssistedConversions

• mcf_impressionAssistedValue

• mcf_totalConversions

• mcf_totalConversionValue

• mcf_assistedConversions

• mcf_assistedValue

• mcf_firstInteractionConversions

• mcf_firstInteractionValue

• mcf_lastInteractionConversions

• mcf_lastInteractionValue

• event_date