corona-mixpanel

API for sending events to Mixpanel on Corona SDK

Installation

Bower

This package and its dependencies can be used as bower modules.

To do that, just follow the instructions on this gist

Manual

Download the latest release from the Releases tab

To have a drop-in replacement for Corona's analytics module, check out corona-analytics-mixpanel

Usage

local mixpanel = require 'vendor.mixpanel.mixpanel'
mixpanel.initMixpanel(MIXPANEL_API)
mixpanel.track( 'clickedAd', {
  ['Banner Color'] = 'Blue'
})

You need to ensure these properties exist in build.settings

android = {
  usesPermissions = {
    "android.permission.INTERNET",
    "android.permission.READ_PHONE_STATE",
    "android.permission.ACCESS_NETWORK_STATE",
  },
}

Super properties

It's very common to have certain properties that you want to include with each event you send. Generally, these are things you know about the user rather than about a specific event—for example, the user's age, gender, or source.

To make things easier, you can register these properties as super properties. If you do, we will automatically include them with all tracked events. Super properties are saved to device storage, and will persist across invocations of your app.

local mixpanel = require 'vendor.mixpanel.mixpanel'
mixpanel.registerSuperProperties({
  ['User Type'] = 'Paid'
})

Going forward, whenever you track an event, super properties will be included as properties. For instance, if you call

local mixpanel = require 'vendor.mixpanel.mixpanel'

mixpanel.track('signup', {
  'signup_button' = 'test12'
})

after making the above call to registerSuperProperties:, it is just like adding the properties directly:

local mixpanel = require 'vendor.mixpanel.mixpanel'

mixpanel.track('signup', {
  'signup_button' = 'test12',
  ['User Type'] = 'Paid',
})

Advanced configuration

You can use an existent offlinequeue instance when initing this module.

To do that just pass a second params argument to initMixpanel

local mixpanel = require 'vendor.mixpanel.mixpanel'
local offlinequeue = require 'vendor.offlinequeue.offlinequeue'

local queue = offlinequeue.newQueue(...)
mixpanel.initMixpanel(MIXPANEL_TOKEN, {queue = queue})

TODO:

• Queue events in JSON
• People API