User Stats for Data Platform 2013

User Stats are developer-defined data points that are calculated by the Xbox Data Platform and stored as name-value pairs on a per user basis. Some examples of user stats include:

• Total number of zombies killed with a shotgun in hard difficulty
• Fastest time for completing level 3
• Highest score achieved in a multiplayer match
• Name of the car driven most recently. User Stats are calculated in the Xbox Data Platform service based on events logged by the title and statistics rules defined by the developer via the XDP Service Configuration Tool. The figure below shows the relationship between events and user statistics.

Figure 1. Events and user statistics.

Every event has an event name and a set of fields. Stat rules are triggered when an event of a particular name is received by the Data Platform service. Statistics rules produce stat instances.

About stat templates and stat instances

Individual statistics rules can be configured to produce either:

• a single stat instance, or
• multiple stat instances based on a stat template.

A stat instance name refers to a particular name-value pair, for example:

• EnemiesDefeated
• HighScoreMP
• CurrentCarName

A stat template is produced by a statistics rule that includes one or more event fields as part of its name, so it can produce multiple stat instances, for example:

• Stat template: BestTime.LevelId
• Stat Instance: BestTime.LevelId.3
• Stat Instance: BestTime.LevelId.55
• Stat template: EnemiesDefeated.EnemyTypeId.WeaponId.DifficultyLevelId
• Stat Instance: EnemiesDefeated.EnemyTypeId.6.WeaponId.17.DifficultyLevelId.4
• Stat Instance: EnemiesDefeated.EnemyTypeId.9.WeaponId.33.DifficultyLevelId.1