一般事件

1.1 使用场景 #

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

1.2 名词解释 #

1.2.1 事件 #

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

1.2.2 预置事件 #

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

1.2.3 非预置事件 #

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

操作权限说明：如果您需要管理一般事件，请联系您的应用管理员为您开通“数据管理-一般事件-可管理”功能权限，无权限用户只能查看，无法进行操作。

2.1 新增事件 #

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

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

注意：对于开启了“埋点入库校验”的应用，未登记/验收的事件不构建数据，为了保障数据的完整，Finder建议您在事件上报之前完成登记。

2.1.1 快速登记 #

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

登记注意事项：
事件名称不得与已存在的事件名称或虚拟事件名称重复。
事件名称命名规范：^[a-zA-Z0-9][a-z0-9A-Z_ \\.-]{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)、微信小程序。 点击查看操作说明https://www.volcengine.com/docs/6285/66054

3.1 如何删除事件？ #

当前Finder不支持删除已经存在的事件，您可以将不需要的事件状态设置为“禁用”。

3.2 为什么事件在分析模块找不到？ #

建议先检查事件状态，被禁用的事件无法使用。如需使用可以重新启用。

3.3 如何添加事件属性？ #

如果您需要对已有的事件添加事件属性，您可以点击“登记埋点”对已有的事件添加事件属性。
注意：一般事件只能登记非事件公共属性，事件公共属性需要在“事件属性”模块登记。