Google Analytics Connector

Connect Your Google Analytics Account to Our Platform

To let our app analyze your Google Analytics data and create custom reports and charts based on your questions, you need to connect your Google Analytics account. This guide will walk you through the simple steps to set up the connection. Don’t worry if you’re not tech-savvy, we’ve made it as easy as possible with clear instructions. Where helpful, we link to official Google documentation.

Step 1: Set Up a Google Analytics 4 Property

If you already have a Google Analytics 4 (GA4) property, skip to Step 2. Otherwise:

1. Go to analytics.google.com and sign in with your Google account.
2. Click the Admin icon in the bottom-left corner.
3. In the Property column, click Create Property.
4. Enter a property name, select time zone and currency, then click Next.
5. Fill in your business details and click Create.
6. Choose Web as the platform, enter your website URL, name the data stream, then Create Stream.
7. Note the Measurement ID (e.g., G-XXXXXXXXXX) for later.

For more help, see Google’s official guide on GA4 setup: Set up Analytics for a website and/or app.

Step 2: Create or Choose a Google Cloud Project

If you already have a Google Cloud project you want to use for this integration, you can skip the creation steps below and simply use that existing project. Otherwise, follow these steps to create a new one:

1. Open console.cloud.google.com and sign in with the same Google account used for Analytics.
2. Click the project dropdown at the top, then New Project.
3. Enter a Project Name (e.g., “My Analytics Connection”) and click Create.
4. Select your new project from the project dropdown once it’s created.

Step 3: Enable Google Analytics APIs

Enable the Google Analytics Data API in your Google Cloud project:

1. Go to APIs & Services → Library in Google Cloud Console.
2. Enable Google Analytics Data API.

Step 4: Create a Service Account and Download Credentials

1. In Cloud Console, go to APIs & Services → Credentials.
2. Click + Create Credentials → Service Account.
3. Enter a service account name and optional description. Create and Continue.
4. For Role, select Basic → Viewer (read-only). Click Done.
5. Open your new service account, go to the Keys tab, then Add Key → Create new key → JSON. Download and keep it safe.

Learn more: Manage service account keys.

Step 5: Grant Access to Your Google Analytics Property

1. Open the downloaded JSON file and copy the value of the client_email field.
2. Go to analytics.google.com → Admin → Property Access Management.
3. Click + → Add users, paste the service account email, and assign Viewer role.

Details: Manage GA4 users.

Step 6: Find Your Property ID

In Google Analytics, go to Admin → Property → Property Details. Copy the Property ID (e.g., properties/123456789).

Step 7: Connect to Our Platform

1. Log in to our platform.
2. Go to Connectors and choose the Google Analytics connector.
3. Upload the JSON credentials file from Step 4 and enter your Property ID from Step 6.
4. Click Enable. We’ll test the connection and confirm success.

Step 8: Start Asking Questions!

Once connected, you can ask questions like:

• “Show me page views for the last 30 days.”
• “What are my top pages by traffic?”
• “How many users visited my site by device type?”