Using Lexicon (BETA)

Beta version. Functionality is subject to change. 

Lexicon is a data dictionary that stores descriptions of events and their properties.

Project owners and administrators can add and manage descriptions for all events and properties, and organize data for clarity and discoverability.

Event and Property Descriptions

In Lexicon, you can add or change descriptive information about your events and their properties.

Events are actions a user performs in your application or a website.

Event properties are the specific details that describe the action.

In large implementations of Mixpanel with multiple teams and hundreds of events and properties, it can be difficult for other team members to interpret event information.

Using Lexicon, you can better understand your events because you can add or change event information, track who modified it, and verify whether the current information is accurate.

Default Properties

Lexicon contains property definitions for the default properties that Mixpanel’s client-side libraries automatically send with each event across web and mobile platforms.

MP-default-props__1_.png

Organizing and Finding Data

Mixpanel provides tags to help you organize and find your data.

A tag is a label you assign to an event. Tags enable you to categorize events and make them easier to find–especially in large Mixpanel implementations with multiple teams.

Event and property definitions that are clear, accurate, and findable reduce the learning curve and help teams get up to speed faster. This feature is particularly useful when a new member joins the team.

Before new members join your project, you can review your event and property definitions for accuracy and add tags to better organize them.

In this guide

You'll discover the Lexicon user interface and learn you how to:

Exploring Lexicon

This section provides a tour of Lexicon.

To open Lexicon, select Data Management and then select Lexicon.

Lexicon_Navigation.gifWhen you open Lexicon, you see four views:

  1. Events
  2. Custom Events
  3. Event Properties
  4. User Properties

This GIF shows each view and its filters.

four-views-new.gif

Events 

Events are actions a user performs in your application or website.

This table contains descriptions and examples for each field in the “Events” view.

The examples in this table are based on the image below.

Field

Description

Example

Name

The database name of the event.

$campaign_delivery 

Display Name

The event name that displays in the Mixpanel interface.

 "Message Sent" 

Description

The information that
describes the event,
such as what triggers
it or what properties 
are sent with it.

“Triggered every time any Mixpanel message (email, SMS, push, webhook, or in-app) is delivered. Important properties include "Message Type", "Message", and "Variants."

Status

The event is either hidden or live (visible) in the Lexicon.

Live

Volume (30 Days)

The total number of
events that users
fired in 30 days.

41,960 

Events.png

Custom Events

Custom events are events and properties you combine into one event to use in Mixpanel reports.

The fields for custom events are “Name”, “Display Name”, “Description”, and “Volume (30 Days)”.

See the table in Events for descriptions and examples. 

Custom_Events.png

Event Properties

Event properties describe details about events, such as distinct_id or browser.

This table contains descriptions and examples for each field in the “Event Properties” view.

The examples in this table are based on the image below.

Field

Description

Example

Name

The database name of the event.

$import

Display Name

The event name that displays in the Mixpanel interface.

"Import"

Description

The information that describes the event, such as what triggers it or what properties are sent with it.

“This property is set when events are sent into the Import endpoint. "

Example Value

An expected value of the property.

True

Status

The property is either hidden or live (visible) in the Lexicon.

Live

Events With Property

The number of events that contain properties?

38,613,415

event_properties.png

User Properties

User (or people) properties describe details about your users, such as username or email address.

This table contains descriptions and examples for each field in the “User Properties” view.

The examples in this table are based on the image below.

Field

Description

Example

Name

The database name of the property.

$country_code

Display name

The event name that displays in the Mixpanel interface.

Country Code

Description

The information that describes the event, such as what triggers
it or what 
properties are sent with it.

“The two-letter country code of the event sender, parsed from IP.”

Example Value

An expected value of the property.

US, ES (Spain)

Users with
property

The total number
of
users with this
property.

2,969,357

user_properties.png

Filtering Events, Custom Events, Event Properties, and User Properties

Lexicon provides several options for you to filter your events, custom events, event properties, and user properties.

You can also show or hide events and properties to organize and refine your filtering.

These filtering options help you arrive at the most useful data to analyze your performance. 

Filter Events

In the "Events" view, you can filter by:

  • All Status: Select Live Events, Hidden Events, or All Status, which filters the entire status list.
  • All Tags: Select one or more tags, or All Tags, which filters by the entire list of tags.
  • All Types: Select  Your Events Autotracked Events, default Mixpanel Events, or All Types, which filters the entire events list.

 events2.gif

Filter Custom Events 

In the "Custom Events" view, you can filter by one or more, or all tabs.

custom_events.gif

Filter Event Properties

In the "Event Properties" view, you can filter by tabs.

  • All Status: Select  Live Properties, Hidden Properties, or All Status, which filters the entire status list.
  • All Types: Select Your Properties, default Mixpanel Properties, or All Types, which filters the entire events list.

event_properties.gif

Filter User Properties

In the “User Properties” view, you can filter by tags to find properties that you or Mixpanel defines.

USERproperties.gif

Show or Hide Events and Properties

Start up and enterprise users with a paid plan can show or hide events and properties. This capability helps users refine their filtering.

Show Events and Properties

To show hidden events or properties, select Hidden Events or Hidden Properties in the “All Status” dropdown in "Events", "Event Properties", or "User Properties" view.

Then select an event or property and select Unhide as shown in the GIF below.

showHidden.gif

Hide Events and Properties

To hide events or properties, select an event or property in the either "Events", "Event Properties", or "User Properties" view.

Then select the Hide icon.

hideEvents.gif

Adding or Changing Descriptions

Lexicon lets you add or change descriptions for:

Events and Custom Events 

To add or change events or custom events:

  1. Select the Event or Custom Event view.
  2. Click an event.
  3. Click Your Properties or Mixpanel Properties and click a property to display the "Property Details" section.

    combo-events-custom.gif
  4. In “Property Details”, click the Pencil icon at right side of the property to modify each field, except “Name”.

The examples in this table are based on the image below.

Field Description Example
Name The database name
of the event
$import 
Display name The event name that
displays in the 
Mixpanel interface.
Import
Description The information that describes the event, such as what
triggers 
it or what properties are sent with it.
“This property is set when events are sent into the Import endpoint.”
Type The data type of an
property, which can
be a string, boolean,
number, datetime,
list, object, or
unknown.
Boolean
Example Value The expected value
of the property.
 True Event or User Properties 

 

Events and User Properties

To add or change event or user properties:

  1. Select the Event Properties or User Properties view.
  2. Click an event or user property to display "Property Details".
  3. Click the Pencil icon at right side of the property to add or change the information in the "Display Name", "Description", and "Example Value" fields.

Tip: To quickly change display names or descriptions for events and custom events, or change display names, descriptions, and example values for event and user properties, hover over each field and enter the information.

hover.gif

Adding Tags to Events

A tag is a label you assign to an event to help you organize and find it.

You can add tags to one or more events in the “Events” or “Custom Events” view.

Examples_of_tags_in_descriptions.png

To add tags to an event:

  1. In the “Events” or “Custom Events” view, select one or more events. The “Tag” icon appears.
    tag.png
  2. Click Tag to display the “Tag Selector” box.
    TAGselector.png
  3. Add or change tags to one or more events:
  • To add tags, enter the name of one or more tags in the “Tag Selector” box and click Save. As you add tags, they appear in a searchable list in the “Tag Selector” box.
  • To change tags assigned to an event, select one or more tags in the “Tag Selector” box, add or remove tags, and then click Save.

Using Tags in Insights Reports

The Insights report contains a list of tags.

When you select a tag, a list of events that share the same tag appears. You can then select the event you want.

tagInsights.gif

Suppose your mobile gaming application has hundreds of events and you want to find events that are associated with game purchases.

If you’re new to the project, it could be time-consuming to search hundreds of events to find them. Using Lexicon, you can assign a tag to events that relate to a specific category.

For example, we’ll use a purchases tag for all events and properties that relate to purchasing, such as In-App Purchase or Booster Pack Purchased. The purchases tag makes the search much easier because the purchase related events are listed under the purchase tag.

taggedEvents.png

In addition to the previous example, tags are useful to identify specific events of interest for certain teams, distinguish events that are relevant to a specific product or service, or indicate events that are associated with certain key performance indicators.

Is this article helpful?
1 out of 2 found this helpful

Comments

0 comments

Please sign in to leave a comment.