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.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 join 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.gif

When you open Lexicon, you see three views:

  1. Events
  2. Custom Events
  3. User Properties

The GIF below shows each Lexicon view and its filters.

LexiconUI-1102.gif

 

Events and Custom Events

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

Custom events let you to combine events and properties into one event that you can use in Mixpanel reports.

This table contains descriptions and examples for each field in the “Events” and “Custom Events” views. 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."

Volume (30 Days)

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

42,138 

Event-View-Static.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” tab of Lexicon.

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

Field

Description

Example

Name

The database name
of
the property.

$email 

Display name

The event name that
displays in the
Mixpanel interface.

Email

Description

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

“The user's email address. You must set this property if you want to send users email from Mixpanel People.”

Example Value

An expected value
of 
the property.

xyz@myabc.com

Users with
property

The total number
of
users with this
property.

2,000,876 

userProperties-view-static.png

Filtering Events, Custom Events, and User Properties

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

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 Tags: One or more tags, or select All Tags to filter by the entire list of tags.
  • All Status: Live Events, Hidden Events, or select All Status to filter the entire status list.

All Types: Your Events, Autotracked Events, Default Mixpanel Events, or select All Types to filter the entire events list.

filterBy-events.gif

Filter Custom Events

In the "Custom Events" view, you can filter by tabs. 

custom-events-tags.gif

 

Filter User Properties

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

user-properties-types.gif

Adding or Changing Descriptions

Lexicon lets you add or change descriptions for:

Events and Custom Events

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

    event-custom-events.gif
  4. In “Property Details”, you can 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 

 

Prop-Details.png

User Properties

  1. Select the User Properties tab.
  2. Click a user property to display Property Details.
  3. See Step 4 in Custom and Custom Events for a description of each field.

Display Name, Description, or Example Values

To quickly change display names or descriptions for events and custom events, hover over each field and enter the information.

game-played.gif

You can also add or change the display name, description, and example value for user properties when you hover over the property or event field.

user-properties.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 Selector” box appears.
  2. Click Tag to display the “Tag Selector” box.
  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 event, select one or more tags in the “Tag Selector” box, add or remove tags, and then click Save.

tag-demo2.gif

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.

tags-insights.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.

app-purchase.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.