For end users

ga4

Pull web analytics from Google Analytics 4 into the analytics_metrics table.

Type: inbound. The runner calls fetch.ts directly; the model is not invoked at fetch time.

What it fetches

• Sessions, total users, new users
• Pageviews, screen views, average engagement time
• Daily granularity by default; date range is configurable per run

What you need

• A GA4 property the workspace is reporting to.
• A Google service account with Viewer access to that property.
• The GA4 Data API enabled in your Google Cloud project.

The Google service account section of Set up your accounts covers all three.

Configuration

Per-workspace setting GA4_PROPERTY_ID_PER_WORKSPACE. The CMS Apps surface (/apps/ga4) collects the property ID, runs a Test connection, and saves the value into integrations.

Interpretation

After fetch, apps/ga4/insights/SKILL.md turns the raw rows into Insights consumed by weekly-analysis and plan-sitemap.

Where it lives

pectusai/apps/ga4/APP.md