> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Matomo audit profile, Vortex IQ

> What the Vortex IQ Matomo health audit checks: Matomo: Tracking, Engagement & Conversion Health

**[Nerve Centre KPIs](/nerve-centre/kpi-cards/matomo) · [Audit Profile](/nerve-centre/kpi-cards/matomo/audit) · [Sentiment Settings](/nerve-centre/kpi-cards/matomo/sentiment)**

Verifies Matomo Reporting API access for the configured site, then audits audience trend, engagement quality, and conversion / goal health. Answers: is tracking actually firing (sessions present but goals at zero)? Is engagement decaying (bounce up while duration / pageviews fall)? Is the funnel converting (session conversion rate, cart abandonment)? And does Matomo's view of conversions agree with the connected ecommerce platform?

## What this audit checks

### Authentication & access

* token\_auth + matomo\_url + site\_id valid (SitesManager.getSiteFromId returns the site)
* Reporting API reachable over HTTPS
* View permission granted on the configured idSite

### Audience & traffic health

* Sessions (VisitsSummary.get nb\_visits) above floor and stable vs prior 30d
* New-vs-returning split healthy (VisitFrequency.get)
* No single referrer type collapse vs prior period (Referrers.getReferrerType)

### Engagement quality

* Bounce rate below ceiling (VisitsSummary.get bounce\_rate)
* Pageviews per session above floor (nb\_actions\_per\_visit)
* Average session duration not falling sharply vs baseline (avg\_time\_on\_site)

### Conversion & goals

* At least one goal configured and converting (Goals.get nb\_conversions > 0 when sessions > 0)
* Session conversion rate above floor (Goals.get conversion\_rate)
* Cart abandonment below ceiling (ecommerceAbandonedCart pseudo-goal)

### Cross-channel

* Matomo goal completions / conversion vs ecommerce platform order count divergence > 10% (sibling = bigcommerce|shopify|adobe\_commerce.order)
* Paid referrer in Matomo with no matching ad-platform spend (sibling = google\_ads|amazon\_ads.campaign)

## Severity thresholds

| Signal                        | Warn | Critical |
| ----------------------------- | ---- | -------- |
| `bounce_rate_pct`             | 60   | 75       |
| `cart_abandonment_pct`        | 75   | 85       |
| `session_conversion_rate_pct` | 1    | -        |
| `pageviews_per_session`       | 1.5  | -        |
| `sessions_drop_pct`           | 10   | 25       |

## Data sources

* `GET {matomo_url}/index.php?module=API&method=SitesManager.getSiteFromId` - Auth probe + site metadata
* `GET {matomo_url}/index.php?module=API&method=VisitsSummary.get` - Sessions, users, bounce rate, duration, pageviews per visit
* `GET {matomo_url}/index.php?module=API&method=VisitFrequency.get` - New vs returning visitors
* `GET {matomo_url}/index.php?module=API&method=Live.getCounters` - Real-time visitor counts
* `GET {matomo_url}/index.php?module=API&method=Goals.get` - Goal completions, session conversion rate, cart abandonment
* `GET {matomo_url}/index.php?module=API&method=Actions.getPageUrls` - Top pages by pageviews
* `GET {matomo_url}/index.php?module=API&method=Referrers.getReferrerType` - Top traffic sources by referrer type