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

The Mixpanel integration includes two components:

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

    NOTE: An upgraded integration is coming soon which will enable dynamic syncing of Mixpanel cohorts to Chameleon (to use for targeting Experiences). Read more about how this will work below.

Legacy Mixpanel integration

To start using Mixpanel data with your Chameleon Experiences, 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 Experience 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:

  • Chameleon Started Tour / Survey
  • Chameleon Completed Tour / Survey
  • Chameleon Step Seen -- by request, to avoid flooding you with events. 

Event properties sent as part of these events include the Experience 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 Experiences are performing and driving other actions. You can also construct a list of users that have viewed a certain Experience or exited another Experience etc. 

Mixpanel as a Data Source

Experiences 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 an Experience. 

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 Experiences 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 Experience.

New Mixpanel integration

As with other new Chameleon integrations, you can enable and configure your Mixpanel integration from your Chameleon dashboard:

Click 'Configure' to load the Mixpanel integration page, where you will see two parts of the integration:

  1. Send Chameleon events to Mixpanel
  2. Get Mixpanel cohorts

Sending Chameleon data to Mixpanel

To send events Chameleon automatically collects simply toggle on the first part. This will then send events to Mixpanel directly from your application's client-side. This means that events will go to whichever Mixpanel project is loaded onto that page.

This includes the following events:

  • Chameleon Started Tour / Survey
  • Chameleon Completed Tour / Survey
  • Chameleon Step Seen -- by request, to avoid flooding you with events.

Event properties sent as part of these events include the Experience 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 Experiences are performing and driving other actions. You can also construct a list of users that have viewed a certain Experience or exited another Experience etc.

Getting Mixpanel cohorts into Chameleon

To enable the second part of the integration, you will have to visit your Mixpanel dashboard and go to Integrations:

Here you will be able to add a new integration, where you will receive a prompt to add the API key:

Copy the API key within from the Chameleon Mixpanel integration page and paste it into this window.

(The API key should look something like: SReML19OWgBk2cg8dS2P5SZCXvBPNDNef8KVfyWnJf0NYa-1KnYZs-zEdCvFL4VBJghiAo.)

After this, you will be able to export Cohorts from within Mixpanel to Chameleon as a one-time or dynamic (every 2 hours) sync.

You can leverage this to create groups of users based on your product data within Mixpanel and then target those users with relevant in-product Experiences from Chameleon.

When creating a Target Audience within Chameleon, you will be able to combine membership of a Mixpanel cohort, along with other targeting filters (e.g. whether a user did/did not complete another Tour, or data from other sources, such as Salesforce etc.)

Troubleshooting

We are not currently aware of any common problems experienced as part of this integration. If you have any questions or issues please review how to best get help

Did this answer your question?