# Google Analytics properties

Properties to configure to establish a connection to Google Analytics.

Google Analytics is unidirectional and can only be used as a source dataset in your pipeline.

## Google Analytics connection

Select Google Analytics in the list and configure the connection.

## Configuration

Select your engine from the list and set the main and advanced settings.

Main settingsMain settings

| Property | Configuration |
| --- | --- |
| Google credentials | Paste the content of the JSON file that contains your service account<br>key. To know more about the Google Cloud authentication process, read [the Google Cloud documentation](https://cloud.google.com/docs/authentication/getting-started). |

After configuring the connection, give it a display name (mandatory) and a description (optional).

## Google Analytics dataset

Dataset configurationDataset configuration

| Property | Configuration |
| --- | --- |
| Dataset name | Enter a<br>display name for the dataset. This name will be used as a unique identifier of<br>the dataset in all Talend Cloud apps. |
| Connection | Select<br>your connection in the list. If you are creating a dataset based on an existing<br>connection, this field is read-only. |

Main settingsMain settings

| Property | Configuration |
| --- | --- |
| View ID | Select or enter the unique View ID for retrieving Analytics data. This<br>identifier can be found in your account under Admin &gt; VIEW &gt; View Settings. |
| Date range | Select or enter the start and end dates corresponding to the report you<br>want to retrieve. |
| Dimensions | Select or enter the name of the dimension you want to use.<br><br>Example:<br>Landing Page(ga:landingPagePath)<br><br>For more<br>information, see [the Google Analytics<br>documentation](https://ga-dev-tools.web.app/dimensions-metrics-explorer/). |
| Metrics | Select or enter the name of the metrics you want to use.<br><br>Example:<br>Sessions (ga:sessions)<br><br>For more<br>information, see [the Google Analytics<br>documentation](https://ga-dev-tools.web.app/dimensions-metrics-explorer/). |

Advanced settingsAdvanced settings

| Property | Configuration |
| --- | --- |
| Read timeout | Enter the read timeout value in milliseconds. An exception will occur if<br>the waiting time expires before there is data available to read. |
| Advanced metrics | <ul> <li><span>Expression</span>: Select or enter the expression                              corresponding to the metrics you want to use. <p>Example:                                    <kbd>ga:sessions*100</kbd></p></li> <li><span>Alias</span>: Specify an alias for the previously                              defined expression. The alias will help you reuse this expression in a                              filter clause.<p>Example:                                    <kbd>custom_session_metrics</kbd></p></li> <li><span>Formatting type</span>: Enter or select the format                              data type of the metrics.<p>Example:                                 <kbd>INTEGER</kbd></p></li> </ul> |
| Dimension filter clauses | Define your custom filter clause in JSON format. You can use the alias<br>defined previously in this clause.<br><br>For more information on the syntax of<br>these clauses, see [the Google Analytics<br>documentation](https://ga-dev-tools.web.app/dimensions-metrics-explorer/). |
| Metric filter clauses | Define your custom metric clause in JSON format. You can use the alias<br>defined previously in this clause.<br><br>For more information on the syntax of<br>these clauses, see [the Google Analytics<br>documentation](https://ga-dev-tools.web.app/dimensions-metrics-explorer/). |
| Filter expression | Enter your filter expression. |

## Google Analytics source configuration

When Google Analytics is used as a source dataset in your pipeline, you can select some options that will be performed while passing the data to the next step of the pipeline:

| Property | Configuration |
| --- | --- |
| Use resource quotas | Enable this option to enable customers of Analytics 360 accounts to have<br>higher sampling thresholds.<br><br>For more information on the syntax of these<br>clauses, see the [Google Analytics documentation](https://developers.google.com/analytics/devguides/reporting/core/v4/resource-based-quota). |
| Include empty rows | Enable this option to include in the response the rows where all metric<br>values are zero. |