---
metadata:
- name: generator
content: Diplodoc Platform v5.64.0
alternate:
- https://boost.yandex.com/doc/en/analytics/content/mobile-reports/events-report.md
- https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/events-report.md
- https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md
- href: https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md
type: text/markdown
title: Markdown version
- href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
# 事件
报告显示自定义事件的统计数据。 您可以在应用中设置发送这些事件。 要了解更多信息，请参见[发送自定义事件](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md)。
## 该报告会帮助您： {#resolve-tasks}
- 确定应用功能的覆盖范围和受欢迎程度。
- 比较不同用户组的行为。
- 评估会话中使用功能的频率。
- [分析嵌套事件参数](#analytics).
## 通用设置 {#how-to}
1. 选择时间段和观众群体。 默认情况下，报告显示按天分组的本周事件。
事件时间是指事件在用户设备上生成的时刻，时间区域根据应用设置指定。
{% note info "" %}
要设置自定义报告期，请使用按钮。 所选时间间隔可以按小时、天、周或月进行分组。
{% endnote %}
2. 您可以使用[分段](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/segmentation.md)为报告选择特定用户。
3. 您可以在报告中设置[维度](#group)和[指标](#metrics)。
## 配置图表并选择指标 {#metrics-in-graph}
在图表中，您可以同时选择多个指标，如果它们使用相同的单位。 如果一个指标不在列表中（名称显示为灰色），就表示它使用了不同的单位。
## 维度和指标 {#groups-and-metrics}
报告包含按分组归类的指标。
要设置分组和指标：
1. 点击**分组和指标**按钮。
2. 在弹出的窗口中，添加用于构建报告的分组和指标。
3. 配置指标和分组的顺序。
指标的顺序决定列的顺序，分组的顺序决定表中行的嵌套。
### 分组 {#group}
{% note alert "" %}
按参数分组的维度仅在嵌套级别 1 可用。 要了解层级嵌套的更多信息，请查看[事件示例](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md)。
{% endnote %}
{% cut "受众" %}
- **操作系统**.
- **完整的操作系统版本**.
- **性别**. 使用Crypta技术启用了启发式方法。 如果预测精度不足，它会采用`未定义`的值。
- **年龄区间**. 使用Crypta技术启用启发式确定。 Possible values: `<18 | 18-24 | 25-34 | 35-44 | 45-54 | ≥55` 如果预测精度不足，则为未定义。
{% endcut %}
{% cut "地理位置" %}
- **大洲**.
- **国家**.
- **区域**.
- **区域**.
- **城市**.
- **城市规模**.
{% endcut %}
{% cut "事件" %}.
- **事件**. 事件名称。
- **所有参数，嵌套级别 1-5** 输出所有传递的事件参数，对应于 [嵌套级别](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md#level)。
- **参数**. 允许您选择特定参数。 您可以多次选择维度，每次使用不同的参数。
{% note alert "" %}
只可使用第1级嵌套参数。
{% endnote %}
{% endcut %}
{% cut "事件日期" %}
- **天**.
- **周**.
- **月**.
{% endcut %}
{% cut "应用" %}
- **版本**.
- **构建号**.
{% endcut %}
### 指标 {#measure}
{% note alert "" %}
按参数统计仅支持第1级嵌套。 要了解嵌套级别的更多信息，请查看[事件示例](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md)。
{% endnote %}
{% cut "事件指标" %}
- **事件**.
- **唯一的参数值**. 所选事件参数的唯一值数量。
- **参数值之和**. 所选事件参数值的总和。 在事件计算过程中，缺失的值或参数会被解释为 0。
- **平均参数值**. 所选事件参数值之和除以事件数量。 缺失的值或参数会被解释为 0。
- **中位参数值**. 所选事件参数的中位值。 在计算过程中，事件中的缺失值或参数会被解释为 0。
{% endcut %}
{% cut "用户指标" %}
- **用户**. 具有该事件的用户数量。
- **每个用户的事件**. 事件数量与总应用用户数的比例。
- **所有用户的 %**. 事件发生的用户占全部应用用户的百分比。
- **每个用户的唯一参数值**. 选定事件参数的唯一值数量与有该事件的用户数量之比。 在计算过程中，事件中的缺失值或参数会被解释为 0。
- **每个用户的参数值总和**. 所选事件参数值总和与具有该事件的用户数的比值。 在计算过程中，事件中的缺失值或参数会被解释为 0。
{% endcut %}
{% cut "会话指标" %}
- **包含事件的会话**. 事件发生的会话数量。
- **每次会话的事件数**. 事件数量与会话数量的比例。
- **每次会话的唯一参数值**. 所选事件参数的唯一值数量与包含该事件的会话数量之比。 在事件计算过程中，缺失的值或参数会被解释为 0。
- **每次会话中参数值的总和**. 所选事件参数值总和与包含事件的会话数之比。 在计算过程中，事件中的缺失值或参数会被解释为 0。
{% endcut %}
## 事件参数分析 {#analytics}
**嵌套事件参数的分析**
: 您可以使用该报告来分析嵌套的事件参数。 除了观众指标，还提供了参数值的以下聚合：总和、平均值、中位数以及唯一值的数量。 这些指标在以下情况下很有帮助：
- 按选定参数比较事件。
- 计算玩家使用的资源量。
用户和会话的参数值总数和唯一值数量也可获得。
**按特定事件参数分组**
: 您可以在报告中根据特定事件参数设置分组（维度）。 这对以下情况有帮助：
- 过滤报告数据。
- 例如比较事件和计算所有具有所需参数的事件的统计数据。
## 添加评论 {#comments}
为了更方便地查看报告，您可以为事件添加注释。 要做到这一点，请按以下步骤操作：
1. 在**设置** → **事件** 部分找到想要的事件。
{% note info %}
您可以从报告界面进入事件设置。 要做这一步，点击事件名称旁边的图标。
{% endnote %}
2. 留下评论。
3. 返回**事件**报告并刷新页面。
## 禁用事件 {#turn-off}
要禁用事件收集并从报告中移除，请执行以下步骤：
1. 在**设置** → **事件** 部分找到想要的事件。
{% note info %}
您可以从报告界面进入事件设置。 要做这一步，点击事件名称旁边的图标。
{% endnote %}
2. 在**事件收集**块中，选择**禁止收集**模式。
## 数据导出 {#export}
您可以从报告中导出数据。
{% note info "" %}
数据根据选定的报告设置导出：分段、维度和时间期间。
{% endnote %}
{style="border: solid 1px #cccccc; max-width: 300px;"}
在右上角点击{inline=false}，然后选择操作：
- **导出完整报告为CSV** 以从表格中导出数据为 `CSV` 格式。
- **图表 → CSV** 导出图表数据为 `CSV` 格式。
- **图表 → PNG** 导出图表图像为 `PNG` 格式。
- **复制图表 API 请求** — 显示使用 [报告 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/logs/about.md) 导出图表数据的查询文本。
- **复制表格 API 请求** — 显示使用 [报告 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/logs/about.md) 导出表格数据的查询文本。
您可以使用此查询来创建自定义仪表板或编写自动数据导出脚本。
{% note info "" %}
如果您第一次获取查询文本，请确保浏览器不会阻止弹出的授权窗口。 在授权窗口中，允许 Analytics module 访问数据。
{% endnote %}
## 故障排查 {#problems}
{% cut "对于 iOS 设备，事件会进入后台会话" %}
{#session-background}
初始化库后立即发送的事件会被计入后台会话。 为了确保事件属于用户会话，请将 `handleActivationAsSessionStart` 选项启用后初始化库。
{% endcut %}
## FAQ {#faq}
{% cut "为什么“事件”和“用户获取”报告中的事件数量不一致？" %}
[用户获取](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/user-acquisition-report.md) 报告只显示在应用安装后发生的事件，且安装发生在所选报告期间。 [事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md) 报告显示与安装日期无关的事件。 用户可能在选定时间段之前就安装了应用，之后才完成该事件。
{% endcut %}
{% cut "设备事件出现在报告中需要很长时间" %}
AppMetrica SDK 不会在事件发生后立即发送事件。 事件被缓存并批量发送。
Analytics module 从 SDK 接收事件可能需要最多 7 天。 在报告中，事件按其发生的时间显示。
要立即在用户场景的重要检查点之后发送缓存事件，请调用 `sendEventsBuffer()` 方法。 这会清空缓冲区并发送所有排队的事件。
{% note info "" %}
频繁使用 `sendEventsBuffer()` 方法可能会导致出站网络流量和电量消耗增加。
{% endnote %}
{% endcut %}
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。
联系支持
为文档提出改进建议