重要
Visual Studio App Center 于 2025 年 3 月 31 日停用,但分析和诊断功能除外,这些功能将继续受支持,直到 2026 年 6 月 30 日。 了解详细信息。
事件是用户在你的应用中执行的操作。 通过跟踪应用中的事件,你将详细了解用户的行为,并了解用户与应用之间的交互。 将属性附加到事件将提供有关事件的上下文信息。
通过跟踪应用中的事件,可以回答以下问题:
- 查看的前 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”、“拒绝”、“忽略”。
属性值针对类型为“String”的值进行优化。
限制
- 每天可跟踪的不同自定义事件的最大数目为 200。 此计数在 UTC 午夜 12 点重置。 但是,每个设备发送的事件实例数上限没有限制。
- 每个事件的事件属性名称和/或值的最大数目为 20。 发送超过 20 个属性名称和/或值时,只处理前 20 个属性名和/或值,其余属性会自动删除。
- SDK 将事件名称截断为前 256 个字符。
- SDK 将每个属性键和值截断为前 125 个字符。
- 门户将显示计数最高的最多 10 个属性值。
面包屑 (崩溃前的事件)
事件可帮助你确定应用崩溃的根本原因。 作为 App Center 崩溃服务的一部分,可以查看特定会话崩溃之前发生的所有事件。
若要查看故障前的事件,请将 Analytics SDK 集成到应用中,并定义一个或多个事件。
面包屑存储 28 天,而崩溃信息可能会被无限期存储。 这意味着,如果你正在查看超过 28 天的崩溃,则不会看到相应的痕迹。
已处理的错误
若要跟踪 App Center 中处理的错误,建议使用特定功能。 请在 官方文档中查看有关本主题的详细信息。