事件指标

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用,但分析和诊断功能除外,这些功能将继续受支持,直到 2026 年 6 月 30 日。 了解详细信息

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

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

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

若要跟踪应用中的自定义事件,请使用 trackEvent App Center Analytics SDK 中的 API。 有关如何使用 SDK 定义自定义事件的详细信息,请参阅适用于 AndroidiOSReact NativeMAUI/XamarinWindowsmacOSUnityApp Center SDK 文档

一般信息

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

活动页面

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

  • 计数:触发事件的次数。
  • 趋势:与上一个所选时间段相比,计数绝对值和百分比的变化。
  • 用户:触发事件的用户数。
  • 用户更改:与上一个所选时间段相比,更改绝对值和百分比的用户数。
  • 每个用户的计数:每个用户触发事件的平均次数。

事件详细信息视图

选择事件表中的事件以显示更多详细信息:

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

删除事件历史记录

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

事件属性

事件属性提供有关事件的上下文信息。 他们使得能够更深入地了解用户在你的应用中执行的操作。

事件和属性的示例包括:

  • 事件名称: “文件上传”, 事件属性: “.PDF”、“.txt”、“.PNG”。
  • 事件名称: “已回答问题”, 事件属性: “Accept”、“拒绝”、“忽略”。

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

限制

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

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

若要查看故障前的事件,请将 Analytics SDK 集成到应用中,并定义一个或多个事件。

面包屑存储 28 天,而崩溃信息可能会被无限期存储。 这意味着,如果你正在查看超过 28 天的崩溃,则不会看到相应的痕迹。

已处理的错误

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