# piwik-tracker

> A wrapper for the Piwik tracking HTTP API

Latest version **1.1.2** (published 2017-08-24) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install piwik-tracker
pnpm add piwik-tracker
yarn add piwik-tracker
bun add piwik-tracker
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.1.2 |
| Published | 2017-08-24 |
| First published | 2014-01-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/piwik-tracker) |
| Module format | CommonJS |
| Node | >=4.2.0 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 117 |
| Author | Frederic Hemberger |
| Maintainers | fhemberger |
| Keywords | piwik, analytics, tracking |

## Links

- npm: https://www.npmjs.com/package/piwik-tracker
- Repository: https://github.com/fhemberger/piwik-tracker
- Issues: https://github.com/fhemberger/piwik-tracker/issues
- npm.io page: https://npm.io/package/piwik-tracker

## Alternatives

- [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads
- [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads
- [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads
- [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads
- [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads

## Recent versions

- 1.1.2 (latest) — 2017-08-24
- 1.1.1 — 2017-06-06
- 1.1.0 — 2017-06-06
- 1.0.0 — 2016-07-28
- 0.1.2 — 2015-06-02
- 0.1.1 — 2014-09-02
- 0.1.0 — 2014-01-08

## README

# Piwik Tracker [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url]

> A wrapper for the Piwik Tracking HTTP API

## Usage

First, install `piwik-tracker` as a dependency:

```shell
npm install --save piwik-tracker
```

Then, use it in your project:

```javascript
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](http://developer.piwik.org/api-reference/tracking-api).


## License

[MIT License](http://en.wikipedia.org/wiki/MIT_License)

[npm-url]: https://npmjs.org/package/piwik-tracker
[npm-image]: http://img.shields.io/npm/v/piwik-tracker.svg

[travis-url]: http://travis-ci.org/fhemberger/piwik-tracker
[travis-image]: http://img.shields.io/travis/fhemberger/piwik-tracker.svg

---
_Source: https://npm.io/package/piwik-tracker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
