Connect Google Analytics

Use Numative as a GA4 wrapper: connect a property read-only and get the same dashboard over your existing data.

What connecting does

Connecting Google Analytics binds one GA4 property to a Numative site and lets Numative read it on your behalf. The connection is read-only: the OAuth grant requests only the analytics.readonly scope, so Numative can never modify your property, its settings or its data. The OAuth access and refresh tokens are encrypted at rest with AES-256-GCM before they touch the database, and disconnecting deletes the connection and its tokens.

How to connect

  1. 1

    Create (or switch) a site in GA4 mode

    When you add a site, choose Google Analytics as its data source. An existing site's data source can be changed later in its Settings tab.

  2. 2

    Authorize Google

    Open the site's Settings tab and click Connect Google Analytics. You are sent to Google to approve read-only access.

  3. 3

    Pick the property

    After authorizing, Numative binds the first GA4 property on your account automatically. If that is not the right one, pick the correct property from the dropdown in Settings; every property your Google account can read is listed.

What you get

The same dashboard, fed by your existing GA4 data. Numative maps GA4 Data API dimensions and metrics into its normalized shapes, so visitors, visits, pageviews, bounce rate and visit duration read the same way as on a standalone site, with breakdowns by page, entry page, source, channel, UTM tags, country, region, city, browser, OS, device and hostname, plus a realtime view. Data is queried live from the GA4 Data API each time a report loads, so what you see matches what GA4 itself reports at that moment.

Feature availability by mode

Some analyses need Numative's own event stream and cannot be reproduced through the GA4 Data API. Those tabs are hidden on GA4 sites:

FeatureGA4 modeNumative tracker
Dashboard, breakdowns, realtimeYesYes
Change detectionYesYes
Anomalies and alertsYesYes
Rank tracking and backlinksYesYes
Search ConsoleYesYes
Core Web VitalsYesYes
Goals and conversionsNoYes
FunnelsNoYes
Paths and behavior flowNoYes
Custom event propertiesNoYes
Import and exportNoYes

A few breakdowns also have no GA4 equivalent (exit pages, raw referrer URLs, screen size and prop: dimensions), so those return no rows in GA4 mode.

Modes are per site, not per account. You can run one site as a GA4 wrapper and another on the Numative tracker side by side, and switch a site's data source later without recreating it.

Troubleshooting

  • No properties found. The Google account you authorized has no GA4 properties it can read. Reconnect with an account that has at least Viewer access to the property.
  • Connection error after some time. If access was revoked in your Google account, reconnect from the site's Settings tab; Numative refreshes tokens automatically otherwise.
  • Numbers differ slightly from the GA4 UI. Numative queries the same Data API but presents metrics in its normalized form (for example, visits are GA4 sessions). Directionally they track together.