This preview of pull request 1639 is meant for internal use only.

Chameleon Destination

Chameleon quick info

Chameleon accepts Track, Identify, Group, and Alias calls. If you reference it in the Integrations object, call it “Chameleon”.

Chameleon accepts data in cloud-mode from all source types, and can accept data in device-mode from Analytics.js sources.

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.

Identify

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.

Track

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.

Help

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

Personas

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.

Settings

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

API Key

Account Id

This page was last modified: 30 Oct 2020



Get started with Segment

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