Matomo icon

Matomo

Use the Matomo API

Actions539

Overview

This node integrates with the Matomo API to perform various operations related to Matomo analytics data. Specifically, for the 'Custom Report' resource and 'Get Custom Report' operation, it fetches custom report data for a specified site, period, and report ID. This is useful for users who want to retrieve detailed analytics reports customized to their needs, such as specific metrics and dimensions defined in Matomo custom reports. Practical examples include fetching a custom report to analyze user behavior on a website or to generate tailored analytics dashboards.

Use Case Examples

  1. Fetch a custom report for a website to analyze visitor metrics over a specific date range.
  2. Retrieve a custom report to monitor e-commerce conversions and user engagement metrics.

Properties

Name Meaning
Query Parameters A collection of optional parameters to customize the API request for the custom report, such as site ID, period, date, segment, and other filters.

Output

JSON

  • json - The JSON response from the Matomo API containing the custom report data.

Dependencies

  • Requires Matomo API credentials including domain URL and authentication token.

Troubleshooting

  • Ensure that the Matomo domain URL and authentication token are correctly configured in the node credentials; missing these will cause an error.
  • Verify that the query parameters are correctly set and valid for the Matomo API to avoid request failures.
  • Check the API method and resource names to ensure they match the supported operations; unknown resources or operations will throw errors.
  • If the API response is empty or returns '204 No Content', verify that the requested report ID and site ID exist and have data for the specified period.

Links

Discussion