一般事件

1.1 使用场景

一般事件模块可查询和维护Finder支持的全部事件的详细信息，包括新增事件、编辑事件、设置事件状态、验收埋点等。

1.2 名词解释

1.2.1 事件

描述您的用户在产品内触发的一系列动作（比如：点击、滑动、访问页面等），事件采集主要通过应用内埋点来实现，因此也称为“埋点数据”。

1.2.2 预置事件

Finder所提供的SDK自带的事件，上报时机由Finder统一配置。不同SDK对应的预置事件不同，点击查看预置事件列表。链接：预置事件和属性

1.2.3 非预置事件

您自行上报事件，上报时机和业务含义由产品自定义。

2.1 新增事件

登记埋点和验收埋点的本质效果是一样的，都是注册事件信息。如果您开启了Finder数据校验模式，那么只有验收/登记过的事件才能查到数据，没有注册的事件会丢弃。登记和验收的差别在于：

• 验收埋点：只能在事件上报之后进行。
• 登记埋点：在事件上报之前、之后都可以进行。您可以在埋点设计阶段就可以把事件登记上，这样一旦上报就会开始构建数据，不用担心因为来不及验收而丢失数据。

2.1.1 快速登记

打开数据管理 > 一般事件页面，点击页面右上角“登记埋点/快速登记”按钮，您可以在弹窗中登记事件信息，一次只能提交一个事件。

登记注意事项：

• 事件名称不得与已存在的事件名称或虚拟事件名称重复。
• 事件名称命名规范：以字母或数字开头，后面可以跟字母、数字、下划线、点号、空格和短横线，总长度为 1 到 255 个字符。
• 属性设置仅适用于一般事件属性（在params上报的属性），事件公共属性（在header上报的属性）请前往“事件属性”页登记。
  

2.1.2 批量登记

如果您需要一次性登记多个埋点，您可以使用批量登记功能提高操作效率，一次最多可以提交200个事件。快速登记和批量登记的效果是一样的，差别仅在于登记事件数量不同。
具体的操作方式是：打开数据管理 > 一般事件页面，点击页面右上角“登记埋点/批量登记”按钮，下载《埋点设计模板》，按照格式说明填写埋点信息并上传。

2.2 已有事件追加事件属性

如果您需要对已经上报的事件追加事件属性，可以点击列表中的事件名称（蓝色）查看事件详情，并在详情页点击“添加事件属性”，为当前事件追加属性。

2.3 编辑事件展示名、描述

Finder建议您及时维护事件展示名、事件描述信息，这有助于应用成员更好的理解埋点业务含义。

• 展示名：建议填写事件含义，例如：点击提交按钮。
• 事件描述：建议填写事件上报时机、业务场景等信息，例如：用户点击注册页面的提交按钮时上报。

2.3.1 单次修改展示名、描述

2.3.2 批量修改展示名、描述

如果您希望批量补全信息，你可以将展示名、事件描述为空的事件筛选出来，打包导出为csv格式文档，在csv文档中填写完整并上传导入，实现批量修改/登记展示、描述信息。

2.4 设置事件状态

您可以在列表调整事件的状态，不同状态下的事件处理逻辑如下：

操作示意图：

2.5 验收事件

一般事件列表仅展示已验收的事件，未验收事件可点击“验收事件”查看并完成验收。待验收事件列表上限展示1000个事件，超出部分不可查。
您也可以在“数据验收”页面管理事件黑名单，将需要的事件添加或移出黑名单，黑名单事件数量不限。

2.6 验收埋点

实时埋点检测是可以实时检测、快速验证埋点是否正确及数据上传情况的功能；支持移动端App(Android、iOS)、微信小程序，相关操作说明请参见实时埋点检测。

1. 如何删除事件？
   当前Finder不支持删除已经存在的事件，您可以将不需要的事件状态设置为“禁用”。
2. 为什么事件在分析模块找不到？
   建议先检查事件状态，被禁用的事件无法使用。如需使用可以重新启用。
3. 如何添加事件属性？
   如果您需要对已有的事件添加事件属性，您可以点击“登记埋点”对已有的事件添加事件属性。

   说明

   一般事件只能登记非事件公共属性，事件公共属性需要在“事件属性”模块登记。