Matomo icon

Matomo

Use the Matomo API

Actions539

Overview

This node integrates with the Matomo API to perform various operations related to marketing campaigns reporting and other Matomo resources. It allows users to specify a resource and an operation to execute, along with query parameters and request body data. The node constructs the appropriate API request URL and method based on the selected resource and operation, sends the request to the Matomo API, and returns the response data. This is useful for automating data retrieval and management tasks in Matomo, such as fetching campaign sources, managing experiments, or retrieving analytics data.

Use Case Examples

  1. Fetch marketing campaign source data for a specific site and period by selecting the 'Marketing Campaigns Reporting' resource and the 'Get Source' operation, then providing relevant query parameters like site ID and date range.
  2. Retrieve active A/B testing experiments by selecting the 'AB Testing' resource and the 'Get Active Experiments' operation.
  3. Get detailed page titles metrics by choosing the 'Action' resource and the 'Get Page Titles' operation.

Properties

Name Meaning
Query Parameters A collection of optional parameters to customize the API request, such as filters, limits, and specific identifiers relevant to the selected resource and operation.

Output

JSON

  • responseData - The JSON response data returned from the Matomo API call, containing the requested information or operation result.

Dependencies

  • Matomo API endpoint and an API authentication token (token_auth)

Troubleshooting

  • Ensure that the Matomo domain URL and authentication token are correctly provided in the node credentials; missing these will cause an error.
  • Verify that the selected resource and operation are supported and correctly spelled; unsupported combinations will result in an error.
  • Check that query parameters are correctly formatted and valid for the chosen operation to avoid API request failures.
  • If the API response is empty or unexpected, verify the permissions and access rights of the API token used.

Links

  • Matomo API Reference - Official documentation for the Matomo API, detailing available resources, methods, and parameters.

Discussion