Skip to main content

Google Analytics 4 (GA4) API Connector

Updated this week
Google Analytics 4 (GA4) Logo ...

Overview

Google Analytics 4 (GA4) is Google’s next-generation measurement platform that provides event-based analytics across websites and mobile apps. The GA4 Data API enables programmatic access to GA4’s reporting datasets, including events, user properties, traffic sources, engagement metrics, e-commerce activity, and device/geographic breakdowns.

The connector is designed for retrieving aggregated analytics data for dashboards, reporting, attribution analysis, user behaviour insights, and performance monitoring across digital properties.

GA4 does not expose raw, user-level or event-level logs via the API (that requires BigQuery export). Read more about BigQuery here.

GA4 is entirely event-based, meaning all metrics derive from tracked events and their associated parameters. The connector can retrieve:

Event & Engagement Data

  • Event counts and event parameter values

  • User_engagement time

  • Page views & screen views

  • Scrolls, clicks, outbound link clicks

  • File downloads

  • Session start / session duration

  • Engagement rate

Traffic & Attribution Data

  • Default channel grouping

  • Source, medium, campaign

  • Session source & session campaign

  • UTMs (utm_campaign, utm_source, utm_medium, etc.)

User & Demographic Data

  • User counts (total & active)

  • Geography (country, region, city)

  • Device model, platform, OS, browser

  • Language

  • User properties (custom dimensions)

E-commerce & Revenue

  • Purchase events & revenue

  • Items purchased & item-level parameters

  • Add-to-cart, begin_checkout, add_payment_info, add_shipping_info

  • Basket size, product list performance

  • Promotions and coupon usage

Conversions & Goals

  • GA4 conversions (designated events)

  • Conversion values

  • Funnel steps (based on defined events)

App + Web Data (Combined)

  • App version, screen class, app platform

  • Web + app unified user metrics

  • Firebase event parameters (if linked)

Metadata & Configuration

  • Dimensions & metrics metadata

  • Available event names

  • Custom dimensions and metrics

  • Property settings

Granularity:

GA4 provides flexible reporting granularity, which can be broken down daily, hourly, weekly or monthly.

  • Event level (aggregated)

  • Page-level

  • Traffic source level

  • User property level

  • Item-level (e-commerce)

  • Device and geo breakdown

Purpose:

  • Website and app performance dashboards

  • Behaviour and engagement analysis

  • Conversion and funnel reporting

  • Content performance measurement

  • Attribution and traffic analysis

  • E-commerce revenue and product tracking

  • Combining GA4 with ads platform data for end-to-end performance insights

Refresh Cadence:

Data is refreshed daily.

Update Modes:

Append (for data table), Refresh (for metadata)

For more information on this integration, please follow link here.

Connection

Key

Description

Required

Type

ga_property_ids

Comma‑separated GA4 property IDs

✅

Text

google_client_secret

Google OAuth Client Secret (hidden)

✅

Hidden

google_client_id

Google OAuth Client ID (hidden)

✅

Hidden

Job Configuration

Field

Value

Job Label

GA4 Import

Feed

google_analytics_data

Status

2 (Active)

Lookback

3 days

First Run Hour

6 AM

Poll Frequency

Every 24 hours

Update Mode

append

Lookback Window

0

Targets

Each target represents a table with incoming data. All require the ga_property_ids input (comma-separated GA4 Property IDs).

Table Name

Description

Date Column

googleanalytics4_data_sessions

GA - Session Data

bright_custom_date

googleanalytics4_data_sessions_channel

GA - Sessions Channel Data

bright_custom_date

googleanalytics4_data_sessions_country

GA - Sessions Country Data

bright_custom_date

googleanalytics4_data_event

GA4 - Event Data

bright_custom_date

Dimensions

Name

Result Fields

Medium [GA4]

googleanalytics4_data_sessions.sessionMedium, googleanalytics4_data_event.medium

Campaign [GA4]

googleanalytics4_data_sessions.sessionCampaignName, googleanalytics4_data_event.campaignName

Source [GA4]

googleanalytics4_data_sessions.sessionSource

Default Channel Grouping

googleanalytics4_data_sessions.sessionDefaultChannelGrouping, googleanalytics4_data_sessions_channel.sessionDefaultChannelGrouping

Device [GA4]

googleanalytics4_data_sessions.deviceCategory, googleanalytics4_data_event.deviceCategory

Country [GA4]

googleanalytics4_data_sessions_country.country, googleanalytics4_data_event.country

Event Name [GA4]

googleanalytics4_data_event.eventName

Base Metrics

Name

Formulae

Round

Page Views [GA4]

SUM(screenPageViews) from sessions, sessions_channel, sessions_country

0

Sessions [GA4]

SUM(sessions) from all: sessions, sessions_channel, sessions_country, event

0

Users [GA4]

SUM(totalUsers) from sessions, sessions_channel, sessions_country

0

New Users [GA4]

SUM(newUsers) from sessions, sessions_channel, sessions_country

0

Engagements [GA4]

SUM(engagedSessions) from sessions, sessions_channel, sessions_country

0

Total Session Duration

SUM(userEngagementDuration) from sessions, sessions_channel, sessions_country

0

Conversions [GA4]

SUM(conversions) from googleanalytics4_data_event

0

Composite Metrics

Name

Formula

Format

Avg Session Duration [GA4]

{Total Session Duration [GA4]} / {Sessions [GA4]}

2 decimals, %

Page Views per Session [GA4]

{Page Views [GA4]} / {Sessions [GA4]}

2 decimals, %

Joins

  • Datasource Joins: None configured

Example Use Cases

  • Measure user engagement across device types and countries

  • Analyze session traffic by source/medium/campaign

  • Report marketing performance using session-level and event-based metrics

  • Track conversions and define KPIs like engagement rate or average session duration

Did this answer your question?