上报方式

产生自定义事件的方式有两种

通过探针自定义事件配置与DOM自定义属性

该方式通过在DOM标签上增加自定义属性的方式,将点击事件替换为指定的事件名称,并可追加指定的事件内容,实现事件名称与内容的自定义

这三个配置项为

  • log_event_attribute:定义可在DOM标签上设置的用于替换事件名称的属性名,默认值为"data-event"
  • log_content_attribute:定义可在DOM标签上设置的用于追加事件内容的属性名,默认值为"data-log"
  • log_module_attribute:定义可以在DOM标签上设置的用于追加事件所属模块的属性名,默认值为"data-module"

对于以下DOM结构而言

<div id="page-container" data-module="内部所有触发的点击事件均属于这个模块">
  <!--此处省略复杂结构-->
  <button class="btn" data-event="点击该按钮时事件名被替换" data-log="被追加为事件内容的部分">
    <i class="btn-icon iconfont-add"></i>
    <span class="btn-text">提交</span>
  </button>
  <!--此处省略复杂结构-->
</div>

在点击按钮后,产生的日志为

{
  ...otherData,
  e: '点击该按钮时事件名被替换',
  l: '被追加为事件内容的部分',
  m: '内部所有触发的点击事件均属于这个模块'
}

该方式产生的日志本质上仍然是点击事件,如果需要上报的日志不是通过点击触发时,则需要调用report接口方法进行上报

通过探针API——report上报

该方式可以通过探针实例的report接口方法自主上报自定义的事件名称与内容,仅推荐无法通过点击事件触发的自定义事件使用该方式进行上报

fetch('/api/data').then((res) => {
  /* 处理业务数据的相关代码 */
}).catch((error) => {
  __myWebLogTracker__.report('获取数据接口调用失败', error, '数据分析');
});

该条日志为

{
  ...otherData,
  e: '获取数据接口调用失败',
  l: error,
  m: '数据分析'
}

数据查看

想要查看上报的自定义事件数据可以通过以下两种方式

在查询工具中查看实时数据

入口:分析工具 -> 查询工具

查询语句中增加 e = '事件名称' 即可筛选出特定的自定义事件日志

在自定义事件中查看离线数据

入口:用户行为 -> 自定义事件

每一条日志追加的日志内容可点击列表详情 - Log页签进行查看

results matching ""

    No results matching ""