The Google Analytics step, which is located under the Input category in Spoon, allows you to access your Google analytics data to generate reports or to populate your data warehouse. It uses the Google Analytics 3.0 API.
The Google Analytics Query Explorer provides a dedicated website to developing and testing queries with the Google Analytics API, independently of a PDI transformation.
- You must have a Google Analytics account, and be an owner of the Analytics account that will be used.
- The Google Analytics step requires an API key. The method that we support involves generating a private key, creating a service account, and adding the service account's email as a user on your Google Analytics account. Here is how to do this.
- Go to http://console.developers.google.com and sign in with your credentials.
- In the Projects page, click Create Project, then when the New Project dialog appears, provide a project name and click Create.
- In the dashboard select Enable and Manage APIs.
- Search for Analytics API.
- Select Analytics API from the search results, then click the Enable API button.
- In the left menu pane, click Credentials, then click the Add Credentials button, and select Service Account.
- When prompted for a key type, select the P12 option, and click Create. Before the P12 file is downloaded you will be prompted to open or save the file. Save the file in a safe location. Saving the file is important because you can not download it again. You will also need to reference the path to this file when you fill out the Google Analytics step in Spoon.
- Copy the Service Account's Email Address (<random characters>@developer.gserviceaccount.com). You will paste it in another field later in these instructions.
- Go to http://google.com/analytics and sign in with your credentials.
- Click the Admin menu option, then click User Management.
- In the Add permissions for field, enter the Service Account's email address you copied previously. Make sure the user has, at minimum, the Read and Analyze permission.
| Application Name
|| Enter an application name such as "PDI" or leave the default.
|OAuth Service Email||Your Google Developer Service Account's Email Address (e.g. "<random firstname.lastname@example.org>").|
|Key file||The path to the P12 private key associated with your OAuth Service account.|
| Specify tableId directly
|| Check this option if you want to specify the tableId directly without getting the tableId from the profile.
| Get tableId from profile
|| Select the tableId from your profile.
|Start Date||Specifies the start date associated with the query. The date must be entered in the following format: YYYY-MM-DD.|
|End Date||Specifies the end date associated with the query. The date must be entered in the following format: YYYY-MM-DD.|
|Dimensions||Specifies the dimension fields for which you want to query. The Google Analytics API documentation provides you with a list of valid inputs and metrics that can be combined.|
|Metrics||Specifies the metrics fields you want returned. At least one metric must be provided.|
|Filters||Specifies the filter (described in the Google Analytics API documentation). Here is an example: 'ga:country==Algeria'.|
|Sort||Specifies a field on which to sort. Here is an example: 'ga:city'.|
|Specify a segment for the query||Allows you to specify a segment for the query. A segment is analogous to a database "view."|
| Use custom segment
|| Check this option, when you want to specify a custom segment. A segment is analogous to a database "view."
| Use predefined segment
|| Select from the predefined segments. A segment is analogous to a database "view."
Click Get Fields to retrieve a list of possible fields based on the query you defined.
Click Preview to preview data based on the defined query.
All fields of this step support metadata injection. You can use this step with ETL Metadata Injection to pass metadata to your transformation at runtime.