---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/data-collection/about-events.md
  - https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md
  - https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-events.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

# 事件

事件帮助你跟踪应用中用户的任何操作。

#### 为什么要设置事件发送？ {#important}

Boost 不直接跟踪您应用中的用户操作。 但是，它可以通过事件收集这些操作的信息，例如：

- 用户查看特定屏幕。
- 用户点击特定按钮。

这些事件会发送到Boost，并显示在[事件](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md)报告中。 [事件发送的示例](#report-events).

## 事件嵌套级别 {#level}

要发送包含嵌套参数的事件，请传递 `键:值` 对。 在界面中，`key` 和 `value` 被视为嵌套级别。

![键值对](../../_images/levels-zh.png){style="border: solid 1px #cccccc; max-width: 800px;"}

{% note info "" %}

Boost 支持发送包含多级嵌套参数的事件。

{% endnote %}

在传递 JSON 格式的参数时，值中的每个新对象表示一个新的嵌套级别，例如：

```
{
"param1":"1",  // 嵌套级别 1
"param2":"abc",
"param3": {
	"paramLevel2": "2", // 嵌套级别 2
	"param2Level2": {
		"paramLevel3": "3", // 嵌套级别 3
		"param2Level3":{
			"level": "4" // 嵌套级别 4
      }
    }
  }
}"
```

网页界面Boost显示事件最多五级嵌套。 如果事件有六级或更高级别，报告中只显示前五级。

{% note info "" %}

您可以使用[报告 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/intro.md)获取最多十级事件嵌套。

{% endnote %}

## 数值和字符串值的解释 {#value}

在Boost界面中，值`{"count": 3}`和`{"count": "3"}`被以相同方式解释。 但是，在使用报告 API 或 [日志 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/logs/about.md) 导出数据时，参数会以发送到服务器时的相同形式导出。

如果同一个事件多次传递不同的数值参数，网页界面不会对参数值进行聚合。 每个都单独记录和计算。

{% note info "" %}

您可以使用报告 API 导出额外字段：所有数值的总和和平均值。

{% endnote %}

## 部分匹配的嵌套事件 {#similar}

您可以为同一事件传递不同的参数值。

如果服务器接收到具有重复参数的事件，其值会被累积，报告中会显示每个唯一值的数量。

如果服务器接收到参数重复但嵌套级别不同的事件，则会根据重复的参数将它们的值相加。

例如，第一个事件有两个嵌套级别：

```java translate=no
{
    "param1": "param2"
}
```

第二个有三级嵌套：

```java translate=no
{
    "param1": {
        "param2": "value"
    }
}
```

在网页界面中，这些事件以树形结构显示：

![树形视图](../../_images/example-zh.png){style="border: solid 1px #cccccc; max-width: 800px;"}

事件按以下算法进行计数：

1. 事件已被记录，包括其两个子级。 每个参数都加上1。
1. 事件名称和其三个子级别中添加了1。

## 漏斗 {#funnels}

要分析事件链并比较转化率，请使用[Funnels](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/funnels-report.md)报告。 配置1到10个步骤，每个步骤包含一个或多个应用事件。 对于多级事件，使用键值过滤。

使用漏斗比较不同版本应用中的目标事件转化，评估行为场景转化趋势，或了解有多少受众需要特定的应用功能（用户数量和百分比）。

这样你就能找到用户增长点，并实现最佳的想法。 如需了解更多信息，请参阅[漏斗](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/funnels-report.md)。

## 发送事件 {#report-events}

各平台发送事件的示例：

- [安卓](https://boost.yandex.com/doc/zh/analytics/content/sdk/android/analytics/android-operations.md#report-event)
- [iOS](https://boost.yandex.com/doc/zh/analytics/content/sdk/ios/analytics/ios-operations.md#report-event)
- [Flutter](https://boost.yandex.com/doc/zh/analytics/content/sdk/flutter/analytics/flutter-operations.md#report-event)
- [React Native](https://boost.yandex.com/doc/zh/analytics/content/sdk/react-native/analytics/react-native-operations.md#report-event)
- [Unity](https://boost.yandex.com/doc/zh/analytics/content/sdk/unity/analytics/unity-operations.md#report-event)

## 了解更多 {#learm-more}

- [事件报告](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/events-report.md)
- [漏斗报告](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/funnels-report.md)
- [报告 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/stat/intro.md)
- [日志 API](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/logs/about.md)
- [限制自定义事件](https://boost.yandex.com/doc/zh/analytics/content/common/limits.md)

<!-- source: zh/analytics/content/_includes/feedback-button.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button.md -->
