Matomo icon

Matomo

Use the Matomo API

Actions539

Overview

This node integrates with the Matomo API, allowing users to perform various operations across multiple Matomo resources. Specifically, for the 'Sites Manager' resource and the 'Set Global Excluded User Agents' operation, it enables setting user-agent substrings to be globally excluded from all sites tracked by Matomo. This is useful for filtering out unwanted traffic from specific user agents, such as bots or crawlers, to ensure cleaner analytics data.

Use Case Examples

  1. A user wants to exclude certain bots from all their tracked websites to avoid skewed analytics data. They use this node to set global excluded user agents in Matomo.
  2. An administrator managing multiple websites wants to globally block traffic from specific user agents across all sites for consistent data filtering.

Properties

Name Meaning
Query Parameters A collection of optional query parameters to customize the API request, such as filtering or specifying details relevant to the operation.
Request Body A JSON object representing the request payload to be sent with the API call, used for POST operations like setting global excluded user agents.

Output

JSON

  • Status Code - Indicates the HTTP status code or response status when no content is returned.
  • responseData - The JSON response data returned from the Matomo API call, parsed if possible.

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 errors.
  • Verify that the 'Request Body' JSON is correctly formatted for POST operations to avoid API errors.
  • Check that the selected resource and operation are supported and correctly spelled to prevent unknown resource errors.
  • If the API returns no content, the node outputs a '204 No Content' status; verify the API endpoint and parameters if unexpected.

Links

Discussion