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

The Amplitude integration includes two components:

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


To start using Amplitude data with your Chameleon Experiences, 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 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 / Survey (Chameleon)
  • Completed Tour / Survey (Chameleon)
  • Step Seen (Chameleon) -- 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 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 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. 

Note: Amplitude's client-side Javascript SDK must be installed within your app for Chameleon Events to be sent to Amplitude. This SDK must be available at the root property of window.amplitude .

Amplitude as a Data Source

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

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


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?