Open navigation

Matomo connection guide

Follow these steps to connect your Matomo data to Supermetrics and use your data in Google Sheets, Looker Studio, Excel, and Power BI, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.


You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.


Before you begin

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


These instructions apply to both Matomo cloud-based version and on-premise installation.


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: https://yourcompany.matomo.cloud/index.php
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.

Instructions

Google Sheets

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.

Looker Studio

Make sure you've connected Supermetrics to Looker Studio before following the steps below.

  1. Open the Supermetrics Looker Studio data source gallery.
  2. Navigate to Matomo and click Start free trial.
  3. You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
  4. Once that's done, or if you've done it before, click the right-hand Authorize button (under "Matomo requires authorization to connect to data").
  5. Select a team that has access to the account you want to connect.
  6. Choose to make this connection shared or private.
  7. Enter your Base URL and Auth token.
  8. Enter a name for the account for you to identify it later.
  9. Click Start.
  10. Select the accounts you'd like to include in your reporting.
  11. Select the query type you want to fetch data for, and click Next.
  12. In the pane's top right, click Connect.
  13. Click Create report.
  14. Click Add to report.

Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.

Excel

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

  1. Open an Excel file.
  2. Click DataShow Supermetrics.
  3. Under Data source, select Matomo.
  4. Choose to make this connection shared or private.
  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 Excel.

Power BI
  1. Log in to the Supermetrics Hub.
  2. In the left-side menu, under Export, click Power BI.
  3. Click Select data source.
  4. Select the Matomo data source.
  5. Enter your Base URL and Auth token.
  6. Enter a name for the account for you to identify it later.
  7. Click Start.
  8. Fill in the query details.
  9. Click Run query to test your query.
The Supermetrics API
  1. Log in to the Supermetrics Hub.
  2. In the left-side menu, under Transform, click Query Manager (API).
  3. Select for Supermetrics API from the dropdown menu next to the page title.
  4. Click Select data source.
  5. Select the Matomo data source.
  6. Enter your Base URL and Auth token.
  7. Enter a name for the account for you to identify it later.
  8. Click Start.
  9. Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
  10. Click Run to test your query.
Supermetrics Hub
  1. Log in to the Supermetrics Hub.
  2. In the left-side menu, select ConnectData sources.
  3. Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
  4. Hover over the Matomo data source, and click Connect.
  5. Enter your Base URL and Auth token.
  6. Enter a name for the account for you to identify it later.
  7. Click Start.


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.