Skip to main content

Data management - events and properties

Last updated 10/03/2026

User behavior data can be created in the system as three basic types of data assets, Events, Event Properties, and User Properties, and used by the analysis features in the system.

Events record key player behaviors, such as registration events, login events, and payment events. Each time a player pays, the system records 1 "Payment Event". In analysis, you only need to count the "trigger count" of the "Payment Event" to get the total number of payments over a period of time.

Event properties record information related to an event each time the event is recorded. For example, when the "Login Event" is recorded, the "Province", "City", and "Device Model" of the login are also recorded. When the "Payment Event" is recorded, the "Item ID", "Item Price", and "Device Model" of the purchase are also recorded. In analysis, you only need to calculate the Sum of "Revenue" in the "Payment Event" to get the total revenue over a period of time.

User properties record the basic information of each player, such as registration time, source channel, last login time, and cumulative revenue. In analysis, you only need to use Composition Analysis and group by "Source Channel" to view the source channel distribution of all current players.

Note that user properties usually record only the earliest or latest information of a player, such as first login time (earliest information) and cumulative revenue (latest information). If you want to view a player's cumulative revenue at the Nth payment, you can't get it from the "Cum. Revenue" user property. A common solution is to report the "Cum. Revenue" value at that moment as an "event property" when you report "User Payment".

The events, event properties, and user properties that each project needs to collect for analysis are confirmed by business and R&D members in the tracking plan. This ensures that later analysis scenarios can select the corresponding events, filter and group data by event properties and user properties, and then sort and calculate statistics on the filtered and grouped event and user data.

1. Query events and properties​

In data management, you can query created data assets such as events, event properties, and user properties (some preset events and properties can't be viewed).

The event types are described as follows:

Event typeDescription
Tracked eventsEvents used for analysis, generated from business data.
Custom eventsEvents that users generate from configured rules in data management.

The property types are described as follows:

Property typeDescription
Tracked propertiesEvent properties and user properties used for analysis.
Custom propertiesEvent properties and user properties that users generate from configured rules in data management.
Dimension table propertiesEvent properties and user properties generated automatically when users add dimension tables to properties in data management.

Click an event name or property name to view:

  • Definition rules of custom events and custom properties
  • Whether events and event properties are associated
  • Structure of the dimension table associated with a property
  • Scope of impact of an event or property
  • Change history of deletions and modifications of an event or property

The following labels appear after the names on the event and property list pages or below the names on the details pages:

LabelWhere it appearsDescription
HiddenEvent/Event property/User propertyThe display status of the event or property is Hidden. Hidden events or properties can't be used in analysis, and tags, cohorts, reports, dashboards, and other assets that use them can't be queried.
InterceptedEventThe event is intercepted in Data > Tracking > Event Counts. After interception, no new data of the event is stored.
Time zoneEvent propertiesThe event property is selected as the time zone offset property in Project Settings > Settings > Time Zone. This means that the property is the time zone of the event time of all events and is the basis for calculating time zone offsets in analysis.

2. Manage events and properties​

In Data > Management, you can:

  • Edit events and properties, and modify information such as display names, descriptions, and data connections;
  • Change whether events or properties are shown or hidden in analysis features;
  • Create custom events and custom properties, and modify and delete custom events and custom properties;
  • Add dimension tables to properties to generate dimension table properties, and modify and delete the dimension tables of properties to modify and delete dimension table properties;

Note: After events and properties are hidden, they can't be used in analysis, and reports, cohorts, tags, and other assets created with them can't be calculated again.

Was this page helpful?