TTrenscope

Connection Help

Connect an existing Google Analytics 4 property to Trenscope. Choose a method below, then open each numbered step in order.

Connect with a JSON key

Watch the complete walkthrough

1. Check the prerequisites
First select the Analytics account and GA4 property you want to report on. You need permission to grant access.
  1. In Google Analytics, select the website you want to connect.
  2. Confirm the website has a GA4 property and you can open its Admin settings.

Open Google Analytics — choose your property ↗

Opens in a new tab.

2. Create or choose a Cloud project
Open the project selector, then create a project or select an existing one. Keep that project selected.
New project is in the project-selection panel. Select your own project after creation.
  1. Open Google Cloud. Click the project name in the top bar.
  2. Select your project or click New project, name it, and click Create.

Open Cloud project selector ↗

Opens in a new tab.

3. Enable Google Analytics Data API
Enable Google Analytics Data API in the selected project.
  1. In Google Cloud, open APIs & Services → Library.
  2. Search for Google Analytics Data API. Open it and click Enable.

Open Google Analytics Data API ↗

Opens in a new tab.

4. Create a service account
In IAM & Admin → Service Accounts, press Create service account.
Enter your own service-account name. The example name and IDs shown here are not yours.
Continue creation. Optional project-role and user-access steps can be skipped for Analytics reporting; press Done.
  1. Open IAM & Admin → Service Accounts.
  2. Click Create service account, enter a name, and click Create and continue. Click Done.

Open Service Accounts ↗

Opens in a new tab.

5. Download the JSON key
Open the service account’s Actions menu and select Manage keys. You can also open its details and select Keys.
On Keys, select Add key → Create new key.
Choose JSON, then Create. Keep the downloaded private-key file private.
  1. Click your new service account and open Keys.
  2. Click Add key → Create new key. Select JSON and click Create.
  3. Keep the downloaded file private.

Open Service Accounts — choose yours, then Keys ↗

Opens in a new tab.

6. Save a named JSON connection
Give the connection a recognisable name. Choose the downloaded JSON file, or paste it privately in Trenscope. Never paste a key into ChatGPT.
Press Add JSON connection. Do not use settings import for a service-account key.
  1. In Trenscope, open Connect Website.
  2. Under JSON key connection, enter a connection name and choose your downloaded file. Click Add JSON connection.

Open JSON connection settings ↗

Opens in a new tab.

7. Copy the service-account email
Copy the full Service-account email from your saved connection. This example email is not a real credential.
  1. Find the new entry under Saved connections.
  2. Copy the full Service-account email shown there.

Open saved connections ↗

Opens in a new tab.

8. Grant Viewer access in Analytics
In Analytics Admin, open Account access management, or Property access management for narrower access.
Press the plus button, then Add users.
Paste your service-account email into the email field. Select Viewer, then press Add. Use your own email from step 7.
  1. In Google Analytics, choose your website’s property and open Admin → Property access management.
  2. Click + → Add users. Paste the service-account email, select Viewer, and click Add.

Open Analytics — then Admin and access management ↗

Opens in a new tab.

9. Find each numeric Property ID
In Admin, open Property details for the correct website’s property.
Copy the numeric Property ID. This sample is masked; use your own number, not a G- Measurement ID.
  1. In Google Analytics, open Admin → Property details for the same property.
  2. Copy the number labelled Property ID.

Open Analytics — then Admin and Property details ↗

Opens in a new tab.

10. Add and assign the website
Add a website row and enter its name, URL, group and numeric Property ID. Select the saved JSON connection for that row.
Press Save settings after completing your rows.
  1. Open My Account → My Websites in Trenscope and click Add website.
  2. Enter the website name, URL and Property ID. Select the saved JSON connection and click Save settings.

Open My Websites ↗

Opens in a new tab.

11. Check reports and resolve errors
Refresh the Dashboard. If access fails, check the saved service email’s Viewer access, Property ID, API and key.
  1. Open Dashboard and find your website.
  2. Click Test connection on its card. When the check succeeds, click Refresh now to load reports.

Open Dashboard ↗

Opens in a new tab.

12. Add accounts or change methods later
Each website row has its own Connection choice. You may mix JSON and Google connections across websites when both have the required access.
  1. For another website, repeat the access and Property ID steps for that property.
  2. Add the website in My Websites, select the connection with access, and click Save settings.

Open Manage connections ↗

Opens in a new tab.

Connect with Google sign-in

Watch the complete walkthrough

1. Open Google connections
Type a recognisable connection name. Example: Client B Google.
  1. Log in to Trenscope. Open Connect Website and find Google sign-in.
  2. Enter a name for the connection.
2. Open Google sign-in
Press Connect with Google. Google opens its own sign-in page; the next images show account selection and signing in when needed.
Choose your own Google account with Analytics access, or select Use another account. Google’s reference screenshot shows Example App and sample accounts, not Trenscope customer accounts.
If your account is not listed, enter your Google email on Google’s sign-in page and press Next. Complete any password and security checks only on Google. The exact layout can vary.
  1. Click Connect with Google.
  2. Select the Google account that has access to your Analytics properties.
3. Review the permission request
While verification is pending, Google may show this warning. Cancel with Back to safety and follow the JSON guide if you cannot proceed.
Check the Analytics permission: “See and download your Google Analytics data.” This recorded screen shows the site domain before the Trenscope branding update; your screen may show Trenscope. Only continue if you agree.
Review Google’s access details before continuing. Previously approved accounts can show “already has some access”; expand the details to inspect permissions.
After reviewing the app, permission and policies on Google, press Continue to return to Trenscope. You may cancel instead.
  1. Review the read-only Analytics permission.
  2. On Google’s consent screen, choose Continue to allow access.
4. Return to Trenscope
After successful Google consent, Trenscope confirms the connection. This is a recorded confirmation; find your named connection in the current Saved connections panel shown next.
After successful sign-in, find your named Google connection under Saved connections.
  1. Wait for Google to return you to Trenscope.
  2. Find your named connection under Saved connections.
5. Load the correct account’s websites
Press Choose websites for this connection, under the correct saved Google connection.
  1. Click Choose websites for this connection.
  2. Wait for the property list.
6. Add the properties you need
Tick the properties you want from this connection.
Press Add selected websites. Check the connection name above the list first.
  1. Tick the properties you want to add.
  2. Click Add selected websites.
7. Assign and check each website
Check the website fields, numeric Property ID and saved Connection. This is a horizontally scrollable table.
After editing the website rows, press Save settings.
  1. Open My Account → My Websites.
  2. Check each website’s Connection and click Save settings if you make changes.
8. Load your reports
On Dashboard, press Refresh now and wait for the result.
  1. Open Dashboard. Click Test connection on the new website card.
  2. Click Refresh now to load the reports.
9. Add another Google account
For another Google account, create a new named connection here. Reconnect is only for renewing the same account.
Assign each website to its intended connection and save. Adding a connection does not switch existing websites.
  1. Open Connect Website to add another named connection.
  2. In My Websites, choose which connection to use for each website.

Screenshot sources include Contentstack, Google Identity documentation (CC BY 4.0), and Trenscope. Arrows and highlights identify the controls used in each step.