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, data warehouses, 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. The first part of the URL before index.php is your base URL to use for login. For example: https://yourcompany.matomo.cloud
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. Choose to make this connection shared or private.
  8. Click Start.

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

Looker Studio
  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. Enter your base URL and auth token.
  7. Enter a name for the account for you to identify it later.
  8. Choose to make this connection shared or private.
  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. Enter your base URL and auth token.
  5. Enter a name for your account for you to identify it later.
  6. Choose to make this connection shared or private.
  7. Click Start.

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

Data warehouse

Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.


Set up transfer for BigQuery (marketplace)

Make sure you've enrolled the data source before you connect.

  1. Log in to the Google Cloud Platform.
  2. Navigate to BigQueryData transfers.
  3. Click + Create transfer.
  4. Select the Matomo data source.
  5. Fill in the transfer details. See detailed instructions on how to set up a transfer.
  6. Under Third-party connection, click Connect source.
  7. Accept the agreement.
  8. Click Authorize with Matomo.
  9. Enter your base URL and auth token.
  10. Enter a name for your account for you to identify it later.
  11. Click Start.
  12. Select the accounts you'd like to include in your reporting and define the transfer settings.
  13. Click Submit.
  14. Click Save.


Set up data warehouse transfer on the Supermetrics Hub

Make sure you've set up a data warehouse destination before you connect.

  1. Log in to the Supermetrics Hub.
  2. In the sidebar, go to StorageTransfers.
  3. Click New transfer. If you haven't created any transfers yet, click Schedule first transfer
  4. Select the Matomo data source, and click OK.
  5. Fill in the transfer details. See detailed instructions on how to set up a transfer.
  6. In the Connections section, click Add new connection.
  7. Enter your base URL and auth token.
  8. Enter a name for your account for you to identify it later.
  9. Click Start.
  10. In the transfer setup view, select the accounts you'd like to include in your reporting.
  11. Click Create transfer.
Power BI
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, go to DestinationsPower BI.
  3. Click Create or edit queries.
  4. Click Select a 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.
  10. Click Run query to test your query.
The Supermetrics API
  1. Log in to the Supermetrics Hub.
  2. In the sidebar, click 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 sidebar, click Data 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.