dmreiland / snowplow-javascript-tracker

Snowplow event tracker for client-side JavaScript. Add analytics to your websites and web apps. (See also: snowplow-nodejs-tracker)

JavaScript web analytics for Snowplow

Overview

Add analytics to your websites and web apps with the Snowplow event tracker for JavaScript.

With this tracker you can collect user event data (page views, e-commerce transactions etc) from the client-side tier of your websites and web apps.

Find out more

Technical Docs	Setup Guide	Contributing
Technical Docs	Setup Guide	Contributing

Developers

Contributing quick start

Assuming git and Docker installed:

Clone repository

host$ git clone https://github.com/snowplow/snowplow-javascript-tracker.git

Building Tracker Core

host$ cd snowplow-javascript-tracker/core
host$ docker build -t core .
host$ docker run -v "$(pwd)":"/code" core npm run build

From the /core folder, build the core library using npm run build and run unit tests with npm run test.

Building Tracker

host$ cd snowplow-javascript-tracker
host$ docker build -t tracker .
host$ docker run -v "$(pwd)":"/code" tracker npm run build

Build the tracker using npm run build and run unit tests with npm run test:unit.

Testing

Copyright and license

The Snowplow JavaScript Tracker is based on Anthon Pang's piwik.js, the JavaScript tracker for the open-source Piwik project, and is distributed under the same license (Simplified BSD).

Significant portions of the Snowplow JavaScript Tracker copyright 2010 Anthon Pang. Remainder copyright 2012-2020 Snowplow Analytics Ltd.

Licensed under the Simplified BSD license.