Collecting data with Trackers and Webhooks

  1. Home
  2. Docs
  3. Collecting data with Trackers and Webhooks
  4. Trackers – collecting data from your own applications
  5. JavaScript Trackers (Web and Node.js)
  6. Node.js Tracker
  7. Node.js Tracker v3
  8. Initialization


Assuming you have completed the Node.js Tracker Setup for your project, you are now ready to initialize the Tracker.

Require the Node.js Tracker module into your code like so:

var snowplow = require('@snowplow/node-tracker'); var gotEmitter = snowplow.gotEmitter; var tracker = snowplow.tracker;
Code language: JavaScript (javascript)

or, if using ES Modules, you can import the module like so:

import { tracker, gotEmitter } from 'snowplow-tracker';
Code language: JavaScript (javascript)

Configure Emitter

First, initialize an emitter instance. The Snowplow Node.js Tracker is bundled with an emitter based on the got library. This emitter will be responsible for how and when events are sent to Snowplow.

got only works on Node.js applications and does not have browser support, if the got library isn’t suitable for your project you can create your own emitter as described below. If you want to track users in the browser, you should use the @snowplow/browser-tracker package.

A simple set up of this emitter might look like:

const e = gotEmitter( '', // Collector endpoint snowplow.HttpProtocol.HTTPS, // Optionally specify a method - http is the default 8080, // Optionally specify a port snowplow.HttpMethod.POST, // Method - defaults to GET 5 // Only send events once n are buffered. Defaults to 1 for GET requests and 10 for POST requests. );
Code language: JavaScript (javascript)

There are a number of additional parameters that the gotEmitter allows to be configured which are passed to the underlying got library which this emitter is built on.

The full set of gotEmitter parameters can be found in our API Documentation. A complete example might look like:

const e = snowplow.gotEmitter( '', // Endpoint snowplow.HttpProtocol.HTTP, // Protocol 8080, // Port snowplow.HttpMethod.POST, // Method 1, // Buffer Size 5, // Retries cookieJar, // cookieJar from tough-cookie library function (error, response) { // Callback called for each request if (error) { console.log(error, 'Request error'); } else { console.log('Event Sent'); } }, { http: new http.Agent({ maxSockets: 6 }), https: new https.Agent({ maxSockets: 6 }) } // Node.js agentOptions object to tune performance
Code language: JavaScript (javascript)

Configuring Tracker

Initialise a tracker instance like this:

const t = tracker([e], 'myTracker', 'myApp', false);
Code language: JavaScript (javascript)

The tracker function takes four parameters:

  • An array of emitters to which the tracker will hand Snowplow events
  • An optional tracker namespace which will be attached to all events which the tracker fires, allowing you to identify their origin
  • The appId, or application ID
  • encodeBase64, which determines whether unstructured events and custom contexts will be base 64 encoded (by default they are).

Create your own Emitter

The gotEmitter is built against a standard Emitter interface which means if got isn’t suitable for your project then you can create your own Emitter.

As an example where this might be useful, as got only works in Node.js applications if you wanted to track on a browser based application and you have already considered the @snowplow/browser-tracker package, then you can build your own Emitter – two libraries which might be appropriate are ky (built by the same team as got) or axios.

Emitters must conform to an Emitter interface, which looks like:

interface Emitter { flush: () => void; input: (payload: PayloadDictionary) => void; }
Code language: CSS (css)

You can see the implementation of the gotEmitter here.

Once your emitter has been initialised you can inject it into the tracker just as you would do with the gotEmitter. We are also open to PR’s which contain additional emitters.

If you’d like to learn more about Snowplow Insights you can book a demo with our team, or if you’d prefer, you can try Snowplow technology for yourself quickly and easily.