| description |
|---|
Step-by-step guide to ingest your Google Analytics data into RudderStack |
Google Analytics is the world's most popular analytics service that allows you to track and report your website traffic across a variety of sources. It lets you measure your advertising ROI, as well as set up tracking code to perform data collection based on the type of your website.
This document guides you in setting up Google Analytics as a source in RudderStack. Once configured, RudderStack automatically ingests your specified Google Analytics data, which can then be routed to your data warehouse destination supported by RudderStack.
{% hint style="info" %} All the Cloud Extract sources support sending data only to a data warehouse destination. {% endhint %}
To add Google Analytics as a source in RudderStack, follow these steps:
- Log into your RudderStack dashboard.
- From the left panel, select Sources. Then, click on Add Source, as shown:
- Next, select Google Analytics from the list of Cloud Sources, and click on Next.
- Assign a name to your source, and click on Next.
- Click on Connect with Google Analytics and give RudderStack the required access permissions. Then, click on Next.
{% hint style="info" %} If you have already connected RudderStack to your Google Analytics account, your credentials should appear automatically under Use existing credentials. {% endhint %}
- In the next screen, select one of your Google Analytics views in the Source Settings. Then, click on Next.
- Once you select a view, the Dimensions and Metrics rows should appear automatically. Choose the appropriate dimensions and metrics for RudderStack to ingest the data from, and then click Next.
{% hint style="warning" %} Not all Dimensions and Metrics can be queried together. Only those dimensions and metrics combinations that follow Google’s compatibility rules can be used for querying. Read the Valid Dimensions and Metrics section below for more information. {% endhint %}
{% hint style="warning" %} The Dimensions and Metrics combination cannot be changed after the source is created and saved. The primary key that RudderStack creates depends on your choices during the source configuration. {% endhint %}
{% hint style="info" %} If a combination of Dimensions and Metrics chosen by you is invalid, RudderStack will notify you. {% endhint %}
- Next, you will be required to set the Run Frequency to schedule the data import from your Google Analytics account to RudderStack. You can also specify the time when you want this synchronization to start, by choosing the time under the Sync Starting At option.
That's it! Google Analytics is now successfully configured as a source on your RudderStack dashboard.
RudderStack will start importing data from Google Analytics as per the specified frequency. You can further connect this source to your data warehouse by clicking on Connect Destinations or Add Destinations, as shown:
{% hint style="success" %} Use the Connect Destinations option if you have already configured a data warehouse destination in RudderStack. To configure a data warehouse destination from scratch, click on the Add Destination button. {% endhint %}
Not all the dimensions and metrics can be queried together in Google Analytics. Only those dimensions-metrics combinations that follow Google's compatibility rules can be used together for querying.
{% hint style="success" %} Check out the valid combinations in the Google Dimensions & Metrics Explorer. {% endhint %}
Google also has a limit on the number of dimensions and metrics that you can define.
{% hint style="info" %} Read more about these limits in Google's Core Reporting API documentation. {% endhint %}
Yes, it is.
We have implemented a feature wherein RudderStack associates a table prefix for every Cloud Extract source writing to a warehouse schema. This way, multiple Cloud Extract sources can write to the same schema with different table prefixes.
If you come across any issues while configuring Google Analytics as a source on the RudderStack dashboard, please feel free to contact us. You can also start a conversation on our Slack channel; we will be happy to talk to you!