You need to enable JavaScript to run this app.
导航
创建并检索埋点
最近更新时间:2025.03.05 17:05:28首次发布时间:2025.03.05 16:51:14

新建埋点

方式1:按需录入

基于一次活动/功能/项目开发/分析需求来设计埋点方案并录入埋点时,您可以选择按需录入方式进行录入,此方式录入时会同步创建需求并录入需求的埋点。

注意事项

  • 同一需求中不允许录入多个同名埋点。
  • 录入已上线埋点(比如新增属性),不允许修改埋点的描述和之前已上线属性的类型、描述;如果要修改请到属性管理进行修改。

操作步骤

  1. 埋点管理>埋点检索页面单击新建埋点
    Image

  2. 新建埋点需求分为两步:填写基本信息、添加埋点 。

    1. 配置基本信息。

      包括需求名称、备注、埋点操作系统、负责人等,需求备注可以配置上对应产品需求文档的链接。

    2. 添加埋点。

      注意

      • 添加埋点可以添加新增的埋点,也可以变更已有埋点,为已有埋点增加属性。
      • 在为已有埋点增加属性时,如果开发和测试需要开发和验证全部属性,则需把原来的属性也加上,如果只需开发和验证本次添加的属性,则添加埋点时只添加本次新增的属性。

      Image
      可以在埋点中录入埋点标签、截图,对于属性可以录入必传信息、可能的枚举值等。

      核心参数

      配置说明

      Event & 埋点展示名 & 埋点描述

      自定义埋点的中英文名称和描述。

      埋点标签

      可以描述埋点所在的功能、模块、位置等,例如支付相关埋点可以全部打标为支付标签。一个埋点可以添加多个标签,也可以不加。

      埋点截图

      埋点对应的UI,方便之后查找理解。

      属性设置

      属性设置支持填写属性备注;属性取值支持正则表达式填写value值的校验逻辑。
      Image

  3. 完成埋点配置后,您可以单击右上方的创建按钮完成埋点录入,或按需单击创建并添加下一个创建并复制,继续录入下一个埋点。
    创建后,如下图所示。
    Image

方式2:批量录入

如果您有大量埋点需要录入,您可以使用模板导入的方式批量录入模板。

  1. 与单个录入方式一致,创建并配置埋点需求后,在埋点方案设计页面,单击右上方的批量导入按钮批量导入。

    注意

    已创建的需求也支持在编辑需求时批量录入埋点,但是目前在已创建需求中批量录入时,需求的状态必须是未上线(审核中需要撤回),点击需求详情后,点击编辑,剩余步骤与下方步骤描述一致。

    Image

  2. 根据界面提示下载导入模板。
    Image

  3. 在模板中填写待录入的埋点,然后上传模板文件。

    编辑表格,需要注意以下几点:

    • 当编辑完表格后,您需要把灰色的提示信息整行都删除掉,否则会解析出错;
    • 序号作为区分不同埋点的标识,一定按从1开始的整数递增序列填写;
    • 在当前表格内,event+场景描述唯一标识一个埋点,在一个序号内,一个event名称只能对应一个场景描述(如果区分场景的话,不区分则忽略)
    • 如果区分场景,场景描述和标定条件均必填,而且属性列不再需要填写场景属性(系统会自动创建)
    • 表格内各列顺序可以调整,也可以添加其他列,只需保证原有模板的必填列有且仅有一个即可
  4. 完成上传后,单击右上角的解析按钮进行埋点数据解析,解析结果如图所示。

    左侧的信息包括三种:红色为错误信息,黄色为需要注意的提示信息,灰色为相对重要性较低的提示信息。
    您需要根据红色提示信息来修改,修改途径包含两个:

    • 原表格:修改完表格后,点击“重新上传”即可
    • 格式化修改:点击右侧的编辑按钮进行编辑修改。需要注意,右侧的格式化修改仅适用于能够正确解析但内容不正确的埋点信息,如果用户不需要相关埋点,直接点击删除按钮;格式化修改后,再点击“重新上传”会忽略之前所做的修改,以表格解析结果为准。
  5. 当解析结果不包含错误后,点击【导入】按钮进行批量导入,成功后会返回埋点设计页。

方式3:快速录入

如果您无需创建需求,希望直接录入埋点数据,可使用快速录入方式。

注意事项

  • 首先确定项目有开启“直接录入”选项。如果没有开启,见“配置管理”设置录入方式。

  • 直接录入只允许新增埋点,修改埋点可以到埋点详情。

操作步骤

  1. 埋点管理>埋点检索页面单击直接录入。
    Image

  2. 在弹出的侧边栏中进行对应的埋点录入,埋点参数与按需录入的参数一致,可参见按需录入文档。

    录入之后即同步到埋点检索列表。

后续步骤

埋点录入完成后,您需:

  1. 进行埋点验证,详情请参见数据验证
  2. 上线需求,详情请参见创建并管理需求

检索埋点

您可以通过搜索框或配置筛选条件来检索已创建的埋点,或勾选只看我负责的来过滤查看我负责的埋点。
Image

查看并修改埋点

查看埋点详情

在埋点检索页检索到埋点后,单击埋点名称,进入埋点详情页面。
Image

新建/修改埋点属性

在埋点的基本信息页签,您可以查看基本信息并进行编辑修改。
Image

  • 在埋点的基本信息页面,您可以单击创建属性,为埋点增加新的属性。
    Image

    • 您可以直接在新建属性的下拉框中选择已创建的场景属性,将已创建的属性关联至埋点。
    • 也可以单击下方自定义属性引用属性模板的方式,为埋点创建并配置全新的属性,创建后,属性也会在属性列表中展示。
  • 您也可以修改、禁用、隐藏埋点已创建的属性,也可为埋点新增属性。启用、禁用与隐藏状态的差异如下。

    状态

    是否占用配额

    是否构建存储

    是否产品内可用

    是否计费

    是否支持导出数据到本地

    禁用

    启用

    隐藏

  • 您可以单击右上方的编辑按钮,修改埋点的标签等信息。

新建/修改埋点场景

在场景细分页签,您可以查看当前埋点已关联哪些场景,并可进行编辑修改。
Image

注意

  • 为埋点新增场景时,需先在配置管理页面创建好场景属性,且场景属性需为string类型。详情请参见配置管理
  1. 在场景细分页面,点击“新建场景”,指定“场景描述”和“场景标定条件”即可创建一个新场景。
    Image

    核心参数

    配置说明

    场景描述 & 场景标签

    场景的“场景描述”不能与已有场景相同。

    场景标定条件

    • 场景标定条件下拉框中可选的场景属性需满足以下要求:
      • 已在配置管理页面创建场景属性,且属性类型为string类型。
      • 场景属性创建完成后,已在埋点基本信息页面中通过新建属性按钮关联场景属性,且属性在埋点的基本信息中为启用状态。
    • 场景标定条件通过配置场景属性等于某个取值来区分场景。
      例如,page_from=long_video_detail_page用于分区“长视频详情页”的视频播放。埋点创建后会根据场景标定条件创建属性。比如,标定条件“page_from=long_video_detail_page”的场景则会创建“必传”且枚举值“long_video_detail_page”的场景属性。
    • 场景标定条件可以有多个,多个场景标定条件间是“且”的关系。
      例如,page_name=follow_pagebutton_name=submit
  2. 埋点或场景负责人,点击左侧“更多”和右侧“编辑”icon,可以编辑、复制、删除场景。场景标定条件修改后也会按新的条件生成属性。

    注意

    • 新增、编辑、删除场景属性时, 不同场景的属性可能不同,各个场景需要维护自己的属性列表。
    • 由标定条件生成的属性不允许编辑和删除,其余属性可以编辑和删除。场景属性的删除,不影响埋点基本信息中已启用的属性。

禁用、分析、批量操作埋点

Image

  • 您可以多选埋点后,单击批量操作,对埋点进行打标签、修改负责人等修改操作。
  • 对具体的埋点,您可单击后方禁用按钮,禁用埋点;单击分析按钮即可跳转至DataFinder分析工具页面,可使用埋点进行查询分析。