Skip to content

This ember-cli addon injects mixpanel as a service into your ember app.

License

Notifications You must be signed in to change notification settings

sportly/ember-cli-mixpanel-service

Folders and files

NameName
Last commit message
Last commit date

Latest commit

70f5a49 · Jan 2, 2017

History

65 Commits
Apr 2, 2016
Jan 2, 2017
Jul 18, 2015
Jan 1, 2016
Apr 24, 2015
Apr 24, 2015
Apr 24, 2015
Apr 24, 2015
Apr 24, 2015
Apr 24, 2015
Jul 18, 2015
Jul 18, 2015
Jul 18, 2015
Apr 24, 2015
Apr 8, 2016
Aug 28, 2015
Aug 28, 2015
Aug 28, 2015
Apr 8, 2016
Jul 18, 2015

Repository files navigation

ember-cli-mixpanel-service

npm version Ember Observer Score Code Climate

This ember-cli addon injects mixpanel into your ember app.

The mixpanel js is injected into the app's index.html. Pageview tracking is by default automatic, no mixins required. The mixpanel service is injected into your apps controllers and routes and is available as this.get('mixpanel').

More on mixpanel at http://www.mixpanel.com

Installation

ember install ember-cli-mixpanel-service

Configuration

This plugin uses the ember-cli project's configuration as defined in config/environment.js.

Add your Mixpanel API token to config/environment.js and you're good to go. A couple more params below

// environment.js

    ENV.mixpanel = {
      enabled: false,
      LOG_EVENT_TRACKING: false,
      token: 'abcd123456789'
    }

Configuration Parameters

  • enabled (Default: true): Enable mixpanel tracking
  • autoPageviewTracking (Default: true): Enable automatic pageview tracking
  • pageViewAttribute (Default: url): Use some other attribute available to the router instead of url for pageview tracking
  • attributeOverrides (Default: {}): Configure overrides, if any, for any of the attributes mixpanel stores by default
  • LOG_EVENT_TRACKING (Default: false): Output logging to the console.
  • token (Default: null): Mandatory Mixpanel API token

CORS Content Security Policy

If you use ember-cli-content-security-policy you should add the Mixpanel API to your app's content security policy settings. To do this add api.mixpanel.com to the 'connect-src' key in the ENV.contentSecurityPolicy hash as below:

// environment.js
    ENV.contentSecurityPolicy = {
      'connect-src': "'self' api.mixpanel.com ..."
      ...
    }

Mixpanel API

pageviews

trackPageView: function(page, overrides = {})

Note: Pageviews are tracked automatically by default, no mixins required. You can override any properties mixpanel stores by default by providing an optional overrides object.

events

trackEvent: function(event, properties, options, callback)

Alias of the mixpanel track function

identify

identify: function(userId, traits, options, callback)

Alias of the mixpanel identify function

alias

alias: function(userId, previousId, options, callback)

Alias of the mixpanel alias function

register

register: function(traits, options, callback)

Alias of the mixpanel register function

peopleSet

peopleSet: function(attributes)

Alias of the mixpanel people.set function

About

This ember-cli addon injects mixpanel as a service into your ember app.

Resources

License

Stars

Watchers

Forks

Packages

No packages published