How to enable the whitelist feature in Matomo
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
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".
"APP_MENU": {
"templates": {
"path": "https://com.purplepublish.custom/app/any_path",
"title": "App/Menu"
}
}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.
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.
