Matomo Analytics Connector Extension

Website visits summary: total visits, pageviews, unique visitors, bounce rate, avg time on site, daily/weekly/monthly series. Use for: traffic overview, how many visitors, visits for a period, pageviews, traffic summary. Note: for any multi-day window (period=day with date=last7/last30/etc.), unique_visitors_is_estimate=true in the result - Matomo has no true deduplicated visitor count for ranges, so that number is a sum of each day's uniques and can overcount returning visitors. Hedge accordingly when reporting it (e.g. 'roughly N unique visitors'), not as an exact figure.

Most visited pages ranked by visits with bounce rate and avg time on page. Use for: top pages, popular pages, most popular content, best performing pages, top content.

Week-over-week traffic comparison: this week vs last week, % change, direction. Use for: is traffic growing or declining, compare weeks, WoW, week over week, traffic trend, traffic up or down.

Save the Analytics extension's non-credential settings (segment, UTM dimension). Matomo URL/Auth Token are entered via the Secrets panel, not here.

Add a site/project to track - either a whole Matomo site, or a specific subdomain/section that shares a site_id with other content (via segment). Use for: add another site, new project, track a second project separately, track just the blog/docs/forum subdomain.

Remove a tracked site/project by its label (from list_sites).

List all sites/projects configured for this Matomo account. Use for: list my sites, list my projects.

Switch which site/project is the default - used by the sidebar, the dashboard and chat questions where the user doesn't name a site. Use for: switch to site X, make X the default site/project.

Which domains/URLs are actually configured for a site/project in Matomo - the real main_url and every URL alias from Matomo's own SitesManager, not guessed from referrer or page traffic. Also suggests a ready-to-use segment for each domain, for tracking one subdomain (e.g. a blog) separately via add_site. Use for: site domains, site URLs, what domains does this site cover, how to track a subdomain separately.

Scope the CURRENT site/project down to one domain, when its Matomo site_id covers several URL aliases (e.g. jump straight to a blog subdomain within the same project) - pass domain='All domains' to go back to the whole site. This updates that project's own segment in place, it does NOT add a new site/project (use add_site for that, to give a sub-project its own permanent label). Use for: switch to domain X, view just this subdomain, view only this domain.

Live active visitors right now: 30 min / 60 min / 3 hour windows. Use for: who's online right now, live visitors, real-time.

Traffic sources breakdown: Direct Entry, Search Engines, Websites, Social Networks, Campaigns. ALWAYS use for: where traffic comes from, top traffic sources, direct entries, referral links, search traffic, direct vs organic, where does traffic come from, traffic sources.

Device type split: Desktop vs Smartphone vs Tablet percentages. Use for: mobile vs desktop, mobile traffic share, desktop percentage.

Top countries by visitor count with percentages. Use for: top countries, geography breakdown, country breakdown, where visitors come from.

Top landing pages (where sessions start) + top exit pages (where visitors leave). Use for: exit pages, landing pages, where visitors drop off, where we're losing visitors.

Actionable insights: traffic drops, high bounce hotspots, growing/dying pages. Free, no AI tokens. Use for: what needs fixing, anomalies, site problems, what's not working, what to do, where we're losing traffic, recommendations.

Daily traffic brief with AI narration. USES AI TOKENS. Runs in background - result auto-delivered to chat when done.

Spot anomalies against the last 7 days. Free (no AI tokens).

Which AI assistants and LLMs send traffic - ChatGPT, Perplexity, Claude, Gemini, DeepSeek, Grok, Copilot. Combines referrer detection + UTM tracking. Default period=month for meaningful data. Use for: ChatGPT traffic, AI referrers, which AI sends visitors, LLM traffic.

Goal conversions from Matomo: purchases (cart complete), checkouts started, conversion rate. Use for: conversions, purchases, orders, checkout, purchase funnel, how many orders.

Custom tracking events: engagement (scrolls, clicks) and ecommerce events (begin_checkout). Use for: events, analytics events, engagement events, scroll depth, ecommerce events, what is being tracked.

UTM source breakdown from custom dimensions - shows which sources sent tagged traffic including AI sources with UTM parameters. Use for: utm_source, tagged traffic, paid traffic, ChatGPT referral with UTM, campaign sources.

New visitors vs returning visitors ratio and counts. Use for: new vs returning visitors, audience loyalty, retention, returning users percentage.

Session duration distribution buckets.

Visitor breakdown by city and region.

Phone and tablet brands (Apple, Samsung, etc.).

Browser breakdown (Chrome, Firefox, Safari, Edge, Opera) AND OS breakdown (Windows, macOS, Linux, Android, iOS). Use for: compare browsers, Chrome vs Safari, browser compatibility, users' OS, does it work on all browsers.

Which search engines send organic traffic.

Organic search keywords (may show 'not provided' if encrypted).

UTM campaign performance.

Social network traffic breakdown.

Referral websites sending visitors.

Internal site search terms including zero-result queries.

Visitor browser language preferences.

ISP and network providers of visitors.

Screen resolution distribution: 1920x1080, 1366x768, mobile resolutions, etc. Use for: 1080p vs 720p, mobile resolutions, screen size breakdown.

All pages with time-on-page, bounce rate, and avg actions.

Outbound link clicks tracked by Matomo.

Fetch ALL analytics data in one call - traffic, geo, devices, referrers, engagement, AI referrers, audience. Runs in background, result delivered to chat.