> ## 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.

# 統計資料計量

> 了解 PlayFab 統計資料可計費計量的運作方式、它們測量哪些讀取和寫入，以及統計資料用量如何成為帳單上的費用。

統計資料計量分為三個類別。

## 統計資料讀取

無論是否排名，讀取實體上的統計資料都會讓統計資料讀取計量遞增一次。無論是為實體要求一個或多個統計資料，都會遞增此計量。

以下是會讓此計量遞增的 API 清單：

| API 名稱 | API 參考 |
| - | - |
| GetStatistics | [取得統計資料](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics) |
| GetStatisticsForEntities | [取得實體的統計資料](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics-for-entities) |

## 統計資料寫入

無論是否排名，更新實體上的統計資料都會讓統計資料寫入計量遞增一次。無論是為實體更新 1 個或多個 (批次) 統計資料，都會遞增此計量。

在排行榜上排名時，統計資料寫入會讓排行榜寫入計量遞增 (除了統計資料寫入計量之外)。遞增的次數取決於要求中排名統計資料的數目。其中 N 是要求中統計資料定義的數目 (可能是一個)，M 是該集合中排名統計資料的數目，則排行榜寫入計量會遞增 M 次。

對於社群統計資料，對來源統計資料的寫入也會讓一或多個目的地遞增。遞增的次數取決於來源統計資料上彙總目的地的數目。一般而言，它是 1 + N，其中 N 是目的地的數目。例如，如果玩家上的統計資料只彙總至遊戲層級的一個統計資料，則玩家上的每次更新都會讓統計資料寫入計量遞增兩次，一次針對玩家，另一次針對遊戲層級的彙總。

以下是會讓此計量遞增的 API 清單：

| API 名稱 | API 參考 |
| - | - |
| UpdateStatistics | [更新統計資料](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## 交易式寫入

交易式寫入計量是統計資料寫入計量的不同變體，它在相同的條件下運作，但增加了將要求作為交易處理的功能，確保每個要求只執行一次。

此計量僅限於此 API，且需要用戶端交易識別碼的特殊參數。當您提供此參數時，就會啟用交易式寫入計量。

| API 名稱 | API 參考 |
| - | - |
| UpdateStatistics | [更新統計資料](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## 統計資料儲存體

此計量追蹤服務中儲存了多少統計資料。

對於每個實體統計資料，統計資料每個版本所耗用的儲存體計算為下列元素的總和：

* 分數：分數清單的長度乘以 `sizeof(long)`。
* 中繼資料：欄位的長度。
* 時間戳記：`sizeof(long)`。
* 實體識別碼的長度。

## 另請參閱

* [排行榜計量](/zh-TW/services/playfab/pricing/meters/leaderboard-meters)。


## Related topics

- [統計資料 API 參考](/zh-TW/services/playfab/player-progression/statistics/api-reference.md)
- [社群統計資料](/zh-TW/services/playfab/player-progression/statistics/community-statistics.md)
- [統計資料配額](/zh-TW/services/playfab/player-progression/statistics/quota-statistics.md)
- [統計資料的限制](/zh-TW/services/playfab/player-progression/statistics/limits-statistics.md)
- [統計資料快速入門](/zh-TW/services/playfab/player-progression/statistics/quickstart-statistics.md)