# 设置 User Reporting

> Integrate the User Reporting SDK with your app to enable player feedback collection.

将 User Reporting SDK 与您的应用程序集成来设置 User Reporting。集成后，您可以使用内置的用户报告预制件，或者在没有预制件的情况下创建自己的自定义用户报告。

> **Note:**
>
> \*\*注意：\*\*在将用户报告集成到项目之前，请确保设置了项目来启用 Unity Services。您的项目必须在编辑器中并通过项目 ID 连接到 Dashboard（后台）。请参阅[设置项目启用 Unity Services](https://docs.unity3d.com/Manual/SettingUpProjectServices.html)。

要将内置示例 User Reporting 预制件添加到项目中，请执行以下操作：

1. 在编辑器中打开 Package Manager（包管理器），然后找到 User Reporting（用户报告）包并选择 Samples（示例）选项卡。
2. 找到 User Reporting Example（用户报告示例）并选择 **Import（导入）**。
3. 在项目中，将 User Reporting 预制件添加到所需的场景中。
4. 在您的 **Assets 文件夹**中，打开 **Samples** 并选择 **User Reporting** 文件夹。
5. 打开以所安装包版本（例如 **1.0.0**）命名的文件夹。
6. 打开 **User Reporting Example** 文件夹。
7. 将 **UserReportFormExample** 预制件拖放到场景中。

## 设置新报告的通知##set-up-notifications-for-new-reports

User Reporting 功能通过集成支持新报告通知，使您可以将开发工作流程连接到非 Unity 工具。您可以通过第三方集成，比如电子邮件、Slack、Discord、Trello [等](https://docs.unity3d.com/Manual/UnityIntegrations.html)，接收通知。

要设置通知，请执行以下操作：

1. 打开 [Unity Dashboard（Unity 后台）](http://dashboard.unity3d.com/)。
2. 从顶部菜单上的项目选择器中选择所需的项目。**注意**：在设置报告通知之前，请确保为该项目添加并启用了 User Reporting。
3. 从主菜单中，选择 **Projects（项目）**。
4. 选择 **Project Settings（项目设置）**> **Integrations（集成）**。
5. 选择 \*\*New Integration（新建集成）\*\*并根据要使用的集成来按照弹出窗口中的说明操作。

## 测试报告和通知##test-reports-and-notifications

示例场景是确认 User Reporting 是否已正确设置的有效工具。在这个例子中，我们将选择性地包括对新报告的电子邮件通知集成进行测试。

要设置电子邮件通知（可选），请执行以下操作：

1. 打开 [Unity Dashboard（Unity 后台）](http://dashboard.unity3d.com/)。
2. 从顶部导航菜单上的项目选择器中选择所需的项目。**注意**：在设置报告通知之前，请确保为该项目添加并启用了 User Reporting。
3. 选择 **Projects（项目）**。
4. 选择 **Project Settings（项目设置）**> **Integrations（集成）**。
5. 选择 \*\*New Integration（新建集成）\*\*并按照 \*\*Email（电子邮件）\*\*集成弹出窗口中的说明操作。启用 \*\*Report Received（收到报告）\*\*事件选项。

要测试是否收到了报告，请执行以下操作：

1. 打开您的 Unity 项目。
2. 在您的 **Assets** 文件夹中，打开 **Samples** 并选择 **User Reporting**。
3. 在 **User Reporting Example 文件夹**中找到 **UserReportingExample.unity** 场景。
4. 启动场景。单击任意位置以在场景中生成一个立方体，然后选择 \*\*Create Report（创建报告）\*\*来打开提交表单。
5. 填写表单并选择 **Submit（提交）**，然后确认报告已成功发送。
6. 打开 [Unity Dashboard（Unity 后台）](http://dashboard.unity3d.com/)。
7. 从顶部菜单上的项目选择器中选择所需的项目。
8. 选择 **DevOps** > **Cloud Diagnostics** > **User Reporting（用户报告）**。
9. 等待几分钟，然后您的报告将显示在 Dashboard（后台）中。如果您选择设置了集成，则可以看到几乎在报告显示的同时收到通知。