Skip to main content
Google Analytics 4 is one of the most common data sources in Oviond reports. This guide walks through connecting GA4 to a client inside a project and adding a first widget. GA4 uses a two-step account selection: you pick the analytics account, then the property inside it.

​
Before you start

  • You have at least Viewer access to the GA4 property you want to report on.
  • You’ve already created an Oviond client and a project for this customer. You connect data sources from inside the project editor.

​
1. Start the connection

1

Open the project

From the client’s Projects tab, open the project you want to report in.
2

Open the Data sources tab

In the editor sidebar, click Data sources.
3

Find Google Analytics 4

Use the Search data sources… box, then click Connect next to Google Analytics 4.
4

Name the profile

Oviond shows a Profile Name field, prefilled with Default Google Analytics 4 Connection. Keep it or rename it (for example, Acme — Google), then click Connect. A profile name can’t contain . or $.

​
2. Authorize with Google

1

Sign in

Oviond opens a Google sign-in popup. Pick the Google account that has access to the GA4 property.
2

Approve the scopes

Approve the access Oviond requests. Oviond requests read-only access — it cannot change anything in your GA4 account.
A profile is reusable. If you already authorized Google Analytics for another client, you don’t need to authorize again — pick the existing profile under Select Profile in the next step.
After authorizing, you tell Oviond which analytics account and property belong to this client.
1

Select the profile

Under Select Profile, choose the connection you just authorized, then click Link.
2

Select the account

Under Select Account, pick the GA4 analytics account. Use Search… to narrow the list, then click Next.
3

Select the property

The next screen (still headed Select Account) lists the properties inside that account. Pick the GA4 property, then click Save.
Oviond links the property to the client and shows a Google Analytics 4 linked confirmation. The linked profile sorts to the top of the list with a Linked tag and shows the selected Account and Property.

​
4. Check the connection status

Each profile shows a status badge so you can tell its token is healthy:
  • Token Valid — the connection is authorized and data should flow.
  • Token Expired — the token expired or was revoked; refresh it.
Status is set automatically by a daily auth-test check and the OAuth token refresher.

​
5. Refresh an expired connection

If the profile shows Token Expired, click Refresh on the profile to reopen the Google sign-in popup and re-authorize with the same account. The badge returns to Token Valid. There is no separate “test” or “reconnect” action — Refresh handles re-authorization.

​
6. Build your first GA4 widget

1

Open the Add Content tab

In the editor sidebar, open the Add Content tab.
2

Drag in a Data Query

Drag a Data Query widget onto the canvas. See Add a widget.
3

Pick Google Analytics 4

In the data source picker, select the GA4 source you just linked. Only sources connected to this client are available.
4

Pick a metric

Start with Sessions — a universal GA4 metric that exists for every property. Add an optional dimension for a breakdown.
5

Choose the chart type

Pick a single-value KPI for a quick win, or a line chart to trend the metric over time.
Set the project’s date range to a relative period (for example, last 30 days) so the widget auto-updates each time the report is opened. Oviond auto-saves the editor as you work.

​
Common follow-ups

  • Add a Sessions by Source / Medium table for a traffic breakdown.
  • Add a Conversions widget if you’ve set up GA4 conversion events.
  • Use Calculated metrics to compute engagement rate or conversion rate.

​
Troubleshooting

  • No data returned — the property is connected but empty for the selected period. Check the widget’s date range and that you linked the right property.
  • Token Expired — the OAuth token expired or access was revoked. Click Refresh on the profile and re-authorize.
  • Property missing from the list — the authorizing Google account doesn’t have access to that property in GA4. Re-authorize with an account that does, or click Refresh.
  • Accounts won’t load — Oviond shows Unable to load accounts for Google Analytics 4. Click Refresh and try again.