With Chameleon's Heap integration, you can better analyze Chameleon tours alongside your other product data using the reporting available in Heap. To learn about Heap visit our integration page

This integration enables Heap to be a Data Destination -- you can send Chameleon data to Heap. Chameleon events are treated as first-class events within Heap:

We are also in *beta* for Heap as a Data Source -- see below and email us if you'd like access.

Setup

The Heap integration can be enabled with a single click. Simply visit the Integrations section within the Chameleon Editor, select Heap and then hit: "Connect to Heap". 

This will automatically begin sending data to your Heap account. This works by using the existing Heap code on your website, and so data will only be sent on pages where the Heap script is present and working.

Usage

Chameleon will automatically send tour performance data, for each user, and you can view this within your Heap account.

This data being sent 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 Heap, use our schema Google Sheet:

You can use these events to define funnels and see this reporting within Heap:

You can also set up custom names for key events by editing the Event Criteria, and leveraging these custom (virtual) events in your analysis. 

This can help you monitor and improve your tour performance. 

Heap webhooks (beta)

Heap recently released a webhooks feature, which enables you to get data out of Heap in real-time. To get access to this functionality please contact your account manager at Heap or email support@heapanalytics.com.

With this functionality, you can now send events from Heap to Chameleon, to help define your target audience for a product tour!

Heap event 'View Demo Page 1' being sent to Chameleon.

Configuration:

To add properties to your user profiles

  1. POST  to https://observe.trychameleon.com/profiles
  2. X-Account-Token as a header with the token copied from the code installation page
  3. Send a uid key in the body that matches user identifier sent in the JavaScript snippet via chmln.identify (typically the Identity)
  4. Add data / content as properties in the request body

To track Events for a user profile

  1. POST  to https://observe.trychameleon.com/events
  2. X-Account-Token  as a header with the token copied from the code installation page
  3. Send a uid key in the body that matches user identifier sent in the JavaScript snippet via chmln.identify (typically the Identity)
  4. Send a name key as the event name
  5. Send an at  key that specifies the time the event occurred in the system (or the $now  to use the current time)

Did this answer your question?