Open navigation

Matomo connection guide

Follow these steps to connect your Matomo data to Supermetrics.

If you need to connect this data source to one of our data warehouse or cloud storage destinations, explore our data warehouse and cloud storage setup guides.

Before you begin

To connect your Matomo account to Supermetrics, you need your Matomo base URL and your authentication token.

Get your base URL
  1. Log in to Matomo, and open your dashboard.
  2. Take a look at the URL in your address bar.
  3. Copy the first part of the URL. This is your Base URL to use for login:
Get your authentication token
  1. Log in to Matomo, and open your dashboard.
  2. On the upper right-hand side, click the cogwheel icon to get to the Administration page.
  3. On the left-hand side, under Personal, click Security.
  4. Scroll down to the Auth tokens section and click Create new token.
  5. Enter your password to continue.
  6. Enter a description for the token, for example, “Supermetrics”.
  7. Click Create token.
  8. Copy the token and store it in a secure place for later.

Query types

Set up your Matomo queries using any of the query types described below.

Reference list: Matomo query types
  • Visitor overview: Engagement metrics for the whole website.
  • Visitor devices: Engagement metrics by device type.
  • Visitor locations: Engagement metrics by country.
  • Visitor language: Engagement metrics by web browser language.
  • Pages: Engagement metrics by specific website pages.
  • Channels: Acquisition and engagement metrics by channel type.
  • Referrers: Acquisition and engagement metrics by specific referrers.
  • Campaigns: Acquisition and engagement metrics by campaigns.
  • Campaign keywords: Acquisition and engagement metrics by keywords used in campaigns.
  • Search engines: Acquisition and engagement metrics by search engine.
  • Search keywords: Acquisition and engagement metrics by search keywords.
  • Ecommerce overview: Overall ecommerce sales for the whole website.
  • Ecommerce products: Ecommerce sales by specific products.


Google Sheets Looker StudioExcel

Make sure you've installed the Supermetrics add-on before you connect.

  1. Open a new Google Sheets file.
  2. Navigate to ExtensionsSupermetricsLaunch sidebar to open Supermetrics.
  3. Click Create new query.
  4. Under Data source, select Matomo.
  5. Enter your Base URL and Auth token.
  6. Enter a name for your account for you to identify it later.
  7. Click Start.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.

More resources

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.