How to enable the whitelist feature in Matomo
8 min
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 " \<font color="#2166ae">com purplepublish purpledocumentationapp\</font> " 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 \<font color="#2166ae">https //{package name of the app}/{event name}\</font> example the triggered action event is " \<font color="#2166ae">app bookmark added"\</font> and this results in the url as follows being sent \<font color="#2166ae">https //com purplepublish purpledocumentationapp/app bookmark added\</font> view events for view events, the path template can be configured as a "path" or a "full url" path "app menu" { "templates" { "path" "/app menu", "title" "app/menu" } } 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 \<font color="#2166ae">https //{package name of the app}/{path}\</font> example the triggered view event is " \<font color="#2166ae">/app/appmenu"\</font> and this results in the url as follows being sent \<font color="#2166ae">https //\</font> \<font color="#2166ae">com purplepublish purpledocumentationapp\</font> \<font color="#2166ae">/app/appmenu\</font> b) when configured as url the template structure of the sent url for view events is \<font color="#2166ae">{path}\</font> example the triggered view event is " \<font color="#2166ae">https //com \</font> \<font color="#2166ae">purplepublish\</font> \<font color="#2166ae"> custom/app/any path"\</font> and this results in the url as follows being sent \<font color="#2166ae">https //com \</font> \<font color="#2166ae">purplepublish\</font> \<font color="#2166ae"> custom/app/any path\</font> 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