通过自定义 Vue 指令实现前端曝光埋点

news/2024/7/10 3:17:03 标签: 可视化, java, vue, 数据分析, js
js_content">

前言

互联网发展至今,数据的重要性已经不言而喻,尤其是在电商公司,数据的统计分析尤为重要,通过数据分析可以提升用户的购买体验,方便运营和产品调整销售策略等等。埋点就是网站分析的一种常用的数据采集方法。

埋点按照获取数据的方式一般可以分为以下 3 种:

  • 页面埋点:统计用户进入或离开页面的各种维度信息,如页面浏览次数(PV)、浏览页面人数(UV)、页面停留时间、浏览器信息等。

  • 点击埋点:统计用户在应用内的每一次点击事件,如新闻的浏览次数、文件下载的次数、推荐商品的命中次数等。

  • 曝光埋点:统计具体区域是否被用户浏览到,如活动的引流入口的显示、投放广告的显示等。

政采云前端团队(ZooTeam)通过浑仪系统实现数据采集及数据可视化,分析量化的能力,想了解浑仪系统或者还不了解埋点的同学可以先阅读 前端工程实践之数据埋点分析系统

浑仪系统的数据采集是基于代码侵入式埋点方案实现的,提供了自动发送和手动调用埋点信息上报接口发送两种方式实现埋点数据上报。其中页面埋点点击埋点是使用自动上报的方式实现,在 DOM 节点挂载特殊属性,通过埋点采集 JSSDK 监听挂载了相应属性对应的事件,在事件触发时进行埋点数据上报。曝光埋点由于涉及到有效曝光逻辑的判断,自动上报不能满足相应的需求,所以我们采用手动调用接口方式进行埋点数据上报。

有效曝光

先举个例子:

上图是某电商首页底部的推荐区域,为了衡量用户对推荐结果的感兴趣程度,需要计算推荐区域的点击率(点击次数/曝光次数)。为了保证点击率的准确性,我们必须确保用户真正的浏览到了这些商品,由于用户浏览商品的不确定性会发生相同商品的频繁曝光,我们还要避免重复的曝光行为。所以我们需要制定一套逻辑来规定何时进行曝光埋点的数据上报。比如:

  1. 商品卡片必须完全的出现在浏览器可视化区域内。

  2. 商品必须在可视化区域内停留 5s 以上。

  3. 用户进入页面到离开页面相同的商品只进行一次曝光。

满足以上规定的曝光就是一次有效曝光。了解了有效曝光后,我们来看看曝光埋点实现最重要的一环,如何判断元素出现在页面的可视化区域内。

判断元素出现在页面的可视化区域内

我们首先想到商品曝光类似于图片懒加载的形式,通过监听 scroll 事件,调用 Element.getBoundingClientRect() 方法以获取相关元素的边界信息,然后判断元素是否出现在页面的可视化区域内。由于 scroll 事件频发触发,计算量很大,所以很容易造成性能问题,虽然我们可以采用防抖节流等方式去解决。

目前有一个新的 InterpObserver API,提供了一种异步检测目标元素与祖先元素或 viewport(可视窗口)相交情况变化的方法。可以自动"观察"元素是否可见。

InterpObserver基本用法

let options = {
    root: document.querySelector('#scrollArea'),
    rootMargin: '0px',
    threshold: 1.0
}
let callback =(entries, observer) => {
  entries.forEach(entry => {});
};
let observer = new InterpObserver(callback, options);

InterpObserver 是浏览器原生提供的构造函数,接受两个参数:callback 是可见性变化时的回调函数,option 是配置对象(该参数可选),返回一个 observer 实例。我们可以看到,创建一个 InterpObserver 对象,接受两个参数:callback 可见性变化时的回调函数,该回调函数将会在目标(target)元素和根(root)元素的交集大小超过阈值(threshold)规定的大小时候被执行。

options 是配置对象,它有以下字段:

  • root:指定根 (root) 元素,用于检查目标的可见性。必须是目标元素的父级元素。如果未指定或者为 null,则默认为浏览器视窗。

  • rootMargin:根 (root) 元素的外边距。类似于 CSS 中的 margin 属性。默认值为 0。

  • threshold:target 元素和 root 元素相交程度达到该值的时候 callback 函数将会被执行,可以是单一的Number 也可以是 Number 数组,当为数组时每达到该值都会执行 callback 函数。

我们通过实例的方法可以指定观察哪个 DOM 节点。实例的方法有:

  • InterpObserver.observe():使 InterpObserver 开始监听一个目标元素。

  • InterpObserver.disconnect():使 InterpObserver 对象停止监听工作。

  • InterpObserver.takeRecords():返回所有观察目标的 InterpObserverEntry 对象数组。

  • InterpObserver.unobserve():使 InterpObserver 停止监听特定目标元素。

InterpObserverEntry 对象提供目标元素的信息,一共有七个属性:

  • InterpObserverEntry.target :需要观察的目标元素,是一个 DOM 节点对象 。

  • InterpObserverEntry.boundingClientRect:返回包含目标元素的边界信息。边界的计算方式与 Element.getBoundingClientRect() 相同。

  • InterpObserverEntry.interpRect :用来描述根和目标元素的相交区域的信息。

  • InterpObserverEntry.interpRatio:返回 interpRect 与 boundingClientRect 的比例值,0 为完全不可见,1 为完全可见。

  • InterpObserverEntry.isIntersecting:返回一个布尔值, 如果根与目标元素相交(即从不可视状态变为可视状态),则返回 true。如果返回 false,变换是从可视状态到不可视状态。

  • InterpObserverEntry.rootBounds :根元素的区域的信息。

  • InterpObserverEntry.time:可见性状态发生改变时间的时间戳,单位为毫秒。

目标元素的可见性变化时,就会调用观察器的回调函数 callbackcallback函数的参数 entries 是一个数组,每个成员都是一个 InterpObserverEntry 对象,observer 是被调用的 InterpObserver 实例。callback 函数一般会被调用两次,一次是目标元素进入可视化区域,另一次是离开可视化区域。配置 options.threshold 会影响 callback 函数的调用次数。

我们再来看看 Interp Observer API 的浏览器兼容情况

我们看到是存在兼容性问题的,好在已经有了兼容的 polyfill (https://github.com/w3c/InterpObserver/tree/master/polyfill)。当前浏览器不支持 Interp Observer API 时,使用 Element.getBoundingClientRect() 去实现 Interp Observer API。

具体实现

了解了 Interp Observer 的基本用法了以后,下面我们来实现前端的曝光埋点。因为业务是基于 Vue 实现的,所以我们通过自定义 Vue 指令实现前端的曝光埋点。

首先我们自定义一个 visually 指令,当指令第一次绑定在元素上时使用 InterpObserver 监听目标元素,当指令从元素上解绑时停止监听目标元素。

const options = {
    root: null, //默认浏览器视窗
    threshold: 1 //元素完全出现在浏览器视窗内才执行callback函数。
}
const callback =(entries, observer) => {
  entries.forEach(entry => {});
};
const observer = new InterpObserver(callback, options);
const addListenner = (ele, binding) => {
 observer.observe(ele);
};
const removeListener = (ele) => {
  observer.unobserve(ele);
};
//自定义曝光指令
Vue.directive('visually', {
  bind: addListenner,
  unbind: removeListener,
});

我们需要一个 List 将已经上报过的埋点信息记录下来,防止重复曝光。

let visuallyList = []; //记录已经上报过的埋点信息
const addListenner = (ele, binding) => {
 if(visuallyList.indexOf(binding.value) !== -1) return;
 
 observer.observe(ele);
};

我们将要上报的信息绑定在目标元素的 'visually-data' 属性中,当目标元素出现在视窗内时,并停留 5 秒以上时,我们上报埋点信息。

let timer = {}; //增加定时器对象
const callback = entries => {
  entries.forEach(entry => {
    let visuallyData = null;
    try {
      visuallyData = JSON.parse(entry.target.getAttribute('visually-data'));
    } catch (e) {
      visuallyData = null;
      console.error('埋点数据格式异常', e);
    }
    //没有埋点数据取消上报
    if (!visuallyData) {
      observer.unobserve(entry.target);
      return;
    }
    
    if (entry.isIntersecting) {
      timer[visuallyData.id] = setTimeout(function() {
        //上报埋点信息
        sendUtm(visuallyData).then(res => {
          if (res.success) {
            //上报成功后取消监听
            observer.unobserve(entry.target);
            visuallyList.push(visuallyData.id);
            timer[visuallyData.id] = null;
          }
        });
      }, 5000);
  } else {
    if (timer[visuallyData.id]) {
      clearTimeout(timer[visuallyData.id]);
      timer[visuallyData.id] = null;
    }
  }
  });
};

最后我们引入 polyfill 实现 IE 的兼容,封装一个全局指令。

require('interp-observer');
export default Vue => {
 ...
  //自定义曝光指令
  Vue.directive('visually', {
    bind: addListenner,
    unbind: removeListener,
  });
};

我们通过 Vue.use() 引入组件后,就可以在业务代码中直接通过指令实现曝光埋点。曝光数据 visuallyData 中必须要有一个唯一 ID。

<div v-visually="visuallyData.id" :visually-data="JSON.stringify(visuallyData)" class="browse"></div>

总结

埋点是数据分析的基础,埋点数据统计的准确性对后续的数据分析非常重要,所以我们在统计曝光埋点的时候一定要基于适用场景优先制定曝光埋点的规则。本文只是针对前端曝光埋点的实现方案,如有问题处,请大佬们多多交流。


http://www.niftyadmin.cn/n/1251504.html

相关文章

女生到底还做java还是前端_女孩子想转行的话学前端好还是java,哪个更有发展?...

前端开发的前景好&#xff0c;现在都是全栈前端&#xff0c;简称HTML5大前端&#xff0c;HTML5技术日趋成熟&#xff0c;HTML5是移动互联网前端的主流开发语言&#xff0c;目前还没有任何一种前端开发技术能够取代它。因此&#xff0c;无论是PC端还是APP端的应用&#xff0c;前…

入职微软一个月感悟:微软其实并没有想象的那么轻松

本文是云峰入职微软一月后的感悟&#xff0c;谈及了他的面经以及入职体验。前言提到微软&#xff0c;你首先会想到什么&#xff1f;外企&#xff1f;Windows Or Office&#xff1f;还是 955WLB&#xff1f;我在前司待了快三年&#xff0c;自觉到了一个打工人的黄金跳槽点&#…

java 铁路管理信息系统_java多线程之铁路售票系统

本文实例为大家分享了java多线程之铁路售票系统的具体代码&#xff0c;供大家参考&#xff0c;具体内容如下问题&#xff1a;铁路售票&#xff0c;一共100张&#xff0c;通过四个窗口卖完。要求&#xff1a;分别用继承Thread类 和 实现Runnable接口 去实现①用继承Thread类去实…

从 setState 聊到 React 性能优化

作者&#xff1a;风不识途https://segmentfault.com/a/1190000039776687setState的同步和异步1.为什么使用setState开发中我们并不能直接通过修改 state 的值来让界面发生更新&#xff1a;因为我们修改了 state 之后, 希望 React 根据最新的 Stete 来重新渲染界面, 但是这种方式…

java 懒加载设置_Spring集成JPA配置懒加载报错解决方案

一&#xff1a;报错no session因为entitymanager对象在事物提交后就关闭了 报错的 no session相当于sql的session解决办法&#xff1a;解决办法 在web.xmL配置一个过滤器 使其在这个session中的manager在结束后再关闭openopenEntityorg.springframework.orm.jpa.support.OpenEn…

原以为很简单,结果这道 Promise 面试题让我失眠好一会

先把罪魁祸首挂在这里给大家群殴 ????Promise.resolve().then(() > {console.log(0);return Promise.resolve(4); }).then((res) > {console.log(res) })Promise.resolve().then(() > {console.log(1); }).then(() > {console.log(2); }).then(() > {consol…

安卓java绘制视图_java – 在视图上绘制一个圆圈(android)

几点意见&#xff1a;在确定圆的中心点和半径时,您需要考虑分配给视图的宽度和高度.您应该考虑分配给视图的填充,这样就不会绘制该保留部分.你应该避免在onDraw方法中分配对象,因为这会被调用很多.为了允许在XML布局中指定视图,您需要提供带有Context和AttributeSet的构造函数.…

python中__name__怎么用_Python中__name__的使用实例

1. 如果模块是被导入&#xff0c;__name__的值为模块名字2. 如果模块是被直接执行&#xff0c;__name__的值为__main__Py1.py复制代码代码如下:#&#xff01;/usr/bin/env pythondef test():print __name__ ,__name__if __name__ __main__:test()Py2.py复制代码代码如下:#&am…