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

The Amplitude integration includes two components:

  • Data Destination -- send Chameleon data to Amplitude (for analyzing tours)
  • Data Source -- get Amplitude data (Behavioral Cohorts) into Chameleon (for targeting tours)


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

To connect to Amplitude you'll need your API Key and Secret Key. These are within your Settings view, accessed from the top right of your dashboard:

After opening the Settings view, navigate to the Projects section, and grab your keys from there.

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

To enable Amplitude as a Data Source, you must also specify which Behavioral Cohorts to pull into Chameleon. You can do so in Line 5 of the Amplitude Setup screen within Chameleon, as above. 

Simply add names or IDs of your Behavioral Cohorts (one per line). You can get these from your Amplitude dashboard, within the Behavioral Cohorts section. 

If you do not have access to this feature then you may need to contact Amplitude for access. Learn more about Behavioral Cohorts here


Amplitude as a Data Destination

Chameleon will automatically send tour performance data, for each user, to Amplitude. You can use this data as part of any Amplitude 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 Amplitude, 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. 

Amplitude as a Data Source

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

To do this, first define a Behavioral Cohort within Amplitude. 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 Amplitude Cohorts in your filter options when creating a user segment. 

Here is an example of a setting a filter to target an Amplitude cohort called "New test cohort":

Applying this filter will mean that only users who are included in this cohort will be a 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?