When to use this connector
Etlworks Integrator can extract data from the Google Analytics API.
Read how to extract data from Google Analytics.
Creating a connection
To work with Google Analytics, you will need to create a connection. In the Connections window, click the +
button and type in google analytics
in the search field. Select the Google Analytics connection from the gallery.
Authentication
To connect to specific Google service you are either going to be using the OAuth2 authentication (default) or the authentication with a Google Service Account.
OAuth2 authentication
To connect to the Google service using OAuth2 protocol you will need to select OAuth2 as an Authentication type and click Sign in with Google. Read more about OAuth2 authentication with Google Services.
Authentication using Google Service account
To connect to the Google service using the service account select the Service Account as an Authentication type. Then authorize the service account to access the specific property ID.
Parameters for authenticating with Google Service Account
- Service Account Email - a service account email must be authorized by the web property owner in Google Analytics Admin. Read about Google Service account email. The default is
etl-framework@api-project-201080624425.iam.gserviceaccount.com
- Service Account - You can create your own service account in the Google API console, authorize it in Google Analytics Admin, and add it to this connection. If nothing is entered in this field the default account, linked to the email
etl-framework@api-project-201080624425.iam.gserviceaccount.com
will be used.
Connection parameters
- Web property URL - the web property URL exactly as it is configured in the Google Analytics console. For example, www.etlworks.com
- or View ID - a view ID for the web property. It can be seen in Google Analytics Admin. Web property URL and View ID are mutually exclusive.
- Start Date - A start date for the request, formatted as
YYYY-MM-DD
, or as a relative date (e.g.,today
,yesterday
, orNdaysAgo
where N is a positive integer). - End Date - An end date for the request, formatted as
YYYY-MM-DD
, or as a relative date (e.g.,today
,yesterday
, orNdaysAgo
where N is a positive integer). - Dimensions - Google Analytics dimensions to be included in the report. You can include multiple dimensions in the request. Read more about the dimensions here. If a dimension is not on the list - simply type in the dimension name, for example,
ga:dimension6
and clickEnter
.Enter the dimension's name exactly as in the dimensions and metrics explorer, including using the
ga:
prefix and capitalization. - Metrics - Google Analytics metrics to be included in the report. You can include multiple metrics in the request. Read more about the metrics here. If a metric is not on the list - simply type in the metric name, for example,
ga:metric7
and clickEnter
.Enter the metric's name exactly as in the dimensions and metrics explorer, including usage of the
ga:
prefix and capitalization. - Filter - the
filters
query string parameter restricts the data returned from the request. Example: qa:browser==Firefox. Read more about filters. In Integrator you should not be URL-encoding filters. - Timeout - the request timeout in minutes. The default value is 3 minute. If request is talking longer than configured or default value it will be automatically aborted.
- Number of Retries - number of retries if the HTTP call was not successful. The maximum allowed number of retries is 10. The default is 0.
- Delay between retries - delay in milliseconds between retries if the HTTP call was not successful. The maximum allowed delay is 5 minutes (300000 milliseconds). The default is 0.
Comments
0 comments
Please sign in to leave a comment.