With Chameleon, you can leverage your user data to target and personalize your Experiences. This is powerful because you want to ensure you're delivering relevant, contextual guidance to your users.

Using CSV imports, you can get the right user data in Chameleon to leverage across all product Experiences.

🔐 Available for all plans

📍 Data ready to use in Tours Tooltips Microsurveys Launchers

⚙️ Ready to use from the Dashboard

📺 Check out the video below to see how to use CSV imports in Chameleon.

Chameleon Experiences are most relevant when they are contextual. Segmentation plays a big part in that and having the right user data at hand is critical to building effective audiences.

There are multiple ways to send user data to Chameleon dynamically. However, if these methods don't work for you, Chameleon lets you import a CSV file with a list of users from the Dashboard to leverage in your segmentation immediately. You can also import a CSV file from our Data Imports API.

Leverage CSV imports to:

If you want to update existing users in Chameleon, use their email while mapping out your CSV fields; if you want to create new users & update existing ones, leverage their UID in the mapping step.

There are several scenarios when you might not be able to immediately import all the user data you need to build in-product Experiences by using our existing methods for dynamically importing user data.

Here are some of the most common reasons we see:

Your Marketing team had a one-time campaign that they ran for a list of users who responded to an outbound email, and they kept track of those responses in a spreadsheet.

You want to target a follow-up Tour to those users, so you:

You can use CSV imports to add new users to Chameleon or update existing properties. For both tagging and updating data, you'll set off from the same Imports page, under Data Management.

Before jumping into the process, it's important you know the key difference between the type of data you can import and update with CSVs.

Chameleon handles both user-level and group-level data. Using CSV Imports, you can update and use either, by sending us the corresponding User or Company data. In both CSV-specific actions, you'll be able to choose if you want to perform the tagging or update action at a user level, or a company (group) level.

You'll simply need your spreadsheet to contain a column corresponding to the data identifier for either Users or Companies in Chameleon.

Let's go through the steps you should take to leverage this feature immediately. 😉

This is a great way to keep your different user groups and joined team efforts under control. You can tag users (based on their uid), as well as companies - bigger user groups - (based on the company id). This will add new filter options available for you to identify the right users when creating your Segments.

Click the "Start tagging" button to pick between the user and company id that you would like to use as a base for tagging.

🔻 Picking users will require you to upload your CSV file in the next step. After this, you'll have to tell Chameleon how to identify the users that you want to tag: via their existing uid, or email.

Choose an option, and from the dropdown pick the attribute that matches the uid / email, such as their name, email, UI, or role. The same attributes are available for both options, this depends on how you identify your users.

Once you choose a column from the dropdown, Chameleon will display a preview of the values we see there, to make it as simple as possible to point to the right data.

💡 If you want to add new users to your account,

Click "Continue" to pick an existing Tag or create a new one. As you type in, Chameleon will bring up existing Tags with that name, or if there isn't one created, you can click the "+" icon to create a new one.

Finally, hit "Tag Users" and you're all set! Chameleon will notify you by email once your import is complete - take a breather and check your email, it won't take long. 😊

🔻 Picking companies will require you to do almost the same - upload your CSV file first. Next, you'll tell Chameleon how to identify the users that you want to tag using their company id. And similarly as in the individual Tags case, you can pick from attributes such as name, role, company, or device.

Once you select an attribute, you'll be able to check its accuracy in the preview section and "Continue" to pick an existing Tag created on your account. Or create a new one, with what you type in the field.

Select a Tag and "Tag Users" to start your import. Check your email to see when your import is ready and you can start using these Tags when delivering your Experiences.

You can leverage CSV imports to get essential user attributes into Chameleon and update your existing user properties. You can update user properties (based on their uid), as well as company properties (based on the company id). This will update your available user data and filter options when creating your Segments.

Click the "Start an import" button to pick between the user (individual level) and company (group level) properties that you want to update.

The next steps are similar to those in the case of tagging via CSV imports. But let's go through the flow to see where they differ. 😊

🔻 Picking user properties will require you to upload your CSV file, containing the new attributes in the next step. After this, you'll have to tell Chameleon how to identify the users that you want to update properties for: via their existing uid, or email.

Choose one option, and from the dropdown pick the column that matches the uid / email, such as their name, email, UI, or role. The same attributes are available for both options, this depends on how you identify your users.

Once you choose a column from the dropdown, Chameleon will display a preview of the values we see there, to make it as simple as possible to point to the right attributes.

When you want to update properties, you'll also be prompted to map whatever other columns you want from your CSV to the correct properties in Chameleon.

In the data identifier field, we'll bring up the available data from each column to simplify your life. Then, all you have to do is to select the correct property. For each one, you can search the available properties and use those, or create new ones to match your update by clicking the "+" icon as you type in.

💡 You can leverage "email-only" updates to target multiple users with the same email.

When you're done mapping, click "Import to Chameleon" and wait for a confirmation email. Chameleon will let you know when your import is finalized and ready to use. 😊

🔻 Picking company properties works about the same - first, upload your CSV file, then choose which column matches the company id in Chameleon. From the dropdown list pick whether this is the name, ID, company, or email.

Next, just as in the case of updating user properties, you'll be prompted to map other columns that you may want from your CSV to the correct properties in Chameleon.

Search for available properties to update, or add new ones to match your action by clicking the "+" icon as you type in the data identifier field.

When you're done mapping, click "Import to Chameleon" and feel free to stretch out a bit. You will get a confirmation email once Chameleon has all your data in. 😊

👉 You can also leverage additional Actions to Tag users or update user properties, from Chameleon buttons.

Once an import is ready, whether it is a tag or an update type, your data will be available for you to use from the Segments page when creating a new one or adjusting existing Segments.

You will find properties and events under their respective categories, as well as Tags and you can leverage them immediately.

💡 Learn more about working with user Tags in Chameleon.

Here are two scenarios where CSV imports will come in handy. 😉

Grouping users is a must to ease complex segmentation processes. You can leverage CSV imports to group users under a common Tag that you can then use as a filter when creating your Segment.

💡 Alternatively, you can also do this via our API.

👉 This is a great option to delineate the Experiences you deliver but comes with a caveat - it is a static list and will not update automatically.

User properties are essential to ensure you will always deliver a personalized Experience. You can update user properties with CSV imports and leverage any data available to create unique user guidance.

💡 You can also update user data by using Additional Actions - for users who interact with your Experiences.