hs

heap-server

[Deprecated] Heap Analytics server-side events helper

Showing:

Popularity

Downloads/wk

6

GitHub Stars

9

Maintenance

Last Commit

6yrs ago

Contributors

1

Package

Dependencies

2

Size (min+gzip)

190.2KB

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Heap server-side events Build Status

Heap Analytics server-side events helper

Getting Started

Install the module with: npm install heap-server

More info on the Heap documentation site

Methods

The Heap server side API currently has two internal methods:

  • track
  • identify

When you send along an event property with the heap.push() method you will be using the internal track method. If you are not sending an event along you're using the internal identify method.

Example: tracking a custom event

var heap = require('heap-server')('--your-heap-app-id--');

heap.push({
  identity: "john@doe.org",
  event: "Custom event name that shows up in Heap Analytics",
  properties: { // extra event properties are optional
    "foo" : "bar"
  }
}, function(err, foo){
  if(err){
    return;
  }
  console.log(foo);
});

// or no callback

heap.push({
  identity: "john@doe.org",
  event: "Custom event name that shows up in Heap Analytics",
  properties: {
    "foo" : "bar"
  }
});

Example: identifying a new or existing user

You can also use this to update properties for an existing user.

var heap = require('heap-server')('--your-heap-app-id--');

heap.push({
  identity: 'john@doe.orgfoobar',
  properties: {
    'foo': 'bar',
    'random': 'bogus'
  }
},
function(err, result){
    if(err){
      return;
    }
    console.log(result);
});


// or no callback

heap.push({
  identity: 'john@doe.orgfoobar',
  properties: {
    'foo': 'bar',
    'random': 'bogus'
  }
});

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100