Skip to main content

Get help for ARIS

SaaS - Configure Matomo integration

You can integrate Matomo to obtain analytic data of the ARIS system. The Matomo integration is valid across all tenants. Tracking must be activated in the browser, otherwise the relevant data from ARIS will not be transferred to Matomo.

Prerequisite

  • You have the User administrator function privilege.

  • You have disabled the Do not track browser option.

Procedure. Procedure
  1. Setup a cloud hosted Matomo analytics website. Skip this step if you already have a Matomo analytics web portal.

    1. Go to the Matomo website and create a new page. Enter your e-mail address and the website address you want to observe.

    2. Accept the terms and conditions and the data processing agreement (DPA).

    3. Click Start improving your websites now. You will receive an e-mail with a link.

    4. Click this link and specify your password. Remember the URL of the page on which you set your password. You will need it in ARIS when you configure the Matomo integration.

    5. Click Settings Settings > Websites > Custom Dimensions.

    6. Click Configure a new dimension.

    7. Enter a name. We strongly recommend that you enter tenant as the name.

    8. Enable Active.

    9. Click Create.

    10. Under Visit Dimension, the ID of the custom dimension is displayed. Remember this dimension ID. You will need it in ARIS when you configure the Matomo integration.

    11. Under Action Dimension, click Configure a new dimension. Enter resource-path as the name, enable Active and click Create. The ID of the Action Dimension is displayed. Remember this dimension ID. You will need it in ARIS when you configure the Matomo integration. Do the same for the resource-type. The ID of the Action Dimension is displayed. Remember this dimension ID. You will need it in ARIS when you configure the Matomo integration.

    12. Select Personal > Security to generate a new token.

    13. Click Create new token.

    14. Enter your password to confirm the action.

    15. Enter a description and disable Only allow secure request.

    16. Click Create new token.

    17. Click icon_epc_copy Copy to copy this token to the clipboard. You can copy this token only once. Remember this token. You will need it in ARIS when you configure the Matomo integration.

  2. Setup the Matomo integration in ARIS.

    1. Click Application launcher Application launcher > Administration Administration > External system integration.

    2. Enable Enable Matomo integration.

    3. Enter the URL of your Matomo website.

    4. Enter the authentication token.

    5. Enter the custom dimension in the ID of tenant dimension for Matomo field.

    6. Enter the ID of the resource-path in the ID of resource path for Matomo field.

    7. Enter the ID of the resource-type in the ID of resource type for Matomo field.

    8. Click Apply.

You have set up the ARIS-Matomo integration. The configuration of the Matomo integration is saved when the default tenant is backed up. It can be restored.

To check whether everything is set up correctly, log out of ARIS and log in again. Log in to your Matomo site and click Dashboards. If everything is set up correctly, you will see a dashboard and the first two events that were tracked.

All actions from the same computer within a time frame of 30 minutes are regarded as one visit, regardless of which browser or tenant is used.

Logged are all activities under Published content. In the modeling component, nothing is logged. Searches and search types are logged.

The client IP address is logged. The client sends a request, and the server responds. The IP address seen by the server is the client IP address. If the user uses a browser from a company network, the client IP address can be a company address.

Please refer to the Matomo documentation for further details:

How is a visit defined in Matomo?

What data does Matomo track?

How does Matomo detect unique and returning visitors?

How is a unique visitor counted in Matomo?

Why the reports are not up to date in Matomo Cloud?