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

  • Send Chameleon events to Amplitude -- for analyzing Experiences
  • Get Amplitude cohorts -- for targeting Experiences

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

Click 'Configure' to load the Amplitude integration page:

Sending Chameleon events to Amplitude

To send automatically-collected Chameleon events to your Amplitude project, simply turn on the 'Send Chameleon data to Amplitude' toggle.

This will then send events to Amplitude directly from your application's client-side.

To enable this to work, Amplitude's client-side Javascript SDK must be installed within your web app. This SDK must be available at the root property of window.amplitude. Events will then go to whichever Amplitude project is loaded onto the page where the event took place.

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

Getting Amplitude cohorts into Chameleon

Behavioral Cohorts in Amplitude allow you to create groups of users based on the data within your Amplitude account. Learn more about these here.

To enable this part of the integration, you will have to first connect the relevant Amplitude project, and then select which cohorts to sync.

Click 'Connect Amplitude' in the 'Connect Amplitude to sync cohorts' to open the connection modal:

Here you will need to enter the API Key and Secret Key, found within the Settings > Projects section in your Amplitude account:

After you enter these keys and click 'Connect' then your account will be connected and you can begin syncing cohorts.

To do that, search for the cohort names and select all the cohorts you need to keep synced. Once you've added these, hit 'Save'.

These cohorts will then be available to you within your Amplitude cohort filters when creating or editing a Target Audience in Chameleon.

Note: these cohorts sync dynamically daily. This means they can be effective for targeting personas but not for triggering Experiences in real-time. If you would like to show Experiences immediately after a user takes an action then send that data to Chameleon directly.


Legacy integration

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)

Setup

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

Usage

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.

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?