> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 用户统计信息场景

> 基于事件的统计信息的常见 XBOX Live 用户统计信息场景，包括布尔标志、累计计数器、个人最佳和最新值。

<a id="top" />

本主题涵盖使用基于事件的统计信息时创建用户统计信息的以下常见场景。

* [使用布尔值表示条件](#ubvfc)

* [使用计数器表示累计值](#ucfcv)

* [跟踪个人最佳](#tapb)

* [跟踪最近的值](#ttmr)

<a id="ubvfc" />

## 使用布尔值表示条件

### 目标：跟踪是否满足特定条件

当您想要标记用户是否已在游戏逻辑中满足特定条件时，请使用此模式。

### 用例

* 标记用户的角色是否在特定关卡中死亡

* 标记用户是否已解锁每个特定的可收集物品

* 标记用户当前是否在硬核难度下游戏

* 标记用户是否已满足所有五个条件以解锁复杂成就

### 示例：标记用户是否使用霰弹枪击杀了 90 人或使用狙击枪击杀了 10 人

| 字段       | 值                              |
| -------- | ------------------------------ |
| 事件名称     | `AchievementUnlocked`          |
| 事件字段     | `UnlockId`（数据类型：Int32）         |
| 统计信息模板名称 | `AchievementUnlocked.UnlockId` |
| 运算符      | `REPLACE`                      |
| 参数       | 1                              |
| 访问       | `Open`                         |

### 规则

如果标志必须被读取为 `TRUE`，则应用带有字面值 "1" 的 `REPLACE` 运算符。

如果标志必须等于或大于 1 以触发游戏逻辑，则应用带有字面值 "1" 的 `SUM` 运算符。

### 注意事项

如有必要，为 `REPLACE` 布尔统计信息初始化或重置值。否则，将保留最近设置的值。

在某些情况下，定义一个允许将布尔统计信息重置为 `FALSE` 的事件很方便。在这些情况下，请使用带有字面值 "0" 的 `REPLACE` 操作。

[返回本主题顶部。](#top)

<a id="ucfcv" />

## 使用计数器表示累计值

### 目标：为用户在特定指标上递增（或递减）累计值

当您希望每次处理事件时以固定或可变的量递增统计信息值时，请使用此模式。

### 用例

* 玩家等级

* 总击杀数

* 上传的视频数量

* 用户在每张地图上游玩的次数

* 每种车辆类型的累计行驶距离

* 库存中的当前物品数量

### 示例：多人比赛获胜次数计数器

| 字段       | 值                              |
| -------- | ------------------------------ |
| 事件名称     | `MatchCompleted`               |
| 事件字段 1   | `Result`（数据类型：Int32）           |
| 事件字段 2   | `Mode`（数据类型：Unicode 字符串）       |
| 统计信息模板名称 | `MatchesCompleted.Result.Mode` |
| 运算符      | `SUM`                          |
| 参数       | 1                              |
| 访问       | `Open`                         |

### 规则

将 `SUM` 运算符应用于相应的事件字段，或将固定常量值指定为参数。

要递减统计信息的值，请使用负值作为参数，可以作为固定常量或作为事件字段中的运行时值。

### 注意事项

不要将字符串数据类型的"字面"值用作 `SUM` 运算符的参数。

不要将 `SUM` 运算符应用于字符串数据类型的事件字段。

如果您有多个事件正在更新同一统计信息，请确保更新该统计信息的所有统计信息规则都使用同一运算符。

[返回本主题顶部。](#top)

<a id="tapb" />

## 跟踪个人最佳

### 目标：跟踪用户在特定指标上历史"最佳"分数

当您希望持久保留用户的最大 (`MAX`) 或最小 (`MIN`) 记录时，请使用此模式。丢弃任何未改进用户记录的值。

### 用例

* 最长连杀

* 多人回合中最少的死亡次数

* 完成每个赛道的最快时间

* 任何高尔夫球场上每个球洞的最长击球距离

### 示例：完成欧洲赛道集中任何赛道的最快时间

| 字段       | 值                                  |
| -------- | ---------------------------------- |
| 事件名称     | `TrackCompleted`                   |
| 事件字段 1   | `TrackSet`（数据类型：Unicode 字符串）       |
| 事件字段 2   | `TimeInSeconds`（数据类型：Int32）        |
| 统计信息模板名称 | `BestFinishTimeInSeconds.TrackSet` |
| 运算符      | `MIN`                              |
| 参数       | `TimeInSeconds`                    |
| 访问       | `Open`                             |

### 规则

将 `MAX` 或 `MIN` 运算符应用于相应的事件字段。

### 注意事项

不要将"字面"值用作 `MAX` 或 `MIN` 运算符的参数。

不要将 `MAX` 或 `MIN` 运算符应用于字符串数据类型的事件字段。

如果您有多个事件正在更新同一统计信息，请确保更新该统计信息的所有统计信息规则都使用同一运算符。

[返回本主题顶部。](#top)

<a id="ttmr" />

## 跟踪最近的值

### 目标：跟踪用户在特定指标上发布的最新分数

当您希望持久保留用户的最新记录，无论该值是否改进用户的最佳记录时，请使用此模式。

### 用例

* 当前难度

* 当前多人回合中的死亡次数

* 每个赛道最近一次比赛中的最高速度

* 当前装备的高级高尔夫俱乐部的布尔标志

### 示例：任何赛道上最近完成的时间

| 字段       | 值                                 |
| -------- | --------------------------------- |
| 事件名称     | `TrackCompleted`                  |
| 事件字段 1   | `TrackId`（数据类型：Int32）             |
| 事件字段 2   | `TimeInSeconds`（数据类型：Int32）       |
| 统计信息模板名称 | `BestFinishTimeInSeconds.TrackId` |
| 运算符      | `REPLACE`                         |
| 参数       | `TimeInSeconds`                   |
| 访问       | `Open`                            |

### 规则

将 `REPLACE` 运算符应用于相应的事件字段或字面值。

### 注意事项

如有必要，为 `REPLACE` 统计信息初始化或重置值。否则，将保留最近设置的值。

[返回本主题顶部。](#top)


## Related topics

- [基于事件的统计信息和排行榜门户配置](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [在合作伙伴中心中配置 XBOX 统计信息和统计规则](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stats.md)
- [配置](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [获取基于事件的统计信息](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)
- [事件概述](/zh-CN/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-game-events.md)
