ember-keen-tracking
v0.0.7
Published
Ember Add-on for tracking events with Keen IO
Downloads
7
Readme
ember-keen-tracking
ember-keen-tracking is an easy way to use Keen IO for event tracking in your ember-cli project. A simple Ember service wraps the keen-js SDK and can be injected anywhere in your application.
To query Keen IO events in ember, see the sister addon: ember-keen-querying
We welcome contributions!
Installation
ember install:addon ember-keen-tracking
ember generate ember-keen-tracking
Setup
A Keen project id and write key is required to track events. You can set these api keys in one of 3 ways:
Set a
KEEN_PROJECT_ID
andKEEN_WRITE_KEY
onENV
inconfig/environment
. The ember-cli-dotenv addon is a safe and easy way to do this.A metatag of the form:
<meta property="keen:project_id" content="[KEEN_PROJECT_ID]" />
Set a global
KEEN_PROJECT_ID
.
Usage
The Ember.Service class is only supported in Ember 1.11+. If your application is on an older version of Ember, you can achieve the same effect of this addon by injecting the service as an Ember object through an initializer.
You can inject and use the service anywhere like so:
import Ember from 'ember';
export default Ember.Route.extend({
keenTracking: Ember.inject.service(),
actions: {
trackGiggle: function() {
var dataObject = {polo: 1, yolo: 2, cholo: 3};
this.get('keenTracking').addEvent('giggle', dataObject).then(function(response) {
console.log(response);
});
}
}
});
You can track multiple events at once with addEvents
. See the dummy app for more info.