Skip to content

andrzejewsky/plugin-AnonymousPiwikUsageMeasurement

 
 

Repository files navigation

Piwik AnonymousPiwikUsageMeasurement Plugin

Build Status

Description

Help us to improve Piwik by sending anonymous usage data of your Piwik service to the creators of Piwik and/or get usage data yourself.

Track usage of your Piwik service into up to three Piwiks:

  • demo-anonymous.piwik.org (enabled by default but can be disabled). The tracked data will be used to make Piwik better. Thank you for your help!
  • your own Piwik (can be configured optionally)
  • a custom Piwik (can be configured optionally)

What is Piwik doing to make sure the data is anonymized?

We are very careful in what we track and we make sure to anonymize data that could contain user data.

  • We overwrite the page title as the title could contain the name of the viewed website
  • We remove any referrer information
  • We replace URL paramaters with a predefined value apart from a few whitelisted ones to make sure no actual token_auth, CSRF token or user defined value will be tracked
  • On demo-anonymous.piwik.org 3 bytes of the IP are anonymised (eg when IP is 192.168.1.1 we track only 192.0.0.0). The original IP is not used to identify your location and provider information is not collected.
  • We do not just track any outlinks or downloads

When should I not install this plugin?

If you have developed a custom Piwik plugin that contains for example the name of your business in any of the following names we recommend to not install this plugin as it might be tracked:

  • name of a plugin
  • name of a controller action
  • name of a report
  • name of a widget
  • name of an API method

Plugins that are installed via the Marketplace should not pose a problem as their names don't contain any user specific information such as the name of your business.

We track any information as efficient as possible to not slow down your Piwik. If you have already performance problems with your Piwik we recommend to not install this plugin though.

Which data is tracked?

When the plugin is activated, the following data will be tracked:

  • The pages and reports that are viewed
  • The visitors' software and devices data like the used browser and the resolution
  • Some clicks or interactions with certain selectors or buttons. For example we track an event when a segment is selected but we do not track the actual segment.
  • In a daily task we track the following data:
    • Piwik version
    • PHP version
    • Number of websites
    • Number of users
    • Number of segments
    • How often which API method was called (only plugin name and method name but no parameters) and how long the API calls took on average.

FAQ

Are there any prerequisites?

  • If sending usage data to Piwik is enabled, the Piwik installation must be connected to the internet
  • If tracking to a custom Piwik installation is enabled, your Piwik installation and your Piwik users must be able to connect to this instance
  • If tracking to a custom Piwik installation is enabled and your Piwik is served via HTTPS, the custom Piwik installation must be available via HTTPS as well

Why was this plugin created?

This plugin was created to provide a simple way to measure how Piwik product itself is being used. The opt-in and anonymised usage tracking information will be used by the Piwik creators to build a better product and a great user experience.

Who has access to the tracked data at demo-anonymous.piwik.org?

The data is public and therefore can be seen by anyone on http://demo-anonymous.piwik.org.

This is to assure the tracked data is anonymous (transparency) and to showcase how Piwik can be used to track an application.

Changelog

  • 0.2.0 Add possibility to enable/disable anonymization and tracking user login as userID
  • 0.1.4 Fixed a bug that failed to track under HTTPS under circumstances
  • 0.1.3 Updated plugin description only
  • 0.1.2 Bugfixes
  • 0.1.1 Track average API executime time
  • 0.1.0 Initial release

Support

Please direct any feedback to github.com/piwik/plugin-AnonymousPiwikUsageMeasurement/issues

About

Help making Piwik better by sending anonymized usage data to the creator of Piwik, to your own Piwik instance and/or to any other Piwik instance

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 52.5%
  • JavaScript 47.5%