With Chameleon's Heap integration, you can better analyze and target Chameleon Experiences. To learn about Heap visit our integration page.

The Heap integration includes two components:

  • Data Destination -- send Chameleon data to Heap (for analyzing Experiences)
  • Data Source -- get Heap data (events and webhooks) into Chameleon (for targeting Experiences)

Heap as a data destination

With this aspect of the integration, you can send all Chameleon events to Heap. This data being sent includes the following events:

  • Chameleon Started Tour / Survey
  • Chameleon Completed Tour / Survey
  • Chameleon Step Seen -- by request, to avoid flooding you with events.

Chameleon events are treated as first-class events within Heap:

For full details of all Chameleon data sent to Heap, use our schema Google Sheet:

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 Experience performance data, for each user, and you can view this within your Heap account.

Event properties sent as part of these events include the Experience name, URL and others (e.g. Step number) where relevant. 

ou 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 Experience performance. 

Heap as a data source

You can now use Heap events and other data to target Chameleon Experiences. There are two ways to get data from Heap into Chameleon:

1. Heap events

You can also forward tracked events in Heap to Chameleon. To do this, create a “snapshot” on any defined event in Heap and use that snapshot to trigger a “track event” action in Chameleon.

Step 1: Define an event in Heap and add a new snapshot property on the event from the events view.

Step 2: Set the property value to chmln.track(“event name”); where event name can be replaced with any event name you want to show up in Chameleon for this event.

Step 3: Test performing that event on your site and see if the event appears within Chameleon. You can view all your events within Chameleon in your dashboard here.

2. Heap webhooks

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.

If you have access then you will find the location to configure webhooks under the Integrations list in Heap:

To add properties to your user profiles:

  1. In ‘Basic Configuration’, add the following URL to trigger the POST request to https://observe.trychameleon.com/profiles
  2. Add a ‘Header’ called X-Account-Token. The token will be the same as the one contained within your unique Chameleon code snippet, which you can find in your Chameleon dashboard here.
  3. In the ‘Data to Send’ use uid as the first field (key). Choose the dropdown to be property and choose identity from the dropdown field.
    Note: please make sure you are sending the same uid to both Heap and Chameleon as part of your installation identify calls.
  4. Add any other data fields to send to Chameleon.
  5. In ‘Triggering Events’ choose the Heap event that will trigger this webhook to run
  6. Name and save your webhook. Fire the triggering event in your product and check to see the data was received in Chameleon. You can view all your user data within Chameleon in your dashboard here.

To send events for a user:

  1. In ‘Basic Configuration’, add the following URL to trigger the POST  to https://observe.trychameleon.com/events
  2. Add a ‘Header’ called X-Account-Token. The token will be the same as the one contained within your unique Chameleon code snippet, which you can find in your Chameleon dashboard here.
  3. In the ‘Data to Send’ use uid as the first field (key). Choose the dropdown to be property and choose identity from the dropdown field.
    Note: please make sure you are sending the same uid to both Heap and Chameleon as part of your installation identify calls.
  4. Add the name of the event. Under ‘Data to Send’ add an additional field titled name. Select the type as ‘constant’ and add the text for the name of this event. You will use this to search and select this event in the Chameleon interface.
  5. Add the time of the event. Under ‘Data to Send’ add an additional field titled at. Select the type as ‘constant’ and add $now as the value. You can also specify this differently as per your system of keeping time or the time you want to set the event to have occurred.
  6. In ‘Triggering Events’ choose the Heap event that will trigger this webhook to run
  7. Name and save your webhook. Fire the triggering event in your product and check to see the data was received in Chameleon. You can view all your user data within Chameleon in your dashboard here.

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

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

Did this answer your question?