# Metrics Configuration & Software Details

{{ errorMessage }}

OpenAIRE’s usage statistic service uses the Piwik Open Source Analytics platform (piwik.org) to track usage activity. When metrics are enabled for a repository, two unique identifiers are generated - a piwik-ID that associates the repository with its usage events in Piwik and an authentication-ID that allows to track usage activity on the Piwik platform. Metadata views and item downloads are tracked and automatically sent to Piwik. Statistics are generated using the COUNTER Code of practice directives.

OpenAIRE's usage statistics service tracking code exploits Piwik’s API. In order to make the tracking of usage events from repositories more robust, it was necessary to implement repository platform specific patches and plugins starting with DSpace and EPrints. The code is maintained on Github:

- as a patch for various versions of DSpace (https://github.com/openaire/OpenAIRE-Piwik-DSpace)
- as an Eprints plugin for version 3 (https://github.com/openaire/EPrints-OAPiwik)

To configure your repository to allow tracking in Piwik platform, please change the configuration files with the following parameters and values, generated for your site:

PiwikID
  {{ piwik.siteId }}
AuthenticationToken
  {{ piwik.authenticationToken }}

Details for the configuration files are given in the README of the tracking code.

NOTE - You will be informed by e-mail that the installation of the tracking code has been validated and when the usage statistics will be available.