Stealth Mixpanel
This gem provides out-of-the-box tracking of state transitions inside of Stealth via the Mixpanel service. You are free to track additional events as needed, and we may add more baseline events in the future.
Setup
Once you have your Mixpanel Project Token, set the MIXPANEL_PROJECT_TOKEN
environment variable. That's the only setup required!
Events Tracked
Here are the events that are tracked automatically:
-
State Change
: these are sent to Mixpanel each time a state transition takes place. The user'srecipient_id
is sent to Mixpanel as thedistinct_id
. Additional properties forflow
andstate
are also sent with the event. Please note that when anupdate_session_to
is called, the user's session is updated immediately and therefore an event is also sent to Mixpanel.
Tracking Custom Events
If you'd like to track custom events or store user profiles, you can use the following:
tracker = Stealth::Mixpanel.new
# Track events
tracker.track(current_session_id, 'event-to-track')
# Store/update user profiles
tracker.people.set(current_session_id, { offer_code: '1234-2', happy: 'yes' })
For more information about tracking custom events or user profiles, please check out the mixpanel-ruby gem. The tracker
instance above is just a Mixpanel::Tracker
object.