Freshpaint integration: user guide

Learn how to set up and use Chameleon's Freshpaint integration

Tiago Mota avatar
Written by Tiago Mota
Updated over a week ago

With Chameleon's Freshpaint integration, you can easily sync data between Chameleon and all of your other Freshpaint-connected tools. You can learn more about Freshpaint by visiting our integration page.

The Freshpaint integration includes three components:

  • Installation -- add the Chameleon code snippet to your pages via Freshpaint.

  • Data Destination -- send Chameleon data to Freshpaint (and all other connected tools)

  • Data Source -- get Freshpaint data (e.g. user and company attributes and events) into Chameleon (for targeting Experiences)


Quick access


You can choose to integrate Chameleon with Freshpaint as soon as you're implementing Chameleon, or later, at any moment of your Chameleon journey.

Regardless of the moment, the setup process is similar and very simple. In case you're looking to configure Freshpaint both as a Data Source and a Destination, you'll just have to go through three steps:

  • Adding Chameleon as a destination in Freshpaint.

  • Enabling Chameleon data to be sent to Freshpaint.

  • Configuring Autotracking from the Freshpaint dashboard.

To enable Freshpaint to send data to Chameleon, you'll have to configure Chameleon as a destination in Freshpaint. To do this, you'll have to Add a new destination from your Freshpaint Dashboard and search the catalog for Chameleon.

Select Chameleon from the list, copy the unique token available on the Dashboard's Freshpaint integration page and paste it into the API Key field in Freshpaint.

Go to Sources in your Freshpaint dashboard and click to configure the "Autotrack" (or "Precision Tracking") component. Copy the JS snippet and paste it into the <head> of your website. This way, Freshpaint will know how to receive events passed from your Chameleon account.

Once you're ready to start sending data from Freshpaint to Chameleon, simply enable the destination by turning the Status toggle on.


Note: You can also use Transformations to modify the data Freshpaint sends to destinations, to have complete control over your data by blocking certain events and properties from reaching the Chameleon Destination.


From the Freshpaint Integration page on the Chameleon Dashboard, you can also configure Freshpaint as a data destination.

Once this option is active, Chameleon event data will automatically be sent to your Freshpaint workspace every time Freshpaint is detected on the page where the event takes place.


Note: We discourage using only this method, as the full potential of integrating Freshpaint will not be explored.


Once you have enabled Freshpaint, you do not actively need to manage or sync data. Everything will be updated in real-time.

Once you've enabled Chameleon via Freshpaint, you'll have the power of leveraging any of your Freshpaint data for targeting Chameleon Experiences and tracking conversion events.

You will see this data appear automatically when creating an audience Segment from the Dashboard within the list of available filters, under Imported properties and Imported events.

Below are some of the events that will be sent by Chameleon to Freshpaint and then onwards to any other tools you have connected as destinations within Freshpaint:

  • Chameleon Started Tour / Microsurvey

  • Chameleon Completed Tour / Microsurvey

  • Chameleon Step Seen -- by request, to avoid flooding you with events.

  • Chameleon Launcher opened

  • Chameleon Button clicks Tour/Microsuervey

  • Chameleon Tooltip Seen

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

For full details of all Chameleon data sent to Freshpaint, use our schema below:

You will be able to see these events appear within your Freshpaint dashboard, in both the Live view and the Schema view.


Know more...

Did this answer your question?