帮助中心 > 技术文档 > 客户端SDK > Web Js SDK > 插件集成

1.插件介绍

为了扩展原有Web SDK的功能, 采用了注入插件化的架构方式,方便用户按需使用扩展功能,现有的插件列表如下:

插件名称 插件描述 SDK是否内置
PageLeave 页面浏览时长 内置
PageLoad 页面加载时长 内置

2.通用插件使用

使用内置的插件,需要手动调用use方法,传入插件方法和对应选项配置,例如使用内置的PageLeave插件

// option为该插件的选项配置
hina.use('PageLeave', option)

3.插件详情介绍

3.1 PageLeave页面浏览时长

页面浏览时长用于反映用户在某些页面上浏览时间的长短

hina.use('PageLeave',{
  custom_props:{
    leaveProp:'leaveValue'
  },
  heartbeat_interval_time: 5,
  max_duration: 5 * 24 * 60 * 60,
  isCollectUrl: function(url){
    // url 为要采集页面浏览时长的页面地址。
    return true; // 返回true为采集,false为不采集
  }
});

参数:

  • custom_props:页面浏览时长自定义属性,非必选
  • heartbeat_interval_time:心跳记录刷新时间,默认5s,非必选。
  • max_duration:最大页面浏览时长, 默认432000s (5天) ,非必选。
  • isCollectUrl:设置是否采集当前页面浏览时长, 返回 true 为需要采集,返回 false 或者不返回则为不采集,非必选。

3.2 PageLoad页面加载时长

页面加载时长用来衡量网站性能,对于用户体验留存有重要作用

hina.use('PageLoad',{max_duration:120});

参数:

  • max_duration:最大页面加载时长,超过这个时长将不再上报event_duration属性,默认1800s(30分钟), 非必选