User Properties

What Are User Properties?

User properties are versatile attributes that directly influence the user's profile or game statistics. They can be used to personalize the user experience by affecting various elements such as enhancing specific abilities, or unlocking new features within the system. User properties are a powerful way to make the user journey more engaging and rewarding.

Key Features of User Properties:

  • Customization: They allow businesses to tailor experiences based on individual user behavior and preferences.
  • Versatility: User properties can be applied to a wide range of metrics, from game stats to app usage patterns.
  • Integration: Once created, these properties become part of the user’s profile and can be used to create levels, segments, and redeem options.

Creating User Properties

To create user properties, follow these steps:

  1. Navigate to the Admin Dashboard: Open the Admin Dashboard and go to the User Properties page.
  2. Specify a Name: Choose a descriptive name for the user property.
  3. Select a Data Type: Choose one of the three data types:
    • Number
    • String
    • Boolean

Automation for User Properties

For properties of the number data type, automation rules can be added to further enhance their functionality. Here’s a breakdown of how automation works:

Identifying Key Performance Metrics

To start working with properties, you first need to identify how to measure the performance of your customers. Automations can help measure key performance metrics such as the number of bets a customer makes, the amount of money a user deposits, or the frequency with which a user opens the app.

Identifying an accumulative and valid metric across the user's lifetime is essential.

Creating Automation Rules:

  1. Select the Custom Event: Choose the custom event that will trigger the automation. The requirements for the event depend on its properties.

  2. Create the Modifier Expression: Define the modifier expression for the automation that will change the value of a property. The modifier expression is written in Math.js and should return a single number. You have access to the following variables:

    • aggregatedValue: The current value of the property.
    • event: The event that triggered the automation,including all parameters accessible via . or [] notation for nested properties, similar to how it's done in JavaScript.
    • user: The user that triggered the automation.
    • userProperties: The properties of the user that triggered the automation.

📘

Previously, a single incorrect automation would cause all automations to fail. Now, starting from version 1.1.0, erroneous expressions are ignored. This ensures that only the broken automations are bypassed while the rest continue to function correctly.

Rewards for User Property

You can also create unique rewards specific to individual user properties. Once created, these rewards will be displayed in the rewards list wherever rewards can be given out.