事件指标

重要

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

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

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

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

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

若要跟踪应用中的自定义事件,请使用 trackEvent App Center Analytics SDK 中的 API。 有关如何使用 SDK 定义自定义事件的详细信息,请参阅适用于 AndroidiOSReact NativeMAUI/XamarinWindowsmacOSUnityApp 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 中处理的错误,建议为其使用特定功能。 在我们的 官方文档中查看有关本主题的详细信息。