Chameleon automatically collects data on how effective your product tours are, and you can use this to measure iterations and determine which Steps or Tours to improve. 

There are three ways you can review your Tour data outside of Chameleon:

  • Using a CSV or Google Drive export

  • Sending data to an analytics tool we integrate with.

  • Using our API.

The best method will be the one that works for you, and we do recommend that you start analyzing your Tours' performance as soon as possible.

Don't feel like you can't conduct analysis if you don't have an analytics system or tool in place -- you can always start by looking at a spreadsheet.

Using a CSV or Google Drive export

From the Chameleon Dashboard, you can access an individual Tour's analytics page and extract many insights from there.

However, taking your analysis one step further is as simple as exporting a spreadsheet -- either by downloading the .CSV or by sending the data to your Google Drive.

You can do this by clicking the respective button located in the top right corner. Then, a link will be sent to your email address which will either download the .CSV or take you to the spreadsheet in your Google Drive.

It can take a few minutes for this email to arrive in your inbox, depending on how much data it contains.

Analyzing the exported spreadsheet

Each row in the spreadsheet represents a unique action (event) a user has taken in your Tour, within the select time range. These events include:

  • Tour started, when a user sees the first Step of the Tour.

  • Tour exited, when a user dismisses any Step of the Tour (including the last Step).

  • Tour completed, when a user completes the last Step of the Tour.

  • Step seen, when a user sees a Step within the Tour.

  • And others that can be found in the "Events" tab of the Data Schema, such as Button clicked and Dismiss clicked.

Each row also contains user properties/attributes associated with the user that took this action. This includes default user properties collected by Chameleon and custom user properties that you're sending to Chameleon. 

Note: We highly recommend sending user properties to Chameleon to help target your Experiences. Learn more about how to send user data to Chameleon.

Data glossary

Below are the definitions of the columns you will see in your exported data. All data is accurate at the time that the event took place, for the live/activated/published tour: 

Data property



Unique and persistent ID for that Tour. Learn how to expose this.


Name of the Tour.


Total number of steps in the Tour.


Unique and persistent ID for the Step (only for Step seen events).


Sequence number of the Step within the Tour (only for Step seen events).


Type of event (see above).


Time when the event took place.


Time since the beginning of the Tour (for Tour events).

Time the Step was showing (for Step events).

Default user properties =>

Divider indicating what the next set of columns correspond to.


Unique ID for the user that caused the event, as sent by your product. *


Width of the browser, in pixels.


Name of the browser.


Default browser language code.


The timezone for the browser, relative to GMT/UTC. **


Number of web sessions detected by Chameleon for that user. ***

Custom properties =>

Divider indicating what the next set of columns correspond to.


Any user data sent to Chameleon will be shown here

* This should match the ID you use to track users in your database or other analytics tools and sent as part of the Chameleon installation.  

** Pacific Time would be -8.

*** Sessions are separated by 90 minutes of inactivity and the count begins after the Chameleon code snippet is installed.

General notes

  • If a Step has a dismiss option, which is configured to show the Tour again later, it will not generate a Tour exited event. 

  • This export does not contain detailed Step Seen event data (with information on all the Step configuration). However, this data can be sent to your connected integrations. To enable this for your account, please message us

  • Content per cell is limited to 4096 characters (bytes)

  • Content that could be a function/formula in Excel are escaped with a leading single quote (i.e. '=cmdl' /C Notepad'!'A1')

Chameleon collects more data than currently available in the CSV. To review all the data currently collected (and logged to any connected analytics integrations) please review our data schema.

How can I use the exported data?

You can use the exported data to conduct a range of analysis, to answer questions such as:

  • Which Step are users exiting the Tour the most?

  • Which specific uses have seen a particular Step?

  • Which specific users have completed or dismissed the Tour?

  • Tour success by user property (such as language or a custom property).

  • How long it took a particular user to complete a Step.

To do this, we recommend creating a Pivot table from all the data and then selecting the most relevant data to plot and compare.

Pivot tables

Pivot tables allow you to more easily group, filter, and chart a large table of data. In the pivot table, you can decide which columns from the original data to show on each axis and add further filters. You can create pivot tables in MS Excel or Google Sheets.

To simplify this, we have created a downloadable template you can use as a basis for your analysis -- feel free to make your own copy and start using it!

For example, here are the steps you can use to recreate the funnel chart we show in the Dashboard.

Steps to create a Funnel Chart in Google Sheets

  1. Export data from Chameleon to Sheets

  2. Filter and remove any unwanted data rows

  3. Create a Pivot table

  4. Add the appropriate Pivot table settings

    • Rows - Event UID

      • Order by Descending

      • Sort by COUNTA of Event UID

      • Step seen*

    • Columns - Event

      • Order by Descending

      • Sort by Event

    • Values - Event UID

      • Summarize by COUNTA

      • Show as Default

    • Filters - Event

      • Status “Step seen”

      • * Go back to "Rows" and add the "Step seen" there

  5. Optional, copy and paste Step text to replace Step UIDs

  6. Create bar graph

Learn more

Did this answer your question?