> ## 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 Game Manager Manage Events 页面中配置每个事件的采样百分比，以控制 PlayStream 和自定义遥测事件的引入量。

若要利用 Manage Events 页面使用采样，请在单个事件级别配置采样百分比。当你在特定事件上指定采样百分比时，采样通过覆盖默认或现有值生效，并一直保持生效直到你更改它。采样比率字段中指定的百分比是将被筛选掉的事件百分比。

采样率最高可达 100%，最低可达 0%。默认情况下，所有事件的采样率为 100%，因此在采样集中保留 100% 的事件。

<Note>
  采样在 PlayStream 规则引擎处理所有事件后才发挥作用。因此，所有事件都将支持操作/规则（如果指定），并且独立于采样。
</Note>

### 为事件配置采样

你可以从 Game Manager 门户为 PlayStream 和自定义事件配置采样比率。为此，

* 为事件添加采样率
* 导航到你的 **Title**
* 从左侧菜单中选择 **Data**
* 从左侧菜单中选择 **Manage Events**
* 若要为特定事件添加采样率，请确定它是 PlayStream 事件还是遥测事件。基于此，
  * 从 **Add Sample Rate** 窗格的下拉列表中选择 **Event Namespace**
  * 然后，从下拉列表中选择 **Event Name**
    * Event Name 下拉列表包含适用于事件采样且尚未有任何采样配置的事件的完整列表
* 输入一个介于 0% 到 100% 之间的整数作为所需的 **Sample Rate**
* 选择 **Save**，事件采样已配置
  * 配置的事件出现在一个称为 **Sampled Events** 的新窗格中，正好位于 **Add Sample Rate** 窗格上方
    * Sampled Events 概览窗格显示所有已配置的 **Event Name**，并按 **Event Namespace** 分类，**Category** 说明它是标准 PlayStream 事件还是自定义事件，以及配置的 **Sample Rate**

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/export-data/configure-sampling-for-events.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=14db5453de430f386a7920092f6235bf" alt="配置事件采样的屏幕截图" width="1899" height="933" data-path="images/playfab/data-analytics/export-data/configure-sampling-for-events.png" />

<Note>
  采样最长需要 4 小时才能生效，并在每个事件级别处理配置。
</Note>

### 管理事件的采样率

概览（登陆）页面显示采样事件窗格。你可以通过**选择 Sample Rate 框并根据需要进行修改**来**管理事件**。将鼠标悬停在任何事件上时会出现修改选项。若要保留更改，请选择 **save** 按钮，若要还原更改，请选择 **cancel** 按钮。

若要**移除**任何采样事件的采样，请修改 Sample Rate 框，输入 100%，然后选择保留按钮。

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/export-data/modify-event-sampling.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=dc21c1f24e6a82a232e97ecf384db706" alt="修改事件采样的屏幕截图" width="1920" height="929" data-path="images/playfab/data-analytics/export-data/modify-event-sampling.png" />


## Related topics

- [PlayFab 数据与分析文档](/zh-CN/services/playfab/data-analytics/index.md)
- [事件分区快速入门（预览）](/zh-CN/services/playfab/data-analytics/export-data/event-partitioning-quickstart.md)
- [Photon 快速入门](/zh-CN/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [架构快速入门](/zh-CN/services/playfab/data-analytics/acting-data/schemas-quickstart.md)
- [报告快速入门](/zh-CN/services/playfab/data-analytics/learn-data/reports/quickstart.md)