AgentcyEarly Access
Services/Matomo Analytics

Matomo Analytics

Privacy-first web analytics — visits, pageviews, referrers, goals, funnels, heatmaps, A/B testing, and more from your Matomo instance.

OVERVIEW

Matomo is the privacy-first alternative to Google Analytics, used by organizations that need full data ownership and GDPR compliance. Agentcy connects directly to your Matomo Reporting API — cloud or self-hosted — giving you natural-language access to all your web analytics without logging into the Matomo dashboard.

Ask about traffic trends, top pages, conversion funnels, or campaign performance the way you'd ask a colleague. Agentcy automatically detects which Matomo plugins are active on your instance and adapts — if you have premium features like Funnels, Heatmaps, Form Analytics, or A/B Testing, those are available instantly. Free/open-source users get full access to the 20 core analytics operations.

Matomo is a BYOK (Bring Your Own Key) service. You provide your instance URL, auth token, and site ID. Each domain gets its own configuration, and credentials are stored securely in the portal vault. Supports both Matomo Cloud (yoursite.matomo.cloud) and self-hosted instances.

EXAMPLE QUESTIONS
15 SAMPLES

How much traffic did my site get last month?

What are my top landing pages this week?

Where is my traffic coming from?

Which campaigns drove the most conversions?

What are people searching for on my site?

Show me bounce rate trends over the last 6 months

What devices are my visitors using?

Which countries send the most traffic?

What pages have the slowest load times?

How are my goals performing compared to last month?

What is the funnel drop-off rate for my signup flow?

Show me form conversion rates

Which A/B test variant is winning?

Who is on my site right now?

What are the most common navigation paths through my site?

WHAT YOU CAN ASK ABOUT
24 EXAMPLES
Visits, unique visitors, bounce rate, avg visit duration, actions per visit
Page URLs, page titles, entry pages, exit pages
Traffic sources — direct, search engines, social networks, websites, campaigns, AI assistants
Goal conversions, revenue, ecommerce products (SKU, name, category)
Events — categories, actions, names
Devices — type, brand, model, OS, browsers
Geographic data — country, continent, region, city
Visitor engagement — new vs returning, visit frequency, time patterns
Page load performance — network, server, DOM, on-load times
Internal site search — keywords, no-results queries, categories
Downloads and outlinks
Real-time visitor feed
Custom dimensions
Page transitions (user flow around specific pages)
Premium: Funnel conversion metrics and step drop-off
Premium: Form views, starts, submissions, field-level analytics
Premium: Heatmap configuration and aggregated data
Premium: A/B test experiment results and statistical significance
Premium: Video/audio plays, impressions, watch time, finish rate
Premium: Multi-channel conversion attribution
Premium: User navigation flow paths
Premium: Retention cohort analysis
Premium: JavaScript crash/error tracking by page and source
Premium: SEO keywords with clicks, impressions, CTR, position (via Search Console integration)
REQUIREMENTS
Google Account
Not required
API Key
Provide your own API credentials
External Subscription
Matomo account (Cloud or self-hosted). Free/open-source includes 20 core analytics operations. Matomo Cloud Business adds premium features: Funnels, Heatmaps, Form Analytics, A/B Testing, Media Analytics, and more.
Domain Configuration
Matomo instance URL, Auth Token, and Site ID — configured per domain in the Agentcy portal
SETUP
9 STEPS
  1. 01

    In your Matomo instance, go to Administration (gear icon) → Personal → Security → Auth Tokens → Create new token

  2. 02

    Set the token to 'POST only' for best security and save it somewhere safe — you won't see it again

  3. 03

    Note your Matomo instance URL (e.g. https://yoursite.matomo.cloud or https://analytics.yourdomain.com)

  4. 04

    In the Agentcy portal, go to Services and enable Matomo Analytics

  5. 05

    Go to the domain page and click Configure on Matomo Analytics

  6. 06

    Enter your Matomo instance URL and auth token, then click 'Fetch Sites' to load your available sites

  7. 07

    Select your site from the dropdown (or enter the Site ID manually)

  8. 08

    Click 'Test Connection' to verify access

  9. 09

    Start asking questions about your web analytics

DATA FRESHNESS

1-hour cache. Matomo processes most data in near real-time. Live visitor data is always fresh. Available modules list is cached for 24 hours.

TIPS
10

Auth tokens must be sent via POST — Matomo Cloud rejects tokens in URL query strings. Agentcy handles this automatically.

Site IDs are numeric and don't start at 1 — use the site picker in the portal to find yours, or check Matomo → Administration → Websites

Premium features (Funnels, Heatmaps, Form Analytics, A/B Testing, etc.) require paid Matomo plugins or a Matomo Cloud Business plan. Agentcy auto-detects what's available.

Self-hosted instances must be accessible from the internet (HTTPS required) — local/private URLs are blocked for security

The Transitions API requires a specific page URL — be specific when asking about user flow (e.g. 'Where do visitors go after viewing /pricing?')

Ecommerce data requires ecommerce tracking to be enabled in your Matomo site settings

Some premium plugins (like CrashAnalytics) may need to be explicitly activated in Matomo's plugin settings even on paid plans

Session recording replay is not available through the API — only session metadata and heatmap aggregations

Custom Reports require report IDs that must be set up in Matomo first

Roll-Up Reporting (multi-site aggregation) is not yet supported

WORKS WELL WITH
4 SERVICES
v1.0Need help?