事件
报告显示自定义事件的统计数据。 您可以在应用中设置发送这些事件。 要了解更多信息,请参见发送自定义事件。
该报告会帮助您:
- 确定应用功能的覆盖范围和受欢迎程度。
- 比较不同用户组的行为。
- 评估会话中使用功能的频率。
- 分析嵌套事件参数.
通用设置
-
选择时间段和观众群体。 默认情况下,报告显示按天分组的本周事件。
事件时间是指事件在用户设备上生成的时刻,时间区域根据应用设置指定。
要设置自定义报告期,请使用
按钮。 所选时间间隔可以按小时、天、周或月进行分组。 -
您可以使用分段为报告选择特定用户。
配置图表并选择指标
在图表中,您可以同时选择多个指标,如果它们使用相同的单位。 如果一个指标不在列表中(名称显示为灰色),就表示它使用了不同的单位。
维度和指标
报告包含按分组归类的指标。
要设置分组和指标:
- 点击分组和指标按钮。
- 在弹出的窗口中,添加用于构建报告的分组和指标。
- 配置指标和分组的顺序。
指标的顺序决定列的顺序,分组的顺序决定表中行的嵌套。
分组
按参数分组的维度仅在嵌套级别 1 可用。 要了解层级嵌套的更多信息,请查看事件示例。
受众
- 操作系统.
- 完整的操作系统版本.
- 性别. 使用Crypta技术启用了启发式方法。 如果预测精度不足,它会采用
未定义的值。 - 年龄区间. 使用Crypta技术启用启发式确定。 Possible values:
<18 | 18-24 | 25-34 | 35-44 | 45-54 | ≥55如果预测精度不足,则为未定义。
地理位置
- 大洲.
- 国家.
- 区域.
- 区域.
- 城市.
- 城市规模.
事件
-
事件. 事件名称。
-
所有参数,嵌套级别 1-5 输出所有传递的事件参数,对应于 嵌套级别。
-
参数. 允许您选择特定参数。 您可以多次选择维度,每次使用不同的参数。
只可使用第1级嵌套参数。
事件日期
- 天.
- 周.
- 月.
应用
- 版本.
- 构建号.
指标
按参数统计仅支持第1级嵌套。 要了解嵌套级别的更多信息,请查看事件示例。
事件指标
- 事件.
- 唯一的参数值. 所选事件参数的唯一值数量。
- 参数值之和. 所选事件参数值的总和。 在事件计算过程中,缺失的值或参数会被解释为 0。
- 平均参数值. 所选事件参数值之和除以事件数量。 缺失的值或参数会被解释为 0。
- 中位参数值. 所选事件参数的中位值。 在计算过程中,事件中的缺失值或参数会被解释为 0。
用户指标
- 用户. 具有该事件的用户数量。
- 每个用户的事件. 事件数量与总应用用户数的比例。
- 所有用户的 %. 事件发生的用户占全部应用用户的百分比。
- 每个用户的唯一参数值. 选定事件参数的唯一值数量与有该事件的用户数量之比。 在计算过程中,事件中的缺失值或参数会被解释为 0。
- 每个用户的参数值总和. 所选事件参数值总和与具有该事件的用户数的比值。 在计算过程中,事件中的缺失值或参数会被解释为 0。
会话指标
- 包含事件的会话. 事件发生的会话数量。
- 每次会话的事件数. 事件数量与会话数量的比例。
- 每次会话的唯一参数值. 所选事件参数的唯一值数量与包含该事件的会话数量之比。 在事件计算过程中,缺失的值或参数会被解释为 0。
- 每次会话中参数值的总和. 所选事件参数值总和与包含事件的会话数之比。 在计算过程中,事件中的缺失值或参数会被解释为 0。
事件参数分析
- 嵌套事件参数的分析
- 您可以使用该报告来分析嵌套的事件参数。 除了观众指标,还提供了参数值的以下聚合:总和、平均值、中位数以及唯一值的数量。 这些指标在以下情况下很有帮助:
- 按选定参数比较事件。
- 计算玩家使用的资源量。 用户和会话的参数值总数和唯一值数量也可获得。
- 按特定事件参数分组
- 您可以在报告中根据特定事件参数设置分组(维度)。 这对以下情况有帮助:
- 过滤报告数据。
- 例如比较事件和计算所有具有所需参数的事件的统计数据。
添加评论
为了更方便地查看报告,您可以为事件添加注释。 要做到这一点,请按以下步骤操作:
-
在设置 → 事件 部分找到想要的事件。
备注
您可以从报告界面进入事件设置。 要做这一步,点击事件名称旁边的
图标。 -
留下评论。
-
返回事件报告并刷新页面。
禁用事件
要禁用事件收集并从报告中移除,请执行以下步骤:
-
在设置 → 事件 部分找到想要的事件。
备注
您可以从报告界面进入事件设置。 要做这一步,点击事件名称旁边的
图标。 -
在事件收集块中,选择禁止收集模式。
数据导出
您可以从报告中导出数据。
数据根据选定的报告设置导出:分段、维度和时间期间。

在右上角点击,然后选择操作:
- 导出完整报告为CSV 以从表格中导出数据为
CSV格式。 - 图表 → CSV 导出图表数据为
CSV格式。 - 图表 → PNG 导出图表图像为
PNG格式。 - 复制图表 API 请求 — 显示使用 报告 API 导出图表数据的查询文本。
- 复制表格 API 请求 — 显示使用 报告 API 导出表格数据的查询文本。
您可以使用此查询来创建自定义仪表板或编写自动数据导出脚本。
如果您第一次获取查询文本,请确保浏览器不会阻止弹出的授权窗口。 在授权窗口中,允许 Analytics module 访问数据。
故障排查
对于 iOS 设备,事件会进入后台会话
初始化库后立即发送的事件会被计入后台会话。 为了确保事件属于用户会话,请将 handleActivationAsSessionStart 选项启用后初始化库。
FAQ
为什么“事件”和“用户获取”报告中的事件数量不一致?
设备事件出现在报告中需要很长时间
AppMetrica SDK 不会在事件发生后立即发送事件。 事件被缓存并批量发送。
Analytics module 从 SDK 接收事件可能需要最多 7 天。 在报告中,事件按其发生的时间显示。
要立即在用户场景的重要检查点之后发送缓存事件,请调用 sendEventsBuffer() 方法。 这会清空缓冲区并发送所有排队的事件。
频繁使用 sendEventsBuffer() 方法可能会导致出站网络流量和电量消耗增加。
如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。