README
A wrapper for the Piwik Tracking HTTP API
Usage
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 …
piwik.track('http://example.com/track/this/url');
// … or provide further options:
piwik.track({
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.