@cuppilekkia/event-tracker v1.0.2

Event Tracker

@cuppilekkia/event-tracker - JS Event Tracking

Code coverage

Collect and send data to an API endpoint, uses the SendBeacon method if available in the browser, otherwise classic POST request.

This package is built using webpack 4.

Getting started

Download

Via npm

Make sure to have in your root folder the .npmrc file with the settings to access the private NPM registry.

$ npm install @cuppilekkia/event-tracker --save

Usage

ES6 modules

import { Tracker } from '@cuppilekkia/event-tracker';

CommonJS

const Tracker = require('@cuppilekkia/event-tracker');

Initialization

window.trackerClient = new Tracker({
  api: '[API PATH i.e. "/data" ]',
  host: '[API HOST i.e. "https://mydatacollector.com"]',
});

File include WIP

Link tracker.js in your HTML :

<script src="tracker.js"></script>
<script>
  var trackerClient = new tracker.Tracker({ 
    api: '[API PATH i.e. "/data" ]', 
    host: '[API HOST i.e. "https://mydatacollector.com"]' 
  });
</script>

Send data

Send any kind of object as payload, containing all the data you want to send.

var payload = {
  key1: value,
  key2: {...},
  ...
}
trackerClient.push(payload);

DEVELOPMENT

add here development notes this package uses semantic release so please follow the sintax like:

TODO

• build a demo page with additionally a test node server
• find a way to test cookie creation
• fix coverage building and job to move into public