Matomo icon

Matomo

Use the Matomo API

Actions539

Overview

This node integrates with the Matomo API to perform various operations related to the 'Custom Dimension' resource, specifically the 'Get Custom Dimension' operation. It allows users to retrieve custom dimension reports for a specified site and period by sending HTTP requests to the Matomo API with user-defined query parameters. This node is useful for analytics and reporting scenarios where detailed custom dimension data from Matomo is required, such as tracking user interactions or segmenting data based on custom dimensions.

Use Case Examples

  1. Retrieve a custom dimension report for a specific website and date range to analyze user behavior.
  2. Fetch configured custom dimensions for a site to understand which dimensions are currently active and available.
  3. Get available scopes for custom dimensions to determine the data level (action, conversion, visit) applicable for custom dimensions.

Properties

Name Meaning
Query Parameters Collection of optional query parameters to customize the API request for fetching custom dimension data, such as filtering by site ID, date, scope, and other Matomo-specific options.
Request Body JSON object for request body, used for POST operations if applicable (not typically used for 'Get Custom Dimension' operation).

Output

JSON

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

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 authentication errors.
  • Verify that the query parameters are correctly formatted and valid for the Matomo API method being called; invalid parameters may result in API errors or empty responses.
  • Check network connectivity to the Matomo server to avoid request timeouts or connection errors.
  • If the API response is empty or unexpected, confirm that the specified site ID and date range have data available in Matomo.

Links

Discussion