Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
The Player Custom Properties feature is in public preview. While the core functionality is in place, we’re refining the experience based on feedback and usage patterns.
Custom Properties are key-value data pairs that store additional information about players. These data pairs type can be string, numeric, boolean, or datetime.
Custom Properties and their values are stored with other player information, such as their display name, statistics, and tags.
Note
Custom properties are only supported on title_player_account entities.
Configuring Custom Properties
Custom Properties can be set up in different ways:
- Through the UpdatePlayerCustomProperties action, which updates the player’s properties.
- You can also remove custom properties using the DeletePlayerCustomProperties action.
- And you can also modify a single player’s properties via the Game Manager UI.
Limits
Some limitations on the Custom Properties are:
- Property names must be of type string and have a maximum length of 36 characters
- Property names are case sensitive, so for example prop and PROP are different names
- String values have a maximum length of 36 characters
- The supported numeric values are double floating point (IEEE 754 standard)
- Datetime string values must use the ISO 8601 format and all comparisons are done with respect to UTC
- There can be only 5 unique custom properties per player (It isn't required that each player has the exact same 5 property names)
Benefits
Custom properties are powerful, they enable you to do codeless development that correlates multiple existing PlayStream events, which enable you to track state across events related to the same player.