事件指标

  • 项目

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

事件是用户在应用中执行的操作。 通过跟踪应用中的事件，你将了解有关用户行为的详细信息，并了解用户与应用之间的交互。 将属性附加到事件将提供有关事件的上下文信息。

通过跟踪应用中的事件，你可以回答如下问题：

  • 查看的前 N 个内容是什么？
  • 最喜欢的内容是什么？
  • 我的用户发送哪些类型的文件？

若要跟踪应用中的自定义事件，请使用 trackEvent App Center Analytics SDK 中的 API。 有关如何使用 SDK 定义自定义事件的详细信息，请参阅适用于 Android、iOS、React Native、MAUI/Xamarin、Windows、macOS 和 Unity 的 App Center SDK 文档。

常规信息

可以按 时间范围 (过去 1 天、7 天或 28 天) 以及所选 应用版本筛选事件页。 这些筛选器允许向下钻取到所选时间段或应用版本的事件数据。

“事件”页

“事件”页提供了一个表，其中概述了应用中发生的事件。 此表可以按计数按降序和升序排序。 还可以按名称在表中查找事件。 对于每个事件，都提供以下信息：

  • 计数：触发事件的次数。
  • 趋势：与上一个选定时间段相比，绝对值和百分比的计数变化。
  • 用户：已触发事件的用户数。
  • 用户更改：与上一个选定时间段相比，以绝对值和百分比表示的用户数的更改。
  • 每个用户计数：每个用户触发事件的平均次数。

事件详细信息视图

在事件表中选择一个事件，以显示更详细的信息：

  • 用户：触发事件的用户总数。 LAST (n) DAYS 是一种趋势计算。
  • 计数：触发事件的总次数。
  • 每个用户计数：每个用户触发事件的平均次数。
  • 每个会话的计数：每个会话触发事件的平均次数。

删除事件历史记录

通过单击页面右上角的设置选项并选择“删除事件历史记录”，从“事件详细信息”视图中删除单个事件。 此操作不可撤消。

事件属性

事件属性提供有关事件的上下文信息。 通过它们，可以更深入地了解用户在应用中执行的操作。

事件和属性的示例包括：

  • 事件名称： “文件上传”， 事件属性： “.PDF”、“.txt”、“.PNG”。
  • 事件名称： “问题解答”， 事件属性： “Accept”、“Decline”、“Ignore”。

属性值针对“String”类型的值进行优化。

限制

  • 每天可跟踪的不同自定义事件的最大数目为 200。 此计数在 UTC 上午 12 点重置。 但是，对每个设备发送的事件实例的最大数量没有限制。
  • 每个事件的最大事件属性名称和/或值数为 20。 发送超过 20 个属性名称和/或值时，仅处理前 20 个属性名称和/或值，其余属性名和/或值会自动删除。
  • SDK 将事件名称截断为前 256 个字符。
  • SDK 将每个属性键和值截断为前 125 个字符。
  • 门户将显示最多 10 个计数最高的属性值。

事件可帮助你确定应用崩溃的根本原因。 作为 App Center 崩溃服务的一部分，可以查看特定会话崩溃之前发生的所有事件。

若要在崩溃之前查看事件，请将 Analytics SDK 集成到应用中，并定义一个或多个事件。

痕迹导航存储 28 天，而崩溃可能会无限期存储。 这意味着，如果你正在查看超过 28 天的崩溃，则不会看到相应的痕迹导航。

处理的错误

若要跟踪 App Center 中处理的错误，建议为其使用特定功能。 在我们的 官方文档中查看有关本主题的详细信息。