The Feinwerk Connector is now in the Matomo Marketplace. Install it right inside Matomo, no download, no FTP. Read the news · Here is how →
Find the bots in your Matomo data and keep them out.
Spots bot traffic by how whole groups of visits behave, shows it per network and blocks it while tracking, server-side.
from €49/month · cancel any time
Latest v5.0.2 · Matomo ≥ 5.0.0
Running on 14 Matomo instances
Catches bots with real browsers
Headless browsers that run JavaScript get past IP-range filters. Tracking Spam Score judges whole groups: sudden, uniform traffic from a hosting network that never interacts stands out, even when each single visit looks normal.
Clean numbers from now on
Block whole networks or just single IP ranges during tracking: one by one, several at once, or automatically for 7 days once a source reaches the blocking threshold. E-commerce orders always get through.
Every decision explained
Each spam source lists the evidence that flagged it, and the visitor log shows score and reasons per visit. Mark visits as bot or human and see precision and detection rate.
Built for busy instances
An hourly background analysis on grouped statistics and paged lists that load fast. Everything runs inside your Matomo: no extra JavaScript, no external service.
Click to enlarge
- License for 1 Matomo instance + 3 test instances, all websites and users
- Prices incl. VAT, billed via Paddle
- 14-day trial, cancel before it ends at no cost
- Updates and support included
- Refunds
Detect bot traffic in Matomo before it skews your numbers
Finds bots that look like real visitors by how whole groups of visits behave, and keeps them out of your reports.
Read the use case →Not on its own. It marks visits with a spam score that you can filter by segment, and blocking only affects new tracking requests. To remove spam that was already tracked, you count and confirm the deletion on the network card (with the Delete Visits Filter plugin) or use the segment with Matomo's GDPR tools.
Yes. Expand the network in the spam networks report and block a single IP range, or enter any range in CIDR notation as a rule. Allowed ranges work the other way round: your office or monitoring service inside a cloud network stays trackable even if you block the rest of that network.
Yes. In the website settings, super users choose per website: all rules (default), only your own block rules, or never block and only monitor. Scores and reports stay the same in every mode.
Automatic blocking is off until you turn it on. It needs several corroborating signals, lasts 7 days and never applies to networks you allowed. A hosting network alone never becomes spam, and e-commerce orders are always tracked.
DB-IP IP to ASN Lite (free, no account, Matomo can update it automatically) or MaxMind GeoLite2-ASN (free with a MaxMind account). The admin page checks the database and explains how to set it up. Without one, only IP ranges are evaluated.
Each tracking request is checked against a cached block list and the network database, a quick lookup. The analysis runs once an hour in the background on grouped statistics.
TrackingSpamPrevention blocks fixed lists such as cloud IP ranges and organisation names. Tracking Spam Score learns from behaviour and also catches networks no list knows yet; it uses TrackingSpamPrevention's organisation list as one of its inputs. Both work together.
Yes. Export all rules as a CSV file and import it there. The import also accepts any CSV with the columns asn and rule, or a plain list of AS numbers, which are then blocked.
- 01 Install the Feinwerk Connector from Matomo's Marketplace: under Administration › Platform › Marketplace, search for "Feinwerk", install and activate it. Without the Marketplace: download the ZIP.
- 02 Open Feinwerk Plugins and click "Connect with Feinwerk account". If your browser cannot reach the store, enter your instance token in the connector settings instead.
- 03 Open the Feinwerk Plugins screen, find Tracking Spam Score, and click Install.
Prefer a manual install? After the purchase you will find the ZIP download in your customer account. · Documentation for Tracking Spam Score
Missing a feature in Tracking Spam Score? Tell us what you need →
Tracking Spam Score
Tracking Spam Score finds automated traffic in your Matomo data and keeps it out, including bots that run a real browser with JavaScript and slip past IP-range and datacenter lists. It does not judge single requests. It looks at groups of visits: a network, a network in one country, a device profile within a network, or an IP range. A hosting network whose visits arrive suddenly, all look the same and never interact is spam. A varied crowd from a residential internet provider is not.
Everything runs on your server from data Matomo already stores: no additional JavaScript, no fingerprinting, no external service.
Reports and views
Spam overview
Visitors › Networks & spam starts with the spam overview: spam visits, their share of all visits and the number of spam networks over time, as an evolution graph and as sparklines with the change against the previous period. Both are also available as dashboard widgets.
Spam networks report
One row per network (autonomous system) with visits, spam visits, spam rate, highest spam score, share of visits without events, bounce rate and average time on site. It works for every date range and segment like any other Matomo report. Tags show at a glance whether a network is blocked, allowed or a hosting network.
- IP ranges: expand a network to see its IPv4 /24 and IPv6 /48 ranges, each with its own figures and visits, and block a single range right there with one click.
- Goals view: conversions, conversion rate and revenue per network, e-commerce included: does traffic from a network ever buy anything?
- Filter: show all networks, only blocked or not blocked ones, or hosting networks only; the choice is remembered per user, and Select all ticks the whole list for super users.
- Act in place: each row opens its visits in the visitor log; super users open a network's details in a popover and block or allow it without leaving the report, or tick several networks and block or allow them at once.
Spam protection admin page
Administration › System › Spam protection
- Status: automatic blocking on or off, how many networks and IP ranges are blocked right now, the network database in use, the result of the last analysis and the websites with limited blocking.
- Detected spam sources per website: score, visits, the evidence that flagged the source, when it was last seen and until when it is blocked. Filter by minimum score and by status (blocked / not blocked); tags show whether the network is blocked by a rule or automatically, or only its IP range. Select several sources and block or allow their networks together.
- Network card: everything about one network: hosting or access network, its rule, its spam sources on all websites and its visits in the visitor log. With the Delete Visits Filter plugin you also delete its already tracked visits right there: choose this or all websites and the last 7 to 365 days, count them, confirm.
- Network and IP range rules: block or allow networks or single IP ranges (any CIDR range), several at once, remove selected rules, and export all rules as CSV and import them again, also on another Matomo.
- Accuracy: mark visits as bot or human in the visitor log; the page shows the precision and detection rate of your spam threshold.
- Signal weights: turn each signal off (0) or strengthen it (up to 3).
- Network database setup: if no usable network database is found, the page says why (missing, unreadable, damaged or still compressed, wrong type) and how to set one up.
Visitor log and segments
Visits with a spam score show it in the visitor log together with the reasons; super users mark them as bot or human right there. The visitor profile shows how many of a visitor's visits were spam. The segments spamScore (0 to 100), spamAsn (network number, with suggestions in the segment editor) and spamMark (visits marked as bot or human) work in every report, for example "all visits without spam" or "only this network".
Email about new spam networks
Each user can turn it on in their personal settings: at most once a day, an email lists the networks that reached the spam threshold on their websites for the first time in 30 days, with their visits and a link to the report.
Blocking
- Networks and IP ranges you block are not tracked on any website, from the next request on.
- Automatic blocking (off by default): sources that reach the blocking threshold are blocked for 7 days; the block is extended while they keep sending spam.
- Allowing a network always wins: it is never flagged or blocked, and its spam scores are cleared with the next analysis.
- E-commerce orders are always tracked, even from blocked networks and IP ranges, so no revenue is lost.
- IP ranges instead of whole networks: block or allow any IP range, e.g.
203.0.113.0/24or2001:db8::/48. Range rules take precedence over network rules: an allowed range (your office or uptime monitor inside a cloud network) is never blocked or marked as spam, a blocked range is blocked even inside an allowed network. - Per website: in the website settings, super users choose whether a website applies all rules (default), only your own block rules, or never blocks and only monitors.
- Blocking stops new spam. Visits that were already tracked are deleted from the network card with the Delete Visits Filter plugin, or with Matomo's GDPR tools using the network's segment.
How the spam classification works
1. Groups of visits
Every hour Tracking Spam Score looks at the recent traffic of each website (by default the last 24 hours) and forms groups:
| Group | Example |
|---|---|
| Whole network | all visits from one autonomous system |
| Network in one country | visits from that network located in one country |
| Device profile in a network | same browser version, operating system and screen size within one network |
| IP range | IPv4 /24 or IPv6 /48, used when Matomo's IP anonymisation masks at most one byte |
The behaviour signals need a minimum number of visits per group (default 8).
2. Signals
Each signal is measured from 0 to 1 and compared with the website's own normal values, so it adapts to every site.
Primary signals can carry suspicion on their own:
| Signal | What it measures |
|---|---|
| Hosting network | The network belongs to a hosting or cloud provider: a built-in list, the organisations blocked in Matomo's TrackingSpamPrevention and your own block rules. |
| Sudden traffic surge | Visits in the window against the group's daily median of the last 28 days. It counts from twice the usual volume and is at full strength at six times. Networks that are normally absent count as sudden. Needs three days of history. |
| Uniform behaviour | How little visit duration and number of actions vary within the group. People differ, scripts repeat. |
Supporting signals only count together with others:
| Signal | What it measures |
|---|---|
| Repeated page loads | The same page is loaded again and again within visits. |
| Unusual country | A country that normally brings less than 1 % of the website's traffic suddenly surges. |
| No interactions | No events, although the website's visitors usually trigger some (only if at least 5 % of its visits do). |
| No campaign traffic | No campaign visits, although the website usually receives some (only if at least 5 % of its visits are campaign visits). |
| Outdated or automated client | Typical bot screen sizes (800×600, 1024×768, 0×0, 1×1) or a browser more than two major versions behind the newest one seen. |
Relief:
| Signal | Effect |
|---|---|
| Purchases | E-commerce orders from the group compared with the website's average. At the average rate the score drops by 60 %; a single order among thousands of bot visits hardly changes it. |
3. From signals to a score (0 to 100)
- Each primary signal adds up to 50 points, each supporting signal up to 12 (all supporting signals together at most 35).
- A hosting network alone scores at most 40: company VPNs and cloud proxies are not spam just because of where they come from.
- Corroboration: 80 or more needs two strong primary signals, or one strong primary signal plus two strong supporting signals. No single signal can turn a group into spam or get it blocked.
- Purchases then lower the score by up to 60 %.
- Your signal weights scale each signal (0 = off, 1 = default, up to 3).
- Networks you block yourself count as 100.
Example: a hosting network suddenly sends twenty times its usual traffic, and all visits last 0 to 2 seconds with one page view and no events: hosting network + surge + uniform behaviour → 100. A residential provider with varied visits at its normal volume gets no score at all.
4. What the score is used for
- Groups below 30 are ignored as noise.
- Each visit gets the score of its strongest group. Scores only rise; allowing a network resets them. Visits with an e-commerce order are never marked.
- Spam threshold (default 80): visits at or above it count as spam in the report, the accuracy check and the visitor log.
- Blocking threshold (default 90, at least 80): with automatic blocking on, groups at or above it are blocked during tracking.
For administrators
- Activity log: with Matomo's ActivityLog plugin, rule changes and imports, signal weights and bot/human marks are recorded with user and time.
- Diagnostics: Matomo's system check shows whether the hourly analysis runs on time, how old the network database is and the license status.
- API: spam overview, spam networks with their IP ranges, detected spam sources (also as CSV), status and network rules.
- Large instances: the analysis time per run and the row limits of the spam networks report can be raised in config.ini.
Requirements
-
Matomo 5 (5.0 or newer, below 6.0), PHP 8.1 or newer.
-
Matomo's scheduled tasks must run (cron with core:archive, or browser-triggered archiving); the analysis runs every hour.
-
A network (ASN) database in Matomo's GeoIP directory, which you install and keep up to date yourself:
- DB-IP IP to ASN Lite: free, no account, CC BY 4.0; Matomo's automatic geolocation updates can download it every month.
- MaxMind GeoLite2-ASN: free with a MaxMind account.
The database is not included with the plugin. Without one, only IP ranges are evaluated.
-
Recommended: GeoIp2 as location provider (countries).
Getting started
- Install and activate the plugin and set up the network database; the admin page guides you.
- Leave automatic blocking off for a few days and look at the spam networks report and the detected sources.
- Block obvious hosting networks yourself, several at once if you like.
- Mark some visits as bot or human in the visitor log and check precision and detection rate.
- Turn on automatic blocking once the accuracy looks right.
Settings
Administration › System › General settings › FeinwerkTrackingSpamScore
| Setting | Default | Purpose |
|---|---|---|
| Block detected spam networks automatically | off | Blocks networks and IP ranges at or above the blocking threshold for 7 days. Your own rules always apply. |
| Spam threshold | 80 | Score (30 to 100) from which visits count as spam. |
| Blocking threshold | 90 | Score (80 to 100) needed for automatic blocking. |
| Analysis window | 24 hours | Recent traffic the hourly analysis looks at. |
| Minimum group size | 8 | Visits a group needs before it is evaluated. |
Per website (Administration › Websites › Manage, super users): Spam protection: blocking on this website. Per user (Personal › Settings): Email me about new spam networks.
Privacy
All signals come from data Matomo already stores: network and country from the IP address, visit duration, actions, events, referrer type, browser and device. No additional data is collected and nothing leaves your server. Tracked visits are only deleted when you start it yourself, after counting and confirming.
License
Commercial plugin under the Feinwerk EULA.
-
v5.0.2 Nov 15, 2026
- Tips of other Feinwerk plugins are shown correctly again when Feinwerk Tracking Spam Score is installed.
-
v5.0.1 Nov 11, 2026
- The feedback question and tips now take a single compact line.
v5.0.0
- Blocked referrers: requests from websites you block are no longer tracked, and the same visitor's further requests stay blocked for a duration you set (default 24 hours), with and without cookies. E-commerce orders always pass.
- With Feinwerk Sentinel: alarms about missing or dropped visits name the blocks set shortly before.
- Below the spam networks report and on the admin page you can tell us with one click whether everything works as expected, and reach Feinwerk support.
- Administrators see one quiet line with a tip from Feinwerk below the report. The question and the tip can be switched off in the configuration.
- New version number: the version for Matomo 5 is now called 5.x.
-
v0.12.3 Oct 15, 2026
- New installations record visits right after the plugin is activated, no database update is needed first. Before, Matomo recorded no visits at all (every tracking request failed) until a super user had run the database update.
- If you newly installed 0.12.2 and have not run the database update yet, please run it now: Matomo shows a notice, and a super user runs it. Visits are recorded again only after that. Updates from a version before 0.11.0 also need the database update once, updates from 0.11.0 or newer need none.
- Week, month and year reports no longer count visits that were deleted after their day had been processed, for example with Matomo's GDPR tools.
- Hosting networks: the organisations that Matomo's TrackingSpamPrevention blocks count as hosting networks again (its list moved from the config file into a setting in TrackingSpamPrevention 5.2). They count while its option to block cloud providers is turned on.
- Admin page: while TrackingSpamPrevention is active, a note explains that it keeps applying its own rules, also to networks and IP ranges you allow here.
- Rules, filters and visit marks sent through the HTTP API are accepted with spaces around the value.
- Dark mode: the signal names on the admin page and the tags in reports and lists are readable.
- German texts of the license notice and the IP range form use the formal form (Sie).
- The license notice and the e-mail about new spam networks name the plugin FeinwerkTrackingSpamScore.
- The license terms ship as
LICENSE.txt. - No new settings.
-
v0.12.2 Oct 13, 2026
-
v0.12.1 Oct 8, 2026
-
v0.7.0 Oct 1, 2026
-
v0.5.1 Sep 26, 2026
-
v0.4.0 Jul 21, 2026