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 page.

  2. 2

    Authorize Google

    Open the site's Settings page 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 sections are hidden on GA4 sites:

FeatureGA4 modeNumative tracker
Dashboard, breakdowns, realtimeYesYes
Change detectionYesYes
AnomaliesYesYes
Alerts and email reportsYesYes
BacklinksYesYes
Search Console rankingsYesYes
Core Web Vitals (Chrome UX Report)YesYes
Goals and conversionsNoYes
FunnelsNoYes
FlowNoYes
JourneysNoYes
Clicks and form submissionsNoYes
Error trackingNoYes
Speed (real-user measurement)NoYes
Custom event propertiesNoYes
Import and exportNoYes

A few breakdowns also have no GA4 equivalent (exit pages, raw referrer URLs, browser and OS versions, screen size and prop: dimensions), so those tabs are not offered in GA4 mode.

A site running both sources keeps every one of the "No" rows: those views are read from the collector whichever source the dashboard is currently showing, with a note saying so, because hiding a report whose data plainly exists would be a lie about the product.

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 page; 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.