Skip to main content

Manage your data in Chameleon

See, rename, and archive events and properties being sent to Chameleon

Chameleon Team avatar
Written by Chameleon Team
Updated this week

The Data Management page is your data configuration center. Here you can review all the properties and events you're sending to Chameleon, rename them, add descriptions, adjust data formats, create Custom Events, and archive anything that's no longer relevant.

Any data you send to Chameleon will appear here and be ready to use in segmentation on the Users page.

πŸ‘‰ Read about understanding data in Chameleon for a full overview of the data types available to you.


Data Management page

All the data you send to Chameleon is available on the Data Management page in your Dashboard.

Here, you switch tabs between the different types of data and can:

  • Review what data you're sending to Chameleon

  • See the source of your properties, such as an integration or our API

  • Rename and add descriptions to your properties and events (to help team members leverage data easily)

  • Create Custom Events based on event properties

  • Archive events or properties that aren't relevant (this will hide them within any lists when creating a target audience or setting a goal)

πŸ‘‰ Read more about managing user Tags or Experience Tags.

ℹ️ New Events are available in real-time for triggering Experiences, but may take up to 1 minute to be available in segmentation.

Setting user and company display identifiers

At the top of the User Properties and Company Properties tabs, Admins can choose how to identify and display users or companies throughout the Dashboard.

Want to view users by their first_name and UID? Select these properties from the two dropdown fields.

ℹ️ The properties you select here will dictate how you see users displayed in Dashboard slideovers. If you select two properties, the slideovers will display the preview version. If you have only one field selected, the slideovers will display that. If you have no fields selected, the slideovers will show the UID.


Data formats

You will notice different data formats in the user data tables. Understanding these is important because the data format determines which operators are available when you use a property to target users.

Format

Description

Available operators

number

A whole number or a positive/negative number with a decimal point

equals, greater than, less than, etc.

string

A collection of alphanumeric characters between double quotes

contains, does not contain, equals, etc.

timestamp

The current time of an event that is recorded

before date, after date, etc.

boolean

Two possible values: true and false

is true, is false

πŸ’‘ If the data you are sending is classified as the incorrect type β€” such as "Number String" but only requires one β€” you can adjust this on the Data Management page and update the data format to the correct type.

Nested objects and arrays

Chameleon supports up to 2 levels of nesting for Objects and Arrays of any length. Arrays may contain any value types except the Array and Object types.

Type

Description

Format

Object

A set of values inserted between {} (curly braces). Keys must be strings and should be unique; multiple value pairs are separated by , (comma)

{ key: value, key: value }

Array

An ordered collection of values that begins with [ (left bracket) and ends with ] (right bracket). Values are separated by , (comma)

[value, value, value]

Here's an example user profile object with a nested object containing an array:

javascript

chmln.identify(UID, {
metadata: {
role: {
id: '5a17',
name: 'owner',
display_names: ['Owner', 'Admin'],
}
},
roles: ['owner', 'contributor', 'analyst', 'billing']
})

Limits and Errors

The value for each user property and each Array member is limited to 768 bytes. Any data received that exceeds this limit will be truncated at the 768th byte and you'll see a warning on the Data Management page for user data or company data.


Managing User and Company Properties

On the User Properties and Company Properties tabs, the table contains all the properties you've ever sent to Chameleon.

You can apply different filters to help you find and review properties:

  • Names

  • Descriptions

  • Data format

  • Source

  • Last seen / first seen time

You can edit the name and description of any property by clicking on the pencil icon (or the description directly in the table). Here, you can also choose to archive properties that are no longer relevant and this will hide them from your Dashboard.

🀝 Keep a clear naming convention so anyone on the team can leverage your data efficiently.


User Events

On the third tab, User Events you can review all events sent to Chameleon, edit or "Track/Untrack" Events, as well as create Custom Events. As with user and company properties, you can also update the name and description of each event.

β„Ή Events in Chameleon can be Tracked (Chameleon identifies the event, associated properties, and which users should match the criteria) or Untracked (Chameleon identifies the event and associated properties but does not add it to your users).

πŸ‘‰ Learn more about adding Custom Events

Did this answer your question?