A wrapper for the Piwik tracking HTTP API

Usage no npm install needed!

<script type="module">
  import piwikTracker from 'https://cdn.skypack.dev/piwik-tracker';


Piwik Tracker NPM version Build Status

A wrapper for the Piwik Tracking HTTP API


First, install piwik-tracker as a dependency:

npm install --save piwik-tracker

Then, use it in your project:

var PiwikTracker = require('piwik-tracker');

// Initialize with your site ID and Piwik URL
var piwik = new PiwikTracker(1, 'http://mywebsite.com/piwik.php');

// Optional: Respond to tracking errors
piwik.on('error', function(err) {
  console.log('error tracking request: ', err)

// Track a request URL:
// Either as a simple string …

// … or provide further options:
  url: 'http://example.com/track/this/url',
  action_name: 'This will be shown in your dashboard',
  ua: 'Node.js v0.10.24',
  cvar: JSON.stringify({
    '1': ['custom variable name', 'custom variable value']

That's it. For a complete list of options, see Piwik's Tracking HTTP API Reference.


MIT License