3rd party integrations
...
Tracking Services
Matomo / Matomo Tag Manager

How to enable the whitelist feature in Matomo

8min

How to enable the whitelist feature in Matomo

The motivation for the whitelist feature is that only data from known sources is accepted in Matomo and can be done in the Matomo site configuration.

Get the package name from your app



Document image


The resulting package name is:

"com.purplepublish.purpledocumentationapp"

Please note that Android and iOS can have different package names, due to structures that have grown over time. In this case, URLs with both package names must be stored in the Matomo site configuration.

Understanding the structure of sent URLs by native apps

Since within native apps are not URLs, existing PXP defines some structures on how to create

Action events

The structure of the sent URL for action events is:

https://{package_name_of_the_app}/{event_name}

Example The triggered action event is "app_bookmark_added" and this results in the URL as follows being sent:

https://com.purplepublish.purpledocumentationapp/app_bookmark_added

View events

For view events, the path-template can be configured as a "path" or a "full URL".

path
full URL


a) When configured as path

The template structure of the sent URL for view events is:

https://{package_name_of_the_app}/{path}

Example The triggered view event is "/app/appmenu" and this results in the URL as follows being sent:

https://com.purplepublish.purpledocumentationapp/app/appmenu

b) When configured as URL

The template structure of the sent URL for view events is:

{path}

Example The triggered view event is "https://com.purplepublish.custom/app/any_path" and this results in the URL as follows being sent:

https://com.purplepublish.custom/app/any_path

Enable and setup Whitelist-Feature in Matomo

Matomo-Site created for the Website

A new or existing Matomo site configuration regarding the whitelist feature could look like this. In this example, it was previously created for a website.

Document image


Add URLs sent by native apps and enable whitelist.

Now the URLs for the native apps must be added, and the whitelist feature activated via a checkbox.

Document image