> ## 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 统计信息和统计规则

> 在合作伙伴中心中为数据平台 2013 添加和更改统计规则，以便在你的产品向 XBOX 服务发送事件时更新玩家统计信息。

本主题描述在合作伙伴中心服务配置中为产品添加和更改统计规则的过程。玩家统计信息根据当游戏向 XBOX Live 服务发送事件时触发的统计规则创建和更新。

有关 XBOX 服务配置的介绍，请参见[服务配置](/services/xbox-services/fundamentals/portal-config/live-service-config-ids-mp)。有关 Data Platform 2013 的介绍，请参见 XDK 主题**XBOX Live 数据平台 2013 的工作原理**。

<a id="ID4EMB" />

## 什么是统计规则？

当 XBOX 数据平台服务接收到具有特定名称的事件时，会触发统计规则。触发统计规则（通过发送适当的事件）会使服务创建或更新一个或多个玩家统计信息。

玩家统计信息由开发者定义、由 XBOX Live 数据平台计算，并按用户存储为名称-值对。以下是几个玩家统计信息示例。

* 在困难难度下使用霰弹枪击杀的僵尸总数
* 一场比赛中击败的最多敌人数量
* 完成比赛的最快时间
* 最近驾驶的汽车名称

玩家统计信息可以作为特色或 hero 统计信息显示在玩家的游戏中心 UI 上、显示在排行榜中，以及用于解锁成就。

可以将单个统计规则配置为生成以下之一：

* 玩家统计信息的单个实例
* 基于统计模板的玩家统计信息的多个实例

有关统计信息和统计规则的信息，请参见 XDK 文档中的以下主题。

* **数据平台 2013 的用户统计信息**
* **用户统计规则**
* **用户统计信息场景**

下图演示了触发更新统计信息实例的统计规则的事件流。

<img src="https://mintcdn.com/microsoft-4404708b/66WJ_HwgXG1cFJFn/publishing/game-publishing/how-to/data-platform-2013/media/dataplatformtaxonomy-documentation-01-event_to_stat.jpg?fit=max&auto=format&n=66WJ_HwgXG1cFJFn&q=85&s=b981fb7b2e9b8f7e613b91515ffdf747" alt="事件流" width="1280" height="720" data-path="publishing/game-publishing/how-to/data-platform-2013/media/dataplatformtaxonomy-documentation-01-event_to_stat.jpg" />

<a id="ID4ENC" />

## 配置统计规则

<Steps>
  <Step title="使用你的帐户登录 [合作伙伴中心](https://developer.microsoft.com...">
    使用你的帐户登录[合作伙伴中心](https://developer.microsoft.com/dashboard/windows/overview)。
  </Step>

  <Step title="选择你的产品，然后转到 **服务** > **XBOX Live**。">
    选择你的产品，然后转到 **服务** > **XBOX Live**。
  </Step>

  <Step title="选择指向 **统计规则** 的链接。">
    选择指向 **统计规则** 的链接。
  </Step>

  <Step title="在 **事件和统计规则** 页面上，配置事件以及基于这些事件的统计规则...">
    在 **事件和统计规则** 页面上，配置事件以及基于这些事件的统计规则。
  </Step>
</Steps>

由于统计规则基于事件，因此必须先创建事件，然后才能创建统计规则。有关详细信息，请参见[在合作伙伴中心中为数据平台 2013 配置 XBOX Live 事件](/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-events-2013)。

<a id="ID4ELC" />

## 创建统计规则

1. 在 **事件和统计规则** 页面上，选择 **新建统计规则**。
2. 在 **添加统计规则** 对话框中，为以下字段指定值。
   * **基础事件**<br />在下拉列表中，选择触发此统计规则的基础事件。
   * **添加到统计规则的事件字段**
     * 此可选字段可让你选择基础事件中作为统计规则一部分的字段。
     * 在下拉列表中，选择要添加到统计规则的字段。你可以通过这种方式添加多个字段。所选字段将追加到统计规则的根名称，并以点字符分隔。
     * 要删除字段，请选择其名称旁边的 X。
   * **统计规则名称**<br />指定描述统计规则的名称，且你能轻松记住和识别。统计规则的名称由 *root* 名称组成，可选地后跟一个或多个以点字符分隔的 *fields*。有关统计规则名称的命名要求，请参见 XDK 主题**用户统计规则**。
   * **运算符**<br />选择以下运算符之一。
     * **Sum**<br />将现有统计值按 **参数** 字段中指定的值递增。
     * **Min**<br />使用现有统计值和 **参数** 字段值中的最小值。
     * **Max**<br />使用现有统计值和 **参数** 字段值中的最大值。
     * **Replace**<br />使用 **参数** 字段中指定的值替换统计值。不建议对驱动成就的统计信息使用 **Replace** 运算符。事件并不总是按顺序处理，这可能导致成就永远无法解锁。请改用 **SUM** 运算符。
   * **参数**<br />指定在 **运算符** 字段中选择的运算符中要使用的值。
     * 如果要使用你指定的静态数字，请选择 **literal** 选项，然后在该选项下方的框中指定值。
     * 如果要使用字段的值，请选择 **field** 选项，然后在该选项下方的下拉列表中选择要使用的字段。
   * **限制其他功能（例如成就和特色统计信息）访问此信息。**<br />选择此复选框以使统计规则为私有。
   * **仅允许通过服务器事件更改此统计信息。将忽略客户端事件。**<br />选择此复选框以指示统计规则仅由通过服务器到服务器 API 发送的事件触发，而不是从主机或 PC 上运行的游戏客户端触发。
3. 配置所有字段和值后，选择 **保存**，然后关闭对话框。

每当选择规则的事件时，你的新统计规则将列在 **事件和统计规则** 页面上。

<a id="ID4E2C" />

## 更改现有的统计规则

<Warning>
  在产品通过最终认证后，无法再更改或删除该产品中事件的现有统计规则。
</Warning>

1. 在产品实例的 **事件和统计规则** 页面上的 **统计规则** 列中，选择要更改的统计规则。
2. 在事件的 **更新统计规则** 对话框中进行更改。
3. 选择 **保存**。

<a id="ID4ELE" />

## 编辑统计规则

在删除、添加或重新排序统计规则的名称或事件字段时，会进行统计规则的编辑。根据此定义，此操作将被视为删除和创建新的统计规则。作为编辑的一部分，所有统计信息实例都将被删除。

<a id="ID4EMS" />

## 复制现有的统计规则

<Warning>
  在产品通过最终认证后，无法再更改或删除该产品中事件的现有统计规则。
</Warning>

1. 在产品实例的 **事件和统计规则** 页面上，找到包含要删除的统计规则的行。
2. 在该行的 **操作** 列中选择 **复制**。
3. 在事件的 **更新统计规则** 对话框中进行更改。
4. 选择 **保存**。

<a id="ID4EMF" />

## 删除现有的统计规则

<Warning>
  * 在产品通过最终认证后，无法再更改或删除该产品中事件的现有统计规则。
  * 删除统计规则是永久性的操作，无法撤消或还原。
  * 删除统计规则会删除它可能具有的任何链式依赖项。删除统计规则之前，请确保还要删除其所有依赖项。
</Warning>

1. 在产品实例的 **事件和统计规则** 页面上，找到包含要删除的统计规则的行。
2. 在该行的 **操作** 列中选择 **删除**。
3. 在 **确认** 对话框中选择 **删除**。

<img src="https://mintcdn.com/microsoft-4404708b/66WJ_HwgXG1cFJFn/publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png?fit=max&auto=format&n=66WJ_HwgXG1cFJFn&q=85&s=18f149e565417485187df9a2a9ae1fab" alt="事件删除依赖项" width="624" height="297" data-path="publishing/game-publishing/how-to/data-platform-2013/media/event_delete_dependency.png" />


## Related topics

- [在合作伙伴中心中配置统计更改通知](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-stat-notifications.md)
- [在合作伙伴中心中配置特色统计信息](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-featured-stats.md)
- [在合作伙伴中心中配置 XBOX 事件](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-events-2013.md)
- [在合作伙伴中心中配置 XBOX 数据平台 2013](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-data-platform-2013.md)
- [在合作伙伴中心中配置成就](/zh-CN/publishing/game-publishing/how-to/data-platform-2013/how-to-configure-achievements-2013.md)