Plugins View all plugins
Resources
Live demo ↗ Request a plugin Sign in feinwerk.io ↗ Get the connector
New

The Feinwerk Connector is now in the Matomo Marketplace. Install it right inside Matomo, no download, no FTP. Read the news · Here is how →

Channel Grouping · Marketing & SEO · paid

Know your channels, not just your referrers.

Group hundreds of traffic sources into the marketing channels you actually steer: Organic, Paid, Email, Social or your own.

from €59/month · cancel any time

Latest v5.0.2 · Matomo ≥ 5.3.0

Running on 14 Matomo instances

How Channel Grouping works: every visit lands in one of your channels by rule
What it does for you
01

Marketing truth at a glance

How much traffic really comes from email? How does paid compare to organic? One report answers it.

02

Rules, your way

11 operators for precise, rule-based mapping. Your channel definitions, not someone else's.

03

Your tracking stays as it is

Referrer and campaign data stay exactly as tracked. The plugin adds the channel to each visit. You can refine rules anytime and re-assign past visits.

Click to enlarge

Pricing
Monthly
€59 per month
Try free for 14 days

then €59, cancel any time

Yearly Popular
€590 per year

save 17% vs. monthly

Try free for 14 days

then €590, cancel any time

2 Years
€944 for 2 years

save 33% vs. monthly

Buy now
  • 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
In the Analytics Bundle with 5 more plugins, 23% cheaper Analytics Bundle → Use cases

Define and compare your own marketing channels in Matomo

Group referrers and UTM campaigns by rule into the marketing channels your team actually works with.

Read the use case →
Frequently asked questions

No. A default grouping modelled on Google Analytics 4, with 19 channels such as Paid Search, Paid Social, Organic Search, Email and AI Assistants, is created with one click. You refine it or replace it with your own rules.

We recommend the free Marketing Campaigns Reporting plugin for campaign fields such as utm_source and utm_medium. Without it, the default grouping recognises campaign links only by click IDs. The plugin requires Matomo 5.3 or later.

Visits that match no channel appear as "Not assigned" in the report, so your totals always add up and nothing silently disappears.

Your referrer and campaign data stay exactly as tracked. In addition, the plugin stores each visit's channel, determined at tracking time and used for segments, conversions and revenue. After rule changes, the plugin re-assigns past visits automatically.

Yes. The plugin recognises click IDs from Google Ads, Microsoft Advertising, Meta, TikTok, LinkedIn, X, Snapchat, Pinterest, Yandex and Mailchimp in the landing page URL. A Google Ads click therefore lands in Paid Search. Only the type of click ID is stored, never its value.

In the Channel Grouping report, the channel of the purchase visit counts, so Direct. The attribution reports credit the purchase to the channel of the last non-direct visit or of the first visit within the 90 days before.

Yes. With Visit Journey 0.3.0 or later your channels appear automatically in the visitor paths: in *Paths from the entry page* as the first column before the entry page, and in *Paths to the goal* wherever a path reaches the start of the visit. They are exactly the channels you defined in Channel Grouping with rules.

Install via the Feinwerk connector

Heads-up: this version changes database tables

No database schema change when updating from 0.9.0 or later; updating from an older version adds one column to the visits table (log_visit), which on MySQL 5.7 with very large visit tables can take a while. A new installation gets its two log_visit columns from this database update. Updating from a version before 0.11.0 recalculates the channel reports of sites with goals or ecommerce once for the standard period, updating from a version before 0.10.3 rebuilds the week, month and year channel reports once from the daily reports, at most 24 months back (extra archiving load).

Plan the installation for a maintenance window on large instances.

  1. 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.
  2. 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.
  3. 03 Open the Feinwerk Plugins screen, find Channel Grouping, and click Install.
How to install the connector

Prefer a manual install? After the purchase you will find the ZIP download in your customer account. · Documentation for Channel Grouping

Missing a feature in Channel Grouping? Tell us what you need →

For the technically curious

Channel Grouping for Matomo

Group your traffic sources into meaningful marketing channels and understand your marketing performance at a glance.


The problem

Matomo shows you hundreds of referrers, campaigns and traffic sources. But how much traffic really comes from email marketing? And how do your paid campaigns compare to organic search?

The solution

Channel Grouping combines your traffic sources into channels, exactly the way you need them.


Features

Flexible rule-based mapping

Define precise rules that decide which visit belongs to which channel.

  • 11 operators: equals, does not equal, contains, does not contain, starts with, ends with, matches regex, is empty, is not empty, is in list, is not in list
  • Bundled source lists: search engines, social networks, video platforms, shopping sites, email and AI assistants, including sources from Germany, Austria and Switzerland
  • Source and medium: derived from campaign, click ID and referrer, plus rules on the landing page (URL or path)
  • Any combination: rules are combined with OR, conditions within a rule with AND
  • Channel conditions: apply to all rules of a channel
  • Order: channels are checked from top to bottom, and the first match wins. You change the order with a click
  • Value suggestions: values from your visits of the last 30 days, including campaigns and custom dimensions

Ad clicks even without UTM parameters

The plugin recognises visits from ads by the click ID in the landing page URL, even when no UTM parameters are set.

  • Click IDs from Google Ads, Microsoft Advertising, Meta, TikTok, LinkedIn, X, Snapchat, Pinterest and Yandex, plus Mailchimp
  • Assigned correctly: a Google Ads click lands in Paid Search instead of Organic Search
  • Data-minimal: only the type of click ID is stored (such as "gclid"), never its value
  • Usable everywhere: as a dimension in rules, as the segment Click ID type and in the Visits Log

Editor with draft, test visit and impact

You edit a grouping completely in one editor and save it with one click.

  • Draft and active: prepare changes as a draft; only active groupings count for tracking and reports
  • Test visit: enter a landing page or referrer URL and see which channel applies and why
  • Impact before saving: visits per channel before and after, calculated on the newest visits of the last 30 days, with examples
  • Apply your way: a change applies only to new visits, to the standard period or from a day of your choice
  • Duplicate: copy a grouping as a draft and rework it calmly
  • Version history: every change is kept as a version. Compare versions, load them into the editor or copy them as a new grouping
  • Dark mode: the admin page follows Matomo's dark mode

Conversions and revenue per channel

See not just visits, but conversions and revenue per channel.

  • Conversions, conversion rate and revenue right in the channel report
  • Revenue from goals and ecommerce
  • The report also appears on Matomo's goal pages under Goals by Referrers
  • Ecommerce per channel under Ecommerce → Sales: orders, revenue, conversion rate, average order value and products purchased, with abandoned carts separately

Goal attribution

Which channel really brought the purchase? Two additional reports under Goals and Ecommerce → Sales answer that.

  • Channel (last non-direct touch): conversions from direct visits count for the channel the visitor last came through
  • Channel (first touch): every conversion counts for the channel of the first visit
  • 90-day lookback, adjustable or switchable off in the Matomo configuration
  • Also in email reports and through the API

Your channels in the visitor paths

With Visit Journey your channels also show up in the visitor paths: exactly the channels you defined here with rules, as the first column before the entry page and in the paths to the goal wherever a path reaches the start of the visit. That way paths and channel reports speak the same language.

Multiple websites

One grouping for all your websites, or individual settings per website.

Applies to Meaning
Only this website applies to this website only
Selected websites applies to the websites you select
All websites applies to all websites; only super users can create it

One grouping is active per level. If several levels apply to a website, the more specific one takes priority.


Evolution over time

Follow how your channels develop.

  • The graph Channel Grouping Over Time above the report, both in full width
  • Several metrics to choose from (visits, actions, conversions, revenue)
  • Show or hide channels via the legend

Segmentation

Use your channels as a segment in every Matomo report.

  • Dimension Channel Group in the segment editor, with suggestions from your channels
  • The report, goals, segment and Visits Log show the same channel for every visit
  • Combinable with all other segments

Sources per channel

Click a channel to see the individual referrers and campaigns behind it.

  • Sortable by every metric
  • Export like any Matomo report, for example as CSV, JSON or XML

Automatic re-assignment

When you change rules or channels, they apply to new visits at once. The plugin re-assigns past visits in the background and has the affected reports recalculated, as far back as Matomo re-archives reports (6 months by default). The admin page shows the progress.

For older periods or targeted runs, there is a command for the command line:

# Test first, without changing anything
./console feinwerkchannelgrouping:backfill --dry-run

# Re-evaluate all visits of one website in a period
./console feinwerkchannelgrouping:backfill --idsite=1 --from=2025-01-01 --to=2025-12-31 --force

The command has the reports of that period recalculated by itself.


Export and import

Back up your configuration or move it to another Matomo instance.

  • Export a grouping as a JSON file
  • Import with validation of the file, always as a draft, also for exports from older versions
  • Handy for moving a grouping from a test instance to production

Custom dimensions

Use your custom dimensions in channel rules.

  • Visit dimensions: detected automatically and available in rules
  • Flexible rules: combine them with referrer and campaign data
  • Your own classification: group by customer type, region or any other value

Note: only visit dimensions are supported. Action dimensions (for example for individual pageviews) are not available, because the channel is assigned per visit.

Examples:

  • Channels by customer type, such as "B2B" and "B2C"
  • Internal campaign classification
  • Channels by region or product

Metrics at a glance

Metric Meaning
Visits number of visits per channel
Actions pageviews, downloads, events and other actions
Actions per Visit average number of actions per visit
Avg. Time on Website average duration of a visit
Bounce Rate share of visits with only one action
Conversions number of goals reached
Conversion Rate share of visits with a conversion
Revenue revenue from goals and ecommerce

Preconfigured channels

Start right away with the default grouping ("Default Channel Grouping v2"), modelled on the default channel groups of Google Analytics 4. Its 19 channels are checked in this order:

Channel Captures
Direct visits without source and medium, for example from bookmarks or a typed address
Cross-network campaigns whose name contains "cross-network"
Paid Shopping paid visits from shopping sites or shopping campaigns
Paid Search paid visits from search engines, such as Google Ads clicks
Paid Social paid visits from social networks
Paid Video paid visits from video platforms
Display banner ads with a medium such as display, banner or cpm
Paid Other other paid visits (medium such as cpc, ppc, paid…, retargeting)
Organic Shopping unpaid visits from shopping sites
Organic Video unpaid visits from video platforms
Organic Social unpaid visits from social networks
Organic Search unpaid visits from search engines
AI Assistants visits from AI assistants such as ChatGPT, Perplexity or Gemini
Email email campaigns and webmail, also with utm_medium=newsletter
Affiliates campaigns with utm_medium=affiliate
Referral referrals from other websites
Audio campaigns with utm_medium=audio
SMS campaigns via SMS
Mobile Push Notifications campaigns via push notifications

Paid means the medium is, for example, cpc, ppc or paid_social, or a click ID such as gclid supplies it. As in Google Analytics 4, Direct only applies to visits without a medium. Everything else without a matching rule appears as Not assigned in the report. Adjust the channels or create your own. Existing groupings keep working unchanged.


Quick start

  1. Install the plugin and activate the free Marketing Campaigns Reporting plugin (recommended)
  2. Open Administration → Websites → Channel Grouping
  3. Click Create Default Grouping. The grouping is active right away; if the website already has one, it is created as a draft for you to check
  4. Done: the report appears under Acquisition → Channel Grouping

From now on, new visits get their channel at tracking time. The plugin assigns past visits in the background, and the admin page shows the progress.


Technical details

Requirements

  • Matomo 5.3 or later
  • PHP 8.1 or later
  • Recommended: the free Marketing Campaigns Reporting plugin for campaign fields (utm_source, utm_medium and more). Without it, the default grouping recognises campaign links only by click IDs

Archiving and data

  • The channel is determined at tracking time and stored with each visit. The report, goals, segment and Visits Log use this channel. Your referrer and campaign data stay unchanged.
  • Of click IDs, only the type is stored (one additional column in the visits table), never the value.
  • Every saved change of a grouping is kept as a version (the newest 50 per grouping), shown in the editor's History tab.
  • For attribution the plugin recognises visitors, like Matomo, by their visitor ID. Without cookies or a user ID an earlier visit may be missing.
  • The report is as current as Matomo's last archiving run.
  • Everyone with at least write access to the website can edit groupings; groupings for all websites need a super user.

Available dimensions

Referrer:

  • referrer_type (direct, search, social, website, campaign, ai)
  • referrer_name (for example "Google", "Facebook")
  • referrer_url
  • referrer_keyword

Campaign (UTM, with Marketing Campaigns Reporting):

  • campaign_name (utm_campaign)
  • campaign_source (utm_source)
  • campaign_medium (utm_medium)
  • campaign_content (utm_content)
  • campaign_keyword (utm_term)
  • campaign_id (utm_id)

Source, medium, landing page, click ID:

  • source and medium (derived from campaign, click ID and referrer)
  • landing_page_url and landing_page_path
  • click_id (click ID type, such as gclid)

Custom dimensions:

  • dimension1, dimension2 and more (visit dimensions)

Operators

Operator Meaning
equals exact match
does not equal no match
contains contains the value
does not contain does not contain the value
starts with starts with the value
ends with ends with the value
matches regex regular expression without delimiters, at most 500 characters
is empty field is empty
is not empty field has a value
is in list value is in one of the bundled source lists
is not in list value is not in the chosen source list

Upper and lower case are ignored unless the field Aa (Case Sensitive) is ticked.

API

The channel report is available through Matomo's Reporting API as FeinwerkChannelGrouping.getChannels, for example for exports or dashboards. Through the API, FeinwerkChannelGrouping.saveGrouping saves a grouping as a whole, getChannelsLastNonDirect and getChannelsFirstTouch return the attribution reports, getGroupingVersions the version history, getSourceLists returns the source lists and getAvailableOperators the value type per operator.

Upgrading from Channel Grouping

Up to version 0.5 this plugin was called ChannelGrouping. Install and activate FeinwerkChannelGrouping: it takes over groupings, channels, rules, the channel assignment of visits, archived reports, settings, email reports and saved views, and removes the old plugin automatically. Do not uninstall the old plugin yourself, as that would delete the channel data.

Related articles