kissMyMetrics

KissMyMetrics is a library for kissmetrics.com

This Node.js module isn't associated with Kissmetrics.com

Usage

// create a new KM Client instance:
var Kissmetrics = require('kissmymetrics');
var kmClient = new Kissmetrics({ key: KM_KEY });

// record an event
kmClient.event('blah@example.com', 'signed up');

Why the Fork?

Based on the superjoe30's work, which are already based on glesperance module

So why another fork ?

+ Fully tested
+ Better documentation
+ code coding
+ request not polutated with timestamp
+ PR friendly

Still under MIT license.

Documentation

KISSmetrics REST client constructor.

KissmetricsClient(options)

• options Object The options object defining the REST client to instantiate. Its possible parameters are :

  • key String your KISSmetrics API key.
  • endpoint String (optional) The tracker endpoint to which the client connects to. Defaults to 'https://trk.kissmetrics.com'
  • allowManualTimestamp Boolean (optional) Allow to manually pass timestamp in properties. _t need to be timestamp in seconds after UTC Unix epoch

---

Sets properties on a person without recording an event by making a request.

client.set(person, properties, [callback])

• person String The identity of the person.

This is limited to 255 chars and all commas (,), and colons (:) will automatically be changed to spaces (KISSmetrics will convert foo:bar,baz to foo bar baz).

• properties Object An object containing the properties to be set on person.

• callback Function (optional) A function of the form function(err). The default callback logs erroneous requests to stderr.

---

Aliases the user identified by person with aliases.

client.alias(person, aliases, [callback])

• person String The identity of the person.

This is limited to 255 chars and all commas (,), and colons (:) will automatically be changed to spaces (KISSmetrics will convert foo:bar,baz to foo bar baz).

• alias | aliases String | Array The alias to apply to the person.

This is limited to 255 chars and all commas (,), and colons (:) will automatically be changed to spaces (KISSmetrics will convert foo:bar,baz to foo bar baz).

Can either be a String or an array of String if multiple alias are supplied.

• callback Function (optional) A function of the form function(err). The default callback logs erroneous requests to stderr.

---

Records event for person. Also sets properties` on the person if specified.

client.event(person, event, properties, [callback])

• person String The identity of the person.

This is limited to 255 chars and all commas (,), and colons (:) will automatically be changed to spaces (KISSmetrics will convert foo:bar,baz to foo bar baz).

• event String The name of the event you want to record.

This is limited to 255 chars and all commas (,), and colons (:) will automatically be changed to spaces (KISSmetrics will convert foo:bar,baz to foo bar baz).

• properties Object (optional) An object containing the properties to be set on person.

• callback Function (optional) A function of the form function(err). The default callback logs erroneous requests to stderr.

---

Performs the given request on the KISSmetrics tracker host.

client.request(pathname, params, [callback])

• pathname String The path section of the URL, that comes after the host and before the query, including the initial slash if present.

• params Object

• callback Function (optional) A function of the form function(err). The default callback logs erroneous requests to stderr.