> ## 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            | [Get Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics)                           |
| GetStatisticsForEntities | [Get Statistics For Entities](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/get-statistics-for-entities) |

## 统计写入

无论是否排名，更新实体的统计信息都会导致统计写入计量累加一次。此累加发生在为实体更新 1 项或多项（批量）统计信息时。

在排行榜上排名时，统计写入除了导致统计写入计量累加外，还会导致排行榜写入计量累加。累加次数取决于请求中排名统计信息的数量。设 N 为请求中统计信息定义的数量（可能为 1），M 为其中排名统计信息的数量，则排行榜写入计量累加 M 次。

在社区统计信息中，对源统计信息的写入还会导致一个或多个目标累加。累加次数取决于源统计信息上的聚合目标数量。一般为 1 + N，其中 N 为目标数量。例如，如果玩家的统计信息聚合到标题级别的一项统计信息上，则每次玩家更新都会导致统计写入计量累加两次，一次针对玩家，另一次针对标题级别的聚合。

以下是会累加此计量的 API 列表：

| API 名称           | API 参考                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| UpdateStatistics | [Update Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## 事务写入

事务写入计量是统计写入计量的不同变体，它在相同条件下运行，但增加了将请求作为事务处理的功能，确保每个请求仅执行一次。

此计量仅限于该 API，且需要一个特殊的客户端事务 ID 参数。当你提供此参数时，事务写入计量便会被激活。

| API 名称           | API 参考                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| UpdateStatistics | [Update Statistics](https://learn.microsoft.com/en-us/rest/api/services/playfab/progression/statistics/update-statistics) |

## 统计存储

此计量跟踪服务中存储了多少统计信息数据。

对于每个实体统计信息，每个版本的统计信息所消耗的存储量按以下各项之和计算：

* 分数：分数列表长度乘以 `sizeof(long)`。
* 元数据：字段长度。
* 时间戳：`sizeof(long)`。
* 实体 ID 长度。

## 参见

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


## Related topics

- [PlayFab 统计信息概览](/zh-CN/services/playfab/player-progression/statistics/index.md)
- [季节性统计信息](/zh-CN/services/playfab/player-progression/statistics/seasonal-statistics.md)
- [使用可重置的统计信息和排行榜](/zh-CN/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards.md)
- [使用 PlayStream 和遥测的统计信息](/zh-CN/services/playfab/player-progression/statistics/statistics-with-playstream-and-telemetry.md)
- [事务写入](/zh-CN/services/playfab/player-progression/statistics/transactional-writes.md)