Insights Agent

The Insights Agent connects to Google Analytics 4 and provides on-demand analytics for every client property DotCollective manages. Ask a question in Slack, the Nucleus app, or via MCP and get AI-analysed insights with actionable recommendations — no need to log into GA4 or run manual reports.

What You Get

• Traffic source analysis — which channels drive the most (and best) traffic
• Performance overviews with period comparison — key metrics trending up or down
• Content performance — top pages, high-bounce pages, and quick-win improvements
• Device breakdown — mobile vs desktop conversion gaps and UX issues
• Ecommerce metrics — transactions, revenue, AOV, cart-to-checkout funnel
• Campaign performance — which campaigns convert and where to reallocate spend
• Geographic breakdown — top markets and expansion opportunities
• Realtime activity — who’s on the site right now
• Natural language Q&A — ask anything about a property’s analytics

Slash Commands

Type /insights in Slack followed by a subcommand:

Command	What It Does
/insights traffic <property> [days]	Traffic sources — source, medium, channel breakdown
/insights overview <property> [days]	Key metrics with previous-period comparison
/insights content <property> [days]	Top pages by views, bounce rate, session duration
/insights devices <property> [days]	Mobile vs desktop vs tablet performance
/insights ecommerce <property> [days]	Transactions, revenue, AOV, add-to-cart, checkout
/insights campaigns <property> [days]	Campaign performance by source and medium
/insights countries <property> [days]	Geographic breakdown by country
/insights realtime <property>	Active users right now
/insights ask <property> <question>	Ask anything — AI picks the right metrics
/insights properties [search]	List or search available GA4 properties

The [days] parameter defaults to 28. You can also use it to look back further (e.g. 90 for a quarter).

Examples

/insights devices ripcurl-au-ga4
/insights overview frank-green-au-ga4 30
/insights ecommerce billini-au-ga4 90
/insights ask decjuba-au-ga4 What is the % of sessions mobile vs desktop for the last 12 months?
/insights properties ripcurl
/insights realtime glue-store-au-production

Property Names

Properties use slug identifiers like ripcurl-au-ga4, frank-green-au-ga4, billini-au-ga4. Use /insights properties to see all available properties, or /insights properties <search> to filter.

Each property maps to a GA4 property ID and is stored in the ga4_properties table. New properties can be added via the API or auto-discovered from the GA4 Admin API.

Access Channels

The Insights Agent is available through three channels:

1. Slack — /insights slash command for quick queries and team-visible reports
2. Nucleus App — Chat interface at /agents/insights in the Nucleus web app
3. MCP — list_ga4_properties and query_ga4_insights tools for Claude Code and other AI clients

AI Analysis

Every query passes raw GA4 data through Claude for interpretation. The agent doesn’t just return numbers — it:

• Flags anomalies with severity indicators
• Compares against ecommerce industry benchmarks
• Recommends specific actions with expected impact
• Diagnoses issues (e.g. high-bounce pages, mobile UX gaps, cart abandonment)

Data Sources

The agent pulls data from:

• Google Analytics 4 Data API — sessions, users, conversions, revenue, page views, bounce rate, engagement, and all standard GA4 metrics and dimensions
• GA4 Realtime API — active users, current device and country breakdown
• Claude — AI-powered analysis, insight generation, and recommendations
• Nucleus — property registry linking GA4 properties to client companies