Matomo is an open-source web analytics platform that lets businesses track, analyze, and optimize website traffic while maintaining full data ownership and privacy compliance.

To avoid a failed connection or error when connecting Matomo to a Client, the person connecting must have:

Once the requirements above are met, follow these steps to connect Matomo to a Client.

Step 1: Open the Client where you'd like to connect Matomo, then click the Data tab at the top.

Step 2: Click the blue Connect Source button in the upper right corner of the page.

Step 3: Search for Matomo in the search bar at the top, then click the Matomo card.

Step 4: Click Connect New Account to launch the authorization window. If you've previously connected an account, click the gray Plus (+) sign at the bottom instead.

Step 5: On the next page, enter your server's URL and a valid auth token from Matomo.

Step 6: Click Save in the bottom left corner to finalize the connection.

The auth token is a private key that lets a third party securely access your Matomo data via API. Review this Matomo help article to find your auth token.

Yes. The Matomo integration only sends data using POST requests, so a token created with the "Secure Only" setting in Matomo will work without issue.

Here's a table showing common native Matomo Revenue metrics alongside their corresponding AgencyAnalytics Matomo integration Revenue metrics:

This error appears when you use (or open a section that uses) the Channel filter without the Channel Type or Referrer Type segment enabled in the native Matomo platform. You can enable this segment in the native Matomo platform by following this Matomo guide.

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄