---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://appmetrica.yandex.by/docs/en/data-collection/basic-events.md
  - https://appmetrica.yandex.by/docs/ru/data-collection/basic-events.md
  - https://appmetrica.yandex.by/docs/zh/data-collection/basic-events.md
  - href: https://appmetrica.yandex.by/docs/zh/data-collection/basic-events.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r22076204
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/zh/llms.txt?revision=r22076204

# 基本事件

{% note info %}

基本事件是免费且无限制的。

它们的数量不受限制，并且不消耗自定义事件的限额。 [了解更多关于套餐的信息](https://appmetrica.yandex.by/docs/zh/common/pricing/ru-currency.md)。

{% endnote %}

基本事件是AppMetrica的标准事件集。 它们有数据传输方法和内置报告。 基本事件不消耗自定义事件的配额。

部分基本数据在接入后由 SDK 自动收集。 其余的需要开发者配置传输。 自动收集的能力取决于平台、所连接分析库的版本及其设置。

## 哪些事件会自动收集 {#auto-collection}

#|
||
**事件** | **记录内容** | **收集特点**
||
||
安装
|
首次启动已接入分析的应用
|
接入分析后，首次启动会自动记录。
||
||
会话
|
应用访问
|
应用访问会自动收集。 将访问拆分为会话的规则在设置中配置。
||
||
深链打开
|
通过链接打开应用
|
链接跳转可以自动收集。 在已运行的应用内打开的链接需要额外配置。
||
||
[崩溃](https://appmetrica.yandex.by/docs/zh/data-collection/about-crashes-and-errors.md)
|
应用异常终止
|
为了清晰描述崩溃，开发者可能需要上传额外的文件。
||
||
推送令牌
|
推送通知投递系统中的设备标识符
|
处理通知需要相应的接入。
||
||
[应用内购买和订阅](https://appmetrica.yandex.by/docs/zh/data-collection/about-revenue.md)
|
购买和订阅状态变更
|
开发者根据应用商店配置购买和订阅变更的收集。
||
|#

## 哪些事件需要配置 {#configurable-collection}

#|
||
**事件** | **传输内容** | **如何配置**
||
||
[电子商务](https://appmetrica.yandex.by/docs/zh/data-collection/about-ecommerce.md)
|
商品、购物车和订单的操作
|
描述操作并给开发者分配收集任务
||
||
[Product Flow](https://appmetrica.yandex.by/docs/zh/data-collection/offers.md)
|
展示优惠、开始结算、步骤和结果
|
描述场景阶段并让开发者传输
||
||
[广告收入](https://appmetrica.yandex.by/docs/zh/data-collection/about-adrevenue.md)
|
每次广告展示的收入
|
请开发者接入广告收入数据
||
||
[应用内收入](https://appmetrica.yandex.by/docs/zh/data-collection/about-revenue.md)
|
手动发送的购买事件
|
让开发者收集购买；对于订阅，另外接入状态变更跟踪
||
||
[错误](https://appmetrica.yandex.by/docs/zh/data-collection/about-crashes-and-errors.md)
|
关于应用问题的自定义消息
|
描述重要错误并给开发者分配收集任务
||
|#

除了事件，还可以传输[个人属性](https://appmetrica.yandex.by/docs/zh/data-collection/about-profiles.md) — 用户特征。 它们也不消耗自定义事件的限额，但描述的是用户的状态，而不是单独的操作。

## 如何开始收集 {#how-to-start}

1. 在表格中找到所需的数据类型。
1. 向开发者确认哪些事件已经在收集。
1. 如果需要额外配置，打开所选类型的说明并将其交给开发者。
1. 执行测试场景并在相应报告中检查数据。

如果没有合适的基本类型，请使用[自定义事件](https://appmetrica.yandex.by/docs/zh/data-collection/custom-events.md)。 不要在没有单独任务的情况下创建已收集数据的自定义副本。

自动收集取决于平台和应用设置。 请开发者检查哪些事件已经在传输，以及还需要接入什么。

{% cut "给开发者：自动收集的特点" %}

{% file src="../../_assets/instructions/basic-developer-zh.txt" name="basic-developer-zh.txt" type="text/plain; charset=utf-8" %}

#|
||
**事件** | **记录内容** | **收集特点**
||
||
安装
|
首次启动已初始化 AppMetrica SDK 的应用
|
由 SDK 自动收集
||
||
会话
|
用户与应用交互的时间段
|
由 SDK 收集。 在指定超时后返回会开始新会话；当前会话的结束在下一个会话开始时记录。 了解更多关于会话配置的信息：[Android](https://appmetrica.yandex.by/docs/zh/sdk/android/analytics/android-listen.md)、[iOS](https://appmetrica.yandex.by/docs/zh/sdk/ios/analytics/ios-listen.md)。
||
||
深链打开
|
通过通用链接或自定义 URI 方案打开应用
|
Android 和 iOS SDK 从 4.0 版本开始支持自动跟踪打开。 在已运行的应用中处理的深链需要额外配置
||
||
[崩溃](https://appmetrica.yandex.by/docs/zh/data-collection/about-crashes-and-errors.md)
|
应用异常终止
|
SDK 中提供了收集。 为了可读的日志，可能需要 mapping、SO 或 dSYM 文件
||
||
推送令牌
|
推送通知投递系统中的设备标识符
|
用于处理推送通知；接收取决于相应集成的配置
||
||
[应用内购买和订阅](https://appmetrica.yandex.by/docs/zh/data-collection/about-revenue.md)
|
购买和订阅状态变更
|
受支持的应用商店购买可以自动收集。 它和订阅状态跟踪按平台说明配置
||
|#

{% endcut %}

<!-- source: zh/_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/_includes/feedback-button.md -->