philipherrmann / snowplow-javascript-tracker

Snowplow event tracker for client-side and server-side JavaScript. Add analytics to your websites, web apps and servers.

Browser and Node.js analytics for Snowplow

Snowplow is a scalable open-source platform for rich, high quality, low-latency data collection. It is designed to collect high quality, complete behavioral data for enterprise business.

To find out more, please check out the Snowplow website and our documentation.

Snowplow JavaScript Trackers Overview

The Snowplow JavaScript Trackers allow you to add analytics to your websites, web apps and Node.js applications when using a Snowplow pipeline.

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

Technical documentation can be found for each tracker in our Documentation.

@snowplow/browser-tracker (npm)

Technical Docs	Setup Guide
Technical Docs	Setup Guide

@snowplow/javascript-tracker (tag based)

Technical Docs	Setup Guide
Technical Docs	Setup Guide

@snowplow/node-tracker (npm)

Technical Docs	Setup Guide
Technical Docs	Setup Guide

Maintainers

Contributing
Contributing

Maintainer quick start

Assuming git, Node.js 12 LTS or 14 LTS are installed.

Clone repository

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

Building

npm install -g @microsoft/rush
rush update
rush build

Testing

To run unit tests:

rush test

To run e2e browser tests (locally):

• Add 127.0.0.1 snowplow-js-tracker.local to your hosts file:

cd trackers/javascript-tracker/
rushx test:e2e:local

Copyright and license

Licensed and distributed under the BSD 3-Clause License (An OSI Approved License).

Copyright (c) 2021 Snowplow Analytics Ltd, 2010 Anthon Pang.

All rights reserved.