Amplitude integration: user guide

Learn to set up and use Chameleon's Amplitude integration

Pulkit Agrawal avatar
Written by Pulkit Agrawal
Updated this week

With Chameleon's Amplitude integration, you can analyze and target Chameleon Experiences with more precision and depth.

You can ensure you have the right attributes to help you deliver contextual messages, understand how your guidance impacts your users' journey, and find opportunities to guide them better.


Availability & Usage

πŸ” Available for all plans

πŸ“ Ready to power your Tours, Tooltips, Microsurveys, Launchers

βš™οΈ Configure from the Dashboard

πŸ”— Compatible with the EU version


With our Amplitude integration, you can understand how your product guidance impacts users' behaviors and your product's adoption. Analyze how each Experience unblocks or nudges users to their successful next steps and personalize each message to fit specific roles, needs, or individuals.


With this integration, you can set up Amplitude as a:

  • Data destination -- send Chameleon data to Amplitude (for analyzing Experiences)

  • Data source -- get Amplitude cohorts in Chameleon (for targeting Experiences)


Enable the Amplitude integration in a few clicks and leverage your data in no time. Search the integrations page in your Chameleon Dashboard for Amplitude to connect your Amplitude account.

Next, to get your data into Chameleon:

  1. Connect the relevant Amplitude Project

  2. Then select which cohorts to sync

To connect your Project, you will need to enter the API Key and Secret Key from Amplitude. You'll find these in the Settings > Projects section in your Amplitude account:

Copy and paste those into Chameleon on the modal that pops up:

Next, you can begin syncing your cohorts: search for those you want in Chameleon and hit Sync to get your data in.

πŸ‘‰ If you're using Amplitude's European Instance and having issues syncing your data to Chameleon, contact us to update the Integration to fetch data from the EU version.

On the same page, you'll also find the toggle to send out Chameleon data to your Amplitude account. Enable this if you want to analyze your Chameleon data in Amplitude πŸ‘‡

πŸ‘‰ 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.

Once you toggle this, Chameleon events will go to whichever Amplitude project is loaded onto the page where the event took place.


You can leverage this two-way integration to investigate different hypotheses and fill the gaps in how you guide users to success with your product.

By overlapping your product guidance data with the other behaviors, you can better understand your users and deliver a better user experience on all platforms.

Behavioral Cohorts in Amplitude allow you to create groups of users based on the data within your Amplitude account. You can leverage these when targeting Experiences to create a more personalized and relevant user journey.

πŸ’‘ Learn more about these from Amplitude's documentation.

πŸ‘‰ Chameleon only accepts cohorts of users. Syncing a cohort of organizations with Chameleon will return 0 users.

Once synced to Chameleon, your cohorts will be available to you within the 'Amplitude Cohorts' filter when creating your Segment in Chameleon.

πŸ‘‰ Amplitude Cohorts sent to Chameleon are synced every 24 hours, on average. 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.

βš™οΈ This assumes you already enabled the sync in the Dashboard, as a last step of setting up; if you didn't already make sure to do so.

Chameleon will send events to Amplitude directly from your application's client side. This includes (but is not restricted to) the following events:

  • Chameleon Started Tour / Microsurvey

  • Chameleon Completed Tour / Microsurvey

  • Chameleon Step Seen

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 below:

Look at 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'll see Chameleon data show up on the Data page in your Amplitude account to get an overview understanding of how users engage with your Experiences. As well as on your connected Project page.

πŸ’‘ Include your data into different charts to help you understand your users better. For example, you can compare a list of users who have viewed a certain Experience to those who didn't engage with it.

πŸ‘‰ Learn more about Amplitude Charts and explore how you can include Chameleon data in your usual analytics flows. Try out the Pathfinder, Funnel, or Impact analysis chart, all can reveal how your efforts with Chameleon affect other behaviors and your overall product health.


πŸ” Available on Amplitude's Growth & Enterprise plans.

Amplitude has a feature that allows you to receive an email notification when an "Alert" is triggered. This is a powerful way to get real-time notifications when Chameleon Experiences may not be performing as expected.

This Alert can be based on a heuristic anomaly being detected or a custom threshold being met for any event, including Chameleon events sent to Amplitude.

πŸ‘‰ Read more about this in Amplitude's docs here, or see the summary below.

To set up an Alert in Amplitude, first create and save a Chart. This could use the "Chameleon Step Seen" event fired each time a Step is seen. This could also be filtered to a specific Step or Tour (using an event property such as step_id, or tour_name).

Once you have your Chart, you can create an Alert for it. You can pick between a "custom alert" (recommended) or a "smart alert". You'll then get a notification when the quantity of the selected event firing is outside normal ranges.

Did this answer your question?