---
schema_version: "1"
id: 90d276dc7e676f55bf1b00d3068c9de4ffcc187aee58070c5aafc8ab7e133b6c
title: Google Analytics 4 Connection
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/bi_integrate_connectors_ga4_settings.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.bi_integrate_connectors_ga4_settings.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8609eb3dc62f15461d5ea973483d033ff1b84a33ddcfac53d620679b69edce83
description: Create a remote connection using the Google Analytics 4 connector to sync Google Analytics data to CRM Analytics.
products:
  - CRM Analytics
  - Cross Cloud
release: "264"
---
# Google Analytics 4 Connection

Create a remote connection using the Google Analytics 4 connector to sync Google Analytics data to CRM Analytics.

## Create the Connection

1. On the Data Manager Connections tab, click **New Connection**.
2. Click the name of the connector, and click **Next**.
3. Enter the connector settings.
4. To validate your settings and attempt to connect to the source, click **Save & Test**. If the connection fails, CRM Analytics shows possible reasons.

## Connection Details

Use a Google service account instead of a user account to grant access to your Google Analytics data. For more information, see [Understanding Service Accounts](https://cloud.google.com/iam/docs/understanding-service-accounts).

Generate a JSON file containing the required client email and private key from the IAM & Admin page in the Google Cloud Platform Console.

## Connection Settings

All settings require a value, unless otherwise indicated.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20124e94">Setting</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20124e97">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e94 ">Connection Name</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e97 ">Identifies the connection. Use a naming convention that lets you easily
              distinguish between different connections.</td>

          </tr>
          <tr class="">
            <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e94 ">Developer Name</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e97 ">API name for the connection. This name can’t include spaces. The API name is
              used in your recipes to reference data extracted through this connection. You can’t
              change the name after you create the connection.</td>

          </tr>
          <tr class="">
            <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e94 ">Description</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e97 ">Description of the connection for internal use.</td>

          </tr>
          <tr class="">
            <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e94 ">Client Email</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e97 ">Enter the <code>client_email</code> value from the JSON
              file.</td>

          </tr>
          <tr class="">
            <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e94 ">Private Key</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e97 ">
              <p>Enter the <code>private_key</code> value from the JSON
                file.</p>
              <p style="margin-bottom:0;">Don’t include <code>"private_key": "-----BEGIN
                    PRIVATE KEY-----"</code> at the start of the key and <code>\n-----END PRIVATE KEY-----\n"</code> at the
                end.</p>
            </td>

          </tr>
        </tbody>
      </table>

## Advanced Object Properties

Each time you connect to an object with a Google Analytics connection, you also provide advanced properties for the object. The Google Analytics Data API uses these properties to query the object in Google Analytics. All settings require a value.

![Screenshot of advanced object properties dialog](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/resources-global/analytics/images/bi_integrate_connectors_ga4_advanced_properties.png)

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:30.747922437673132%">
          <col style="width:69.25207756232686%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20124e196">Property</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20124e199">Value</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e196 ">StartDate</td>

            <td data-label="Value" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e199 ">
              <p>The start date of the date range that you want to sync.</p>
              <p style="margin-bottom:0;">Enter
                <kbd>YYYY-MM-DD</kbd>, or use a relative date keyword, such as
                <kbd>today</kbd>, <kbd>yesterday</kbd>, or
                <kbd><var>N</var>daysAgo</kbd>, where <var>N</var>
                is a positive integer.
              </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e196 ">EndDate</td>

            <td data-label="Value" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e199 ">
              <p>The end date of the date range that you want to sync.</p>
              <p style="margin-bottom:0;">Enter
                <kbd>YYYY-MM-DD</kbd>, or use a relative date keyword, such as
                <kbd>today</kbd>, <kbd>yesterday</kbd>, or
                <kbd><var>N</var>daysAgo</kbd>, where <var>N</var>
                is a positive integer.
              </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e196 ">PropertyID</td>

            <td data-label="Value" class="slds-cell-wrap" style="vertical-align:top;" headers="d20124e199 ">The Property ID for the Google Analytics account, which determines which data
              is available for sync. You can find the Property ID on the Admin page in Google
              Analytics. For more information, see <a href="https://support.google.com/analytics/answer/12813202?sjid=16291957840434579688-NA" target="_blank">[GA4] Navigate to your account and
                property</a>.</td>

          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_note.png)

Note For more information about supported StartDate and EndDate values, see Google’s [Analytics Data API Overview](https://developers.google.com/analytics/devguides/reporting/data/v1).

## Google Analytics 4 Connector Considerations

Keep these considerations in mind when working with the Google Analytics 4 connector.

- A connected object name must start with a letter and can contain only letters, digits, or underscores. The name can’t end with an underscore.
- The connector can sync up to 10 million rows or 5 GB per object, whichever limit is reached first.
- Custom fields aren’t supported.
- Google Analytics stores your website data as a binary large object (blob). It uses SQL views to query the blob to create virtual objects that you can connect to.
- Knowledge of Google Analytics Data API is necessary when selecting which virtual objects to connect to. Google Analytics Data API rules for allowed object and metric interactions, described in [Dimensions & Metrics Explorer](https://ga-dev-tools.google/ga4/dimensions-metrics-explorer/), impact connecting to CRM Analytics. When troubleshooting, use the [Google Analytics Query Explorer](https://ga-dev-tools.google/ga4/query-explorer/) to confirm that the fields that you intend to query are valid.
- You can select up to 9 dimensions for each virtual object that you connect to per connection. Create another connection with the same properties to add more dimensions.
- You can sync up to one million rows for each virtual object. To sync more than one million rows for an object, consider using the Google BigQuery connector.
- Some tables have special conditions. For more information, see [GoogleAnalytics4 Data Model](https://cdn.cdata.com/help/DAH/jdbc/pg_GoogleAnalytics4model.htm).
- Your Google service account must be set up and enabled to work for this connector.
    - Set up OAuth 2.0 for service accounts with [Using OAuth 2.0 for Server to Server Applications](https://developers.google.com/identity/protocols/oauth2/service-account).
    - Save the credentials created by this process. The credentials are used for the GA4 Connector Private Key setting.
    - Add your service account to your Google Analytics account with [Add, edit, and delete users and user groups](https://support.google.com/analytics/answer/1009702?hl=en).
    - Enable the Google Analytics Admin API using the [Enable and disable APIs](https://support.google.com/googleapi/answer/6158841?hl=ens) reference.