With Chameleon's Mixpanel integration, you can more deeply analyze and target Chameleon tours. To learn about Mixpanel visit our integration page

The Mixpanel integration includes two components:

  • Data Destination -- send Chameleon data to Mixpanel (for analyzing tours)
  • Data Source -- get Mixpanel data (custom events) into Chameleon (for targeting tours)


To start using Mixpanel data with your Chameleon tours, simply visit the Integrations section within the Chameleon Editor. You'll also need some information from your Mixpanel account.   

To connect to Mixpanel you'll need the following:

For sections 2. and 3. your Mixpanel Token and API Secret. These are found in two places: 

  1. Within the Project settings, in the Management tab
  2. Within the Account settings, in the Projects tab

For more detailed guidance on how to find these, check out this Mixpanel article. Doing so will enable you to use Mixpanel as a Data Destination. 

To enable Mixpanel as a Data Source, you must also specify which custom events to pull into Chameleon.

In section 4. simply add names of your custom events (one per line) and in section 5. set the period within which these custom events must have occurred for Chameleon to mark a user as having completing them.

For example, if you add the custom event, "Important customers completed upgrade" and set the period to "60" days, then all users who complete that event within the last 60 days will be considered to have completed that event. Those users who might have completed the event more than 60 days ago will not be considered to have completed it. 


Mixpanel as a Data Destination

Chameleon will automatically send tour performance data, for each user, to Mixpanel. You can use this data as part of any Mixpanel chart, report or funnel. 

This includes the following events:

  • Started Tour (Chameleon)
  • Completed Tour (Chameleon)
  • Exited Tour (Chameleon)
  • Step Seen (Chameleon) -- by request, to avoid flooding you with events. 
  • Previewed Tour (Chameleon) -- for admins only

Event properties sent as part of these events include the Tour name, URL and others (e.g. Step number) where relevant. 

For full details of all Chameleon data sent to Mixpanel, use our schema Google Sheet:

You can combine these events along with other events from your product to construct a holistic picture of how your tours are performing and driving other actions. You can also construct a list of users that have viewed a certain tour or exited another tour etc. 

Mixpanel as a Data Source

Tours are most effective when they are highly targeted and personalized. You can now use your analytics data within Mixpanel to define the conditions that specify when a group of users should see a tour. 

To do this, first define a custom event within Mixpanel. You can use a combination of events and their properties and user attributes to create a specific group of users that fall within these conditions. 

Once you do this, you can use this to target Chameleon tours to that group of users. After you complete the Setup then you will see your list of Mixpanel custom events in your filter options when creating a user segment. 

Here is an example of a custom event within Mixpanel:

After saving this event within the Setup view, I will see it within the Mixpanel filter when creating a Chameleon segment:

Applying this filter will mean that only users who have completed this event (as per Mixpanel data) within the last 60 days (as set in Setup above) will be part of this Chameleon segment, and thus see the related tour.


We are not currently aware of any common problems experienced as part of this integration, so please message us if you have any issues, or ideas for improvements. Simply use the green chat circle on the bottom right of this screen. ↘️

Did this answer your question?