Google Analytics

Extractor

Google Analytics 4 (GA4) tracks website and app performance: traffic, engagement, locations, devices, pages and revenue-related activity. Teams connect GA4 to bring that data into a repeatable pipeline, so it can be modelled, reported on, and combined with advertising, CRM, sales or product data from other sources.

At a glance

Property	Value
Authentication	OAuth login
Sync type	Incremental
Streams	Fixed set of default reports, or your own custom report definitions in their place
Custom queries	Supported (custom report definitions)

What you can sync

Overall website performance and engagement
Traffic sources and locations
Device, OS and browser breakdowns
Active-user counts (daily, weekly and 28-day)
Page-level traffic and engagement
Revenue and transaction performance
Any custom report you define yourself, using GA4's own dimensions and metrics

Prerequisites

A Google account with access to the GA4 property you want to sync: used for the "Sign in with Google" flow in Meltano Cloud.
Property ID: the GA4 property identifier. Find it in the Analytics dashboard under Admin > Property > Property details.

Setup

In Google Analytics

Select the property you want to extract data for.
Go to Admin > Property > Property details.
Copy the Property ID.

In Meltano Cloud

Click "Sign in with Google" and authorize access to your GA4 property.
Enter the Property ID.
Choose a Start Date for extraction.
Optionally set an End Date (leave unset to keep syncing up to today).

Available streams

The tap provides these default streams. Every stream is keyed by date, and all replicate incrementally between your Start Date and (optional) End Date.

`website_overview`

Overview of website performance.

Field	Description
`date`	Dimension. The reporting date for the row.
`activeUsers`	Metric. The number of active users.
`newUsers`	Metric. The number of first-time users.
`sessions`	Metric. The number of sessions recorded.
`sessionsPerUser`	Metric. The average number of sessions per user.
`averageSessionDuration`	Metric. The average duration of sessions.
`screenPageViews`	Metric. The total number of page or screen views.
`screenPageViewsPerSession`	Metric. The average number of page or screen views per session.
`bounceRate`	Metric. The percentage of sessions that were not engaged.
`engagementRate`	Metric. The percentage of engaged sessions.

`traffic_sources`

Where website traffic originates from.

Field	Description
`date`	Dimension. The reporting date for the row.
`source`	Dimension. The source that sent traffic, such as a website or referrer.
`medium`	Dimension. The marketing medium for the traffic source, such as organic, referral, or cpc.
`sourcePlatform`	Dimension. The platform associated with the traffic source.
`activeUsers`	Metric. The number of active users.
`sessions`	Metric. The number of sessions recorded.
`sessionsPerUser`	Metric. The average number of sessions per user.
`bounceRate`	Metric. The percentage of sessions that were not engaged.
`engagementRate`	Metric. The percentage of engaged sessions.

`locations`

Website activity by country, region, and city.

Field	Description
`date`	Dimension. The reporting date for the row.
`country`	Dimension. The country where the activity originated.
`countryId`	Dimension. The Google Analytics identifier for the country.
`region`	Dimension. The region or state where the activity originated.
`city`	Dimension. The city where the activity originated.
`cityId`	Dimension. The Google Analytics identifier for the city.
`activeUsers`	Metric. The number of active users.
`newUsers`	Metric. The number of first-time users.
`sessions`	Metric. The number of sessions recorded.
`sessionsPerUser`	Metric. The average number of sessions per user.
`averageSessionDuration`	Metric. The average duration of sessions.
`screenPageViews`	Metric. The total number of page or screen views.
`screenPageViewsPerSession`	Metric. The average number of page or screen views per session.
`bounceRate`	Metric. The percentage of sessions that were not engaged.
`engagementRate`	Metric. The percentage of engaged sessions.

`four_weekly_active_users`

Active users measured over a rolling 28-day period.

Field	Description
`date`	Dimension. The reporting date for the row.
`active28DayUsers`	Metric. The number of active users over the last 28 days.

`weekly_active_users`

Active users measured over a rolling 7-day period.

Field	Description
`date`	Dimension. The reporting date for the row.
`active7DayUsers`	Metric. The number of active users over the last 7 days.

`daily_active_users`

Active users measured over a rolling 1-day period.

Field	Description
`date`	Dimension. The reporting date for the row.
`active1DayUsers`	Metric. The number of active users over the last 1 day.

`devices`

Website activity by device, operating system, and browser.

Field	Description
`date`	Dimension. The reporting date for the row.
`deviceCategory`	Dimension. The type of device used, such as desktop, tablet, or mobile.
`deviceModel`	Dimension. The model of device used by the visitor.
`operatingSystem`	Dimension. The operating system used by the visitor.
`browser`	Dimension. The browser used by the visitor.
`activeUsers`	Metric. The number of active users.
`newUsers`	Metric. The number of first-time users.
`sessions`	Metric. The number of sessions recorded.
`sessionsPerUser`	Metric. The average number of sessions per user.
`averageSessionDuration`	Metric. The average duration of sessions.
`screenPageViews`	Metric. The total number of page or screen views.
`screenPageViewsPerSession`	Metric. The average number of page or screen views per session.
`bounceRate`	Metric. The percentage of sessions that were not engaged.
`engagementRate`	Metric. The percentage of engaged sessions.

`transactions`

Revenue and transaction performance overview.

Field	Description
`date`	Dimension. The reporting date for the row.
`activeUsers`	Metric. The number of active users.
`averageRevenuePerUser`	Metric. The average revenue generated per user.
`newUsers`	Metric. The number of first-time users.
`purchaseRevenue`	Metric. The revenue generated from purchases.
`sessions`	Metric. The number of sessions recorded.
`totalRevenue`	Metric. The total revenue attributed in the report.
`transactions`	Metric. The number of completed transactions.

`pages`

Page-level traffic and engagement performance.

Field	Description
`date`	Dimension. The reporting date for the row.
`hostName`	Dimension. The hostname where the page was viewed.
`pagePath`	Dimension. The path portion of the viewed page URL.
`sessionMedium`	Dimension. The session-level marketing medium.
`sessionSource`	Dimension. The session-level traffic source.
`activeUsers`	Metric. The number of active users.
`bounceRate`	Metric. The percentage of sessions that were not engaged.
`engagedSessions`	Metric. The number of engaged sessions.
`engagementRate`	Metric. The percentage of engaged sessions.
`eventCount`	Metric. The total number of tracked events.
`screenPageViews`	Metric. The total number of page or screen views.
`screenPageViewsPerUser`	Metric. The average number of page or screen views per user.
`screenPageViewsPerSession`	Metric. The average number of page or screen views per session.
`userEngagementDuration`	Metric. The amount of time users were actively engaged.

Advanced configuration

Custom report definitions: define your own reports, and they replace all of the default streams above (not just add to them). Each report picks up to 7 dimensions and up to 10 metrics from GA4's dimensions and metrics reference. Two ways to supply them:
- Report definitions list (reports_list): define reports inline:
```
[
  {
    "name": "traffic_overview",
    "dimensions": ["date", "country"],
    "metrics": ["activeUsers", "sessions"]
  },
  {
    "name": "device_analysis",
    "dimensions": ["date", "deviceCategory"],
    "metrics": ["activeUsers", "engagedSessions", "engagementRate"]
  }
]
```
- Report definitions file (reports): point at a project-relative JSON file with the same structure, if you'd rather keep the definitions out of your config.
Schema flattening: enable Flattening Enabled to automatically expand nested properties into flat columns, and set Flattening Max Depth to control how deep that goes.
Stream maps: use Stream Maps / Stream Map Config to rename, filter or transform records via config. See the Meltano SDK stream maps docs.

If reports / reports_list is not provided, the tap uses its default reports definition.

Settings

Setting	Type	Description
`property_id`	string	Google Analytics Property ID. Found in Google Analytics under Admin > Property > Property details.
`start_date`	date	The earliest record date to sync.
`end_date`	date	The last record date to sync.
`reports`	string	A project-relative path to a JSON file with the definition of the reports to be generated. Uses the tap's default reports definition if not provided.
`reports_list`	array	A list of report definitions to be generated directly in the config, as an alternative to `reports`.
`flattening_enabled`	boolean	`True` to enable schema flattening and automatically expand nested properties.
`flattening_max_depth`	integer	The max depth to flatten schemas.
`stream_map_config`	object	User-defined config values to be used within map expressions.
`stream_maps`	object	Config object for the stream maps capability.

Need help?

If a stream or field you need isn't listed here or the connector doesn't work as expected, file it through the usual Meltano support channel.

At a glance​

What you can sync​

Prerequisites​

Setup​

In Google Analytics​

In Meltano Cloud​

Available streams​

website_overview​

traffic_sources​

locations​

four_weekly_active_users​

weekly_active_users​

daily_active_users​

devices​

transactions​

pages​

Advanced configuration​

Settings​

Need help?​