One of the most powerful capabilities of Chameleon is the ability to show in-product Experiences to the most relevant users. Showing relevant and contextual guidance will improve its effectiveness and drive the most engagement.
It's easy to display your Experience to the right audience by defining user Segments with specific filters (conditions) and choosing the right one when configuring your Experience. As users move in and out of your Segments, Chameleon will re-assess if they should see
ℹ As users move in and out of your Audiences, Chameleon will not show any Steps or Experiences to users who are no longer part of the Target Audience. Learn more about the update here.
Availability & Usage
🔐 Available on Startup, Growth, Enterprise
📍 Define who sees your Tours, Tooltips, Embeddables, Microsurveys, Launchers, HelpBar
⚙️ Create from the Dashboard
📺 You can watch the video below or this interactive demo to learn how to target users in Chameleon.
With Chameleon, it's easy to leverage your user data to deliver guidance on every level of your users' journey. You simply have to define specific user groups - Segments - that you use to target your Experiences. You can have the same users falling into different Segments, all with different purposes.
In addition to the data we collect automatically to deliver your Experiences, you can send additional user data and events that you can use to target your Experiences.
When creating an Experience, you can pick to show it to:
a pre-build audience configured by Chameleon
a custom Segment that you define using a variety of filters
ℹ You can also compose your audience by combining different Segments and include or exclude users from specific Segments. For example, you can target users who are in an "Onboarding" Segment but aren't in a "Referral" Segment.
ℹ If you're on the Free plan, you'll have access to the "All users" audience, but you'll need to upgrade to a paid plan to create custom Segments.
What are the pre-built audiences?
Chameleon offers a few basic pre-configured audiences that you can use without sending any custom data to Chameleon (aside from uid, which is required to identify users). These audiences are:
Audience name | Description |
All users | All users who visit the page where the Tour begins and have not seen it before. |
Just me | A dynamic Segment that will only target your user (when testing Experiences). |
Team members | Users whose email address has the same domain as your account (based on the first user who signed up for your account). This audience requires an |
Chrome users | All users who are currently using the Chrome browser. |
Via other Chameleon Experiences only | Shown to users who trigger the Experience from another Chameleon Experience or the API. Available for Tours, Emebddables and Microsurveys. |
ℹ 'Chameleon admins' as a default audience has been replaced by 'Has Chameleon access' under Default properties.
How can I create audience Segments?
To deliver your Experiences to specific users, you can create Segments with defined conditions that are continuously assessed when showing an Experience. You will use a combination of filters (conditions) to narrow down your whole audience to specific users. To achieve this, you will work with data that:
is collected automatically by Chameleon
you send to Chameleon using our APIs
you sent to Chameleon from your connected integrations
To create a new Segment, go to the Segments page in your Dashboard and click the "+" button. Start with a clear name and combine all the filters available to define your audience.
👉 Search through the filters for properties, events (including Custom Events), Experience events, audiences synced from integrations, or user Tags. You'll see the available data that contains your keyword across all available filters.
ℹ You can also add filters directly to your "All users" tab and hit the "Save" button once you're happy with the result. This will create a new Segment for you.
Once you create a Segment, it will be immediately available to select as an audience while configuring your Experiences.
What filters can I use to create a Segment?
Any user data you send to Chameleon (properties or events) will be available as segmentation filters, which you can combine to create your Segments.
You'll find clearly labeled filters for the different data types you can leverage in Chameleon.
The following different groups of filters are available:
Filter group | Description |
Default properties | User properties automatically collected by Chameleon. (e.g. Browser, Language, # of web sessions, etc.) |
User properties | User properties sent to your Chameleon account. |
Company properties | Company properties sent to your Chameleon account. |
User events
| User events sent to your Chameleon account or Custom Events (created from the Chameleon Dashboard). Both types of Events need to be set as "Tracked" to be available to use. |
Chameleon Tags | Custom tags created through our CSV Imports functionality. |
Chameleon Tour events | Tour engagement events automatically collected by Chameleon. (e.g. Tour started, Tour completed, etc.) |
Chameleon Microsurvey events
| Microsurvey engagement events automatically collected by Chameleon (e.g. Microsurvey was answered, etc.) |
Chameleon Launcher events | Launcher engagement events automatically collected by Chameleon (e.g. Launcher was opened, etc.) |
Mixpanel custom events | List of users that have completed a custom event (composite of individual events or user properties) defined within your Mixpanel account. |
Amplitude cohorts | List of users within a behavioral cohort defined within your Amplitude account. |
HubSpot lists | HubSpot lists defined in your account and synchronized with Chameleon. |
Salesforce objects | List of users based on an attribute defined within your Salesforce account. |
Calendly actions | Actions (such as scheduling a call) taken by your users in relation to your Calendly account. |
👉 Learn more about sending user data to Chameleon.
You can review our Data Schema below for the full details on all the data Chameleon collects automatically.
Using AND / OR logic to define Segments
When applying filters to your list of users, you can define your segments using both AND / OR logic. This allows you to combine multiple conditions in the same Segment.
After adding a second filter to your Segment, Chameleon will automatically use AND logic to combine both. This creates a grouped filter that functions based on the AND, OR logic which you can further build up by adding other filters. To change the logic operator between AND and OR, all you have to do is click it.
💡 This functionality is most impactful when you want to filter between different types of user behaviors that link to similar events to drive further action. (e.g. you want to show a Tour to users from 2 event signups).
Creating grouped filters with different logic
Chameleon allows you to combine different filter logic to create grouped filters and further refine your segmentation. This means you can have multiple filter groups that work together to define a single Segment.
By creating a new filter group, you can add additional conditions to define a single Segment, independent from the first group.
To create a grouped filter, press the "Add filter group" button below your existing filters. Add filters just as before and use the logic operator to establish the condition Chameleon should set for your Segment. This way, Chameleon will test the two against each other when assessing users for this Segment.
You can click on the logic operator within the grouped filter to change its logic between AND and OR, just like you do inside a single filter group.
ℹ To create your Segments, you do not need to restrict yourself to using only a couple of filters. Chameleon can work perfectly with three, four, five, or more filters combined into one, as long as it suits your needs.
How do I use Composable Audiences?
When choosing an audience for your Experiences, you can leverage multiple Segments to define who should see it. You can select one (or multiple) Segments as the main target audience and exclude users who are not in other Segments.
Simply select from the dropdown the specific Segments users should be in and the Segments they should not be in. When combining multiple Segments, you can also leverage the AND/OR logic to determine who should see your Experience. This enables you to control more easily how you combine different audiences.
ℹ You can combine as many Segments as you want to define your audience.
Reviewing users in an Audience
Keep up with the user count any time you update your audience and review a list of users you're about to target. The "Audience count" updates in real-time to show you the number of users you are about to target. This count does not include Environments or Tenants restrictions.
Clicking Preview under your Audience count number will open a slideover where you can review your audience in more depth.
Depending on the number of Segments you included in your audience, the slideover will open either on the:
Users tab -- where you can review a list of users in the Segment
Filters tab -- where you can see the applied filters and audience size for each Segment in your audience
When you're using a single Segment in your audience, you can review the users in your Segment and switch to the other tabs in the slideover to see the filters applied to your Segment and a list of Experiences targeted to this audience.
When you have multiple Segments in your audience, the slideovers will open to show the filters applied to each Segment. Click on the Users tab to review all the users in your audience, or add a Tag to these users to create a new audience.
You can access the Audience slideovers in your Dashboard, for Tours, Tooltips, Embeddables, Microsurveys, and Launchers, from:
Experience pages tables in the 'Audience' column -- when the audience is composed of multiple Segments
Individual edit Experience panel -- in the 'Select Audience' panel by clicking Preview.
ℹ In the slideover that opens, you can also click into any user and review their properties as well as any data associated with Chameleon Experiences, such as responses to Microsurveys or Tours they've completed.
How can I manage my Segments?
Once you have different Segments set, click the 'Manage Segments' button to see a list of all Segments created on your account. Here you can review existing audiences and edit or remove them.
💡 Use the table headers to bring up your most active Segments.
Select one, or several Segments and go to the 'Bulk Actions' dropdown to copy, delete, or export the users from an existing Segment.
Can I change the audience of a live Experience?
You can update any Segment in Chameleon and save it as usual without affecting your published Experiences. Any Experiences leveraging that Segment will continue to display to your updated audience and won't require further action from you.
When you make changes to any Segment, can choose to update your active Segment or create a new one if the changes clash with the guidance you're already delivering to this user group.
The Activity feed will show any Segment changes, so you can keep track of these there.
ℹ Once a user starts a Tour or Microsurvey, they are allowed to finish it even if the Segment changes. Practically this means that if you update a Segment, anyone who has already seen the Experience and left the app without dismissing or completing it will still be able to finish the Experience when they return.
Common caveat
Using the "within list" filter operator with too many items
Some data types will allow you to use the "within list" filter operator when defining your segmentation filter.
This can be useful for several scenarios that include highlighting a specific list of data points among a wider sample, like a small list of emails or a list of pricing plans.
To avoid performance issues, keep your lists at 100-500 items.
