Set up the connector

1. Create a Matomo API token

In Matomo, go to Administration → Personal → Security and click Create new token. Copy the token — you need it in step 3.

Use a dedicated Matomo user with view access only. The connector only reads data.

2. Check site access

Under Administration → System → Users, make sure this user has at least view access to every website you want to report on.

3. Add your Matomo instance

Create an account at datastudio.viu.one, then add an instance with your Matomo URL and the API token from step 1.

4. Add the connector in Data Studio

Open the Matomo connector in Data Studio — or search for “Matomo Analytics” in the connector gallery.

1. Authorize the connector with your Google account.
2. Sign in with your datastudio.viu.one credentials (not your Matomo login).
3. Select instance, site and report, then click Connect.
4. Name the data source after the site and report it contains.

The fields are configured automatically. Create a new report from the data source or add it to an existing one.

5. Add more reports

Each data source holds one Matomo report. For more reports, add further data sources as in step 4.

Every chart queries Matomo live. These habits keep reports quick:

• Short default date ranges. Add a date range control so viewers can widen it when needed.
• Specific reports instead of “Main metrics”. Most metrics are also available in smaller sub-reports.
• Limit rows in the connector, not in Data Studio. For example, filter landing pages in the data source configuration.
• Matomo Custom Reports pre-filter data on the Matomo side.
• Fewer charts per page.
• Data Studio’s “Extract data” for dashboards that don’t need live data.

Data Studio limits a single response to about 50 MB — very large reports (for example more than 30,000 page URLs) can hit that limit.