# 微信小程序全埋点事件定义 >[info] 通过该功能，您可以对通过全埋点采集上报的事件，进行快速重命名和定义，方便分析使用。 当您的微信小程序集成方舟SDK，并开启全埋点功能后，方舟SDK会默认采集用户的所有“页面浏览“事件（$pageview）和“元素点击“事件（$user\_click）。但是，由于采集到的事件属性值可读性差，难以快速区分出用户具体浏览了什么页面、点击了哪个元素；因此，通常还需要通过“虚拟事件“功能，过滤出特定页面的浏览或特定元素的点击，对事件进行再次命名和定义。然而，通过“虚拟事件“，需要您了解如何筛选出想要定义的事件：一般通过 页面URL 筛选具体的页面浏览事件，通过 元素ID 筛选具体元素的点击事件。 URL 和 元素ID，对业务人员来说，难获取，且辨识度低，因此，方舟推出“微信小程序全埋点事件定义“功能，帮助您通过更加便捷 、所见即所得的定义方式，更加高效的管理和使用数据、专注于业务分析。 > 下面是通过“虚拟事件“功能，进行全埋点事件定义的示例，需要您了解如何进行特定页面、特定元素的过滤。 > （1）筛选出小程序首页的浏览事件，定义为“首页浏览“事件。 > PS.通过 URL 筛选具体页面 >  > （2）筛选出特定元素的点击事件，定义为“XX按钮点击“事件。 > PS.通过 元素ID 筛选具体元素 >  # 功能使用说明 ## 使用前准备 1）集成微信小程序SDK（4.3.11.2版），开启全埋点功能，开启采集下述属性，并设置 debug=0或2，否则 debug=1时数据不入库，无法使用该功能 >[warning] 1、请集成 4.3.11.2 版本SDK，点击查看 [微信小程序SDK集成文档]() > 2、务必设置 debug = 0 或 2 > 3、开启全埋点采集功能，并进行下述必要配置 >[info] 注意：使用该功能依赖几个必须的事件属性，请在集成微信小程序SDK的时候，同时开启采集以下几个必要属性: > | 属性ID | 属性名 | 所属事件 | > | --- | --- | --- | > | $element\_id | 元素ID | $user\_click | > | $element\_type | 元素类型 | $user\_click | > | $element\_content | 元素内容 | $user\_click | 2）项目有全埋点采集数据上报入库：需要有 $pageview 事件 和 $user\\\_click 事件入库，同时以下几个属性必须有回数 >[info] | 属性ID | 属性名 | 所属事件 | > | --- | --- | --- | > | $url\_path | 页面地址（不含参） | $user\_click | > | $element\_id | 元素ID | $user\_click | > | $element\_type | 元素类型 | $user\_click | > | $element\_content | 元素内容 | $user\_click | > | $element\_function | 触发事件名（函数名） | $user\_click |  3）初始配置：验证AppSecret（小程序密钥） 首次使用该功能时，需输入AppSecret（小程序密钥）进行验证和初始配置 >[info] 如何获取小程序密钥 > 1、询问您的小程序开发人员 > 2、进入小程序后台获取  当小程序密钥重置后，需重新输入验证  ## ## 1、根据日志定义 ### 1）输入要定义的页面路径： 定义页面浏览事件 和 元素点击事件 都需要输入页面路径（元素在页面上）  >  ### 2）进入相应页面： 输入页面路径后，界面会生成一个临时的小程序码，使用手机微信扫一扫，扫描该小程序码，进入相应页面  进入页面后，该页面的浏览事件以及您在页面上的元素点击事件，即会实时上报入库 相应的事件日志会同步显示在页面上，这时您就可以根据日志，进行事件定义了  如果日志上报和显示有延迟，请您稍等几秒；如果等候时间较长后仍不见有日志显示，请联系您的客服人员进行排查。 ### 3）开始定义： 点击“定义页面“、“定义元素“按钮，开始定义 > 定义页面 >  > 定义元素 >  ## 2、页面总览 进入页面总览页，查看各个页面的定义状态、以及页面上元素的定义进度  ## 3、管理已定义事件 点击“管理已定义事件“ 页签，页面会自动跳转进入“元数据管理》虚拟事件“ 这里您可以综合管理所有虚拟事件 通过“虚拟事件类型“字段，可以区分“全埋点自定义“事件  ## 4、在“分析“等功能中使用定义好的事件 您可以在“事件分析“等各种分析功能中，使用定义好的事件 凡可以使用“虚拟事件“的功能模块，均可以使用