Chameleon Destination

Destination Info
Connection Modes
Device-mode Cloud-mode
Web Web
Mobile Mobile
Server Server

Our Chameleon destination code is open-source on GitHub if you want to check it out.

Getting started

When you enable the Segment direct destination on the Chameleon dashboard we will immediately start receiving your app’s user and event data collected by Segment.

You may need to enable your website domain on the Chameleon Domains Dashboard to see User events and properties on Chameleon.


This helps you target product tours to specific (segments of) users. You can read more about how to segmentations work in Chameleon’s docs

At a minimum we suggest sending us:

  • email
  • name

We recommend sending us properties that you would like to use to segment users into a handful of groups. Some examples of the properties you may wish to use to segment users include:

  • account role (admin vs user)
  • account value (paid vs free)
  • account status (converted vs retained)

Examples of other specific properties you may also wish to send us include:

  • credit (# of dollars in account)
  • respoitory_count (# of authorized items)
  • support_requests_count (# of touchpoints generated)
  • chats_count (# of times user reached out for help)

When we know more about your user, we can help you target them more effectively. For example, you could show different tutorials to the account admin and other team members.


You can send us your app’s events for two main reasons:

  1. Signal a conversion from a product tour (a user successfully completing the action that they were prompted to take with the tour)
  2. Trigger a specific product tour (coming soon)

Product tours should lead to user actions and so offer the option of tagging each Chameleon product tour with a ‘conversion event’ that helps you track how successful your tour is. We collect data about each tour (users starting, completing, conversions) and send this back to your preferred analytics provider. Read more about the analytics Chameleon tracks.


For more information, refer to Chameleon’s docs or email them.


You can send computed traits and audiences generated using Segment Personas to this destination as a user property. To learn more about Personas, contact us for a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Personas sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Personas sets that value to false.

When you first create an audience, Personas sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

Supported Sources and Connection Modes

Before you start, make sure Chameleon supports the source type and connection mode you’ve chosen to implement. You can learn more about connection modes here.

Web Mobile Server
📱 Device-mode ⬜️ ⬜️
☁️ Cloud-mode ⬜️ ⬜️ ⬜️

Segment offers an optional Device-based Connection Mode for Mobile data going to Chameleon, so that you can use Chameleon features that collect data directly from the mobile device. To do this, you must package the Segment-Chameleon mobile SDK with the Segment mobile library.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
Account Id string.

This page was last modified: 02 Nov 2021

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account