Node.js SDK

The Node.js SDK makes it easy to track events from Node.js applications.

Installation

The Node.js SDK is available via NPM.

To install the Node.js SDK, run:

npm install @ht-sdks/events-sdk-js-node

Initialize the SDK exactly once and export it:

import { HtEvents } from "@ht-sdks/events-sdk-js-node";

// initialize once
export const htevents = new HtEvents({ 
  writeKey: "HT_WRITE_KEY",
  host: "https://us-east-1.hightouch-events.com",
});

Then, import it into the rest of your app, as needed:

// import your already initialized instance into the rest of your app
import { htevents } from "./events";

// example usage in an express like framework
app.post('/login', (req, res) => {
   htevents.identify({
      userId: req.body.userId,
      previousId: req.body.previousId
  })
  res.sendStatus(200)
})

The HtEvents constructor accepts the following parameters:

API

Identify

The identify method sends an identify event.

Unlike the Browser SDK, it does not persist the user ID and traits locally, so user IDs must be explicitly added to other events. This is because server side events are usually servicing many different users at once.

Example usage:

htevents.identify({
  userId: "123",
  traits: {
    location: "San Francisco",
  }
})

The first argument to the method is an object representing the identify event to be sent. The second argument is an optional callback that's invoked after the event is sent.

htevents.identify(message, [callback])

The message object may include the following fields:

Track

The track method sends a track event.

Example usage:

htevents.track({
  userId: "123",
  event: "Order completed",
  properties: {
    total: 29.99,
  }
})

The first argument to the method is an object representing the track event to be sent. The second argument is an optional callback that's invoked after the event is sent.

htevents.track(message, [callback])

The message object may include the following fields:

Page

The page method sends a page event.

Example usage:

htevents.page({
  userId: "123",
  category: "Docs",
  name: "Getting started",
})

The first argument to the method is an object representing the page event to be sent. The second argument is an optional callback that's invoked after the event is sent.

htevents.page(message, [callback])

The message object may include the following fields:

Screen

The screen method sends a screen event.

Example usage:

htevents.screen({
  userId: "123",
  category: "Docs",
  name: "Getting started",
})

The first argument to the method is an object representing the screen event to be sent. The second argument is an optional callback that's invoked after the event is sent.

htevents.screen(message, [callback])

The message object may include the following fields:

Group

The group method sends a group event.

Example usage:

htevents.group({
  userId: "123",
  groupId: "456",
  traits: {
    company_location: "San Francisco",
  },
})

The first argument to the method is an object representing the group event to be sent. The second argument is an optional callback that's invoked after the event is sent.

htevents.group(message, [callback])

The message object may include the following fields: