> ## 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 使用者統計資料案例，包括 Boolean 旗標、累計計數器、個人最佳紀錄與最近值。
本主題涵蓋使用事件型統計資料時，建立使用者統計資料的下列常見案例。
* [針對條件使用 Boolean 值](#ubvfc)
* [針對累計值使用計數器](#ucfcv)
* [追蹤個人最佳紀錄](#tapb)
* [追蹤最近一次的值](#ttmr)
## 針對條件使用 Boolean 值
### 目標：追蹤是否已符合特定條件
當您想要在遊戲邏輯中標示使用者是否已符合特定條件時，請使用此模式。
### 使用案例
* 標示使用者的角色是否曾在特定關卡中死亡
* 標示使用者是否已解除鎖定每個特定收集品
* 標示使用者目前是否正在以硬派難度進行遊戲
* 標示使用者是否已符合解除鎖定複雜成就的全部五個條件
### 範例：標示使用者是否使用霰彈槍擊殺 90 次，或使用狙擊槍擊殺 10 次
| 欄位 | 值 |
| - | - |
| 事件名稱 | `AchievementUnlocked` |
| 事件欄位 | `UnlockId` (資料類型：Int32) |
| 統計資料範本名稱 | `AchievementUnlocked.UnlockId` |
| 運算子 | `REPLACE` |
| 參數 | 1 |
| 存取 | `Open` |
### 規則
如果旗標必須讀取為 `TRUE`，請套用常值為 "1" 的 `REPLACE` 運算子。
如果旗標必須等於或大於 1 才能觸發遊戲邏輯，請套用常值為 "1" 的 `SUM` 運算子。
### 注意事項
必要時，請初始化或重設 `REPLACE` Boolean 統計資料的值。否則，系統會保存最近一次設定的值。
在某些情況下，定義一個可將 Boolean 統計資料重設為 `FALSE` 的事件會很方便。在這些情況下，請使用常值為 "0" 的 `REPLACE` 運算。
[返回本主題頂端。](#top)
## 針對累計值使用計數器
### 目標：遞增 (或遞減) 使用者在特定指標上的歷來累計值
當您想要在每次處理事件時，將統計資料值遞增固定或可變的數量時，請使用此模式。
### 使用案例
* 玩家等級
* 總擊殺數
* 上傳的影片數量
* 使用者在每張地圖上進行遊戲的次數
* 駕駛每種車輛類型的累計距離
* 目前物品欄中的物品數量
### 範例：贏得多人比賽的計數器
| 欄位 | 值 |
| - | - |
| 事件名稱 | `MatchCompleted` |
| 事件欄位 1 | `Result` (資料類型：Int32) |
| 事件欄位 2 | `Mode` (資料類型：Unicode 字串) |
| 統計資料範本名稱 | `MatchesCompleted.Result.Mode` |
| 運算子 | `SUM` |
| 參數 | 1 |
| 存取 | `Open` |
### 規則
對對應的事件欄位套用 `SUM` 運算子，或指定固定的常數值作為參數。
若要遞減統計資料的值，請使用負值作為參數，可以是固定常數，也可以是事件欄位中的執行階段值。
### 注意事項
請勿將字串資料類型的「常值」作為 `SUM` 運算子的參數。
請勿對字串資料類型的事件欄位套用 `SUM` 運算子。
如果您有多個事件更新同一個統計資料，請確保更新該統計資料的所有統計資料規則都使用相同的運算子。
[返回本主題頂端。](#top)
## 追蹤個人最佳紀錄
### 目標：追蹤使用者在特定指標上的歷來「最佳」分數
當您想要保存使用者的最大 (`MAX`) 或最小 (`MIN`) 紀錄時，請使用此模式。捨棄任何無法改善使用者紀錄的值。
### 使用案例
* 最長連續擊殺
* 單回合多人遊戲中最少的死亡次數
* 完成每條賽道的最快時間
* 任何高爾夫球場每一洞的最遠開球距離
### 範例：完成歐洲賽道組中任何賽道的最快時間
| 欄位 | 值 |
| - | - |
| 事件名稱 | `TrackCompleted` |
| 事件欄位 1 | `TrackSet` (資料類型：Unicode 字串) |
| 事件欄位 2 | `TimeInSeconds` (資料類型：Int32) |
| 統計資料範本名稱 | `BestFinishTimeInSeconds.TrackSet` |
| 運算子 | `MIN` |
| 參數 | `TimeInSeconds` |
| 存取 | `Open` |
### 規則
對對應的事件欄位套用 `MAX` 或 `MIN` 運算子。
### 注意事項
請勿將「常值」作為 `MAX` 或 `MIN` 運算子的參數。
請勿對字串資料類型的事件欄位套用 `MAX` 或 `MIN` 運算子。
如果您有多個事件更新同一個統計資料，請確保更新該統計資料的所有統計資料規則都使用相同的運算子。
[返回本主題頂端。](#top)
## 追蹤最近一次的值
### 目標：追蹤使用者在特定指標上最近一次提交的分數
當您想要保存使用者的最新紀錄 (無論該值是否改善使用者的最佳紀錄) 時，請使用此模式。
### 使用案例
* 目前難度
* 目前多人遊戲回合中的死亡次數
* 每條賽道最近一次比賽中的最高速度
* 目前是否裝備進階高爾夫球桿的 Boolean 旗標
### 範例：任何賽道上最近一次的完成時間
| 欄位 | 值 |
| - | - |
| 事件名稱 | `TrackCompleted` |
| 事件欄位 1 | `TrackId` (資料類型：Int32) |
| 事件欄位 2 | `TimeInSeconds` (資料類型：Int32) |
| 統計資料範本名稱 | `BestFinishTimeInSeconds.TrackId` |
| 運算子 | `REPLACE` |
| 參數 | `TimeInSeconds` |
| 存取 | `Open` |
### 規則
對對應的事件欄位或常值套用 `REPLACE` 運算子。
### 注意事項
必要時，請初始化或重設 `REPLACE` 統計資料的值。否則，系統會保存最近一次設定的值。
[返回本主題頂端。](#top)
## Related topics
- [事件型統計資料與排行榜入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [事件型統計資料的入口網站設定](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [重設使用者統計資料](/zh-TW/services/playfab/api-references/rest/admin/player-data-management/reset-user-statistics.md)
- [取得事件型統計資料](/zh-TW/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-getting-eb-stat.md)