vue-uweb

vuejs 友盟统计埋点插件

1. 安装

npm install vue-uweb --save

直接在页面中引用

<script src="./node_modules/vue-uweb/dist/vue-uweb.min.js"><script>

或通过es6模块加载

import uweb from 'vue-uweb'

使用 vue-uweb 插件

Vue.use(uweb,'YOUR_SITEID_HERE')

通过传递 options 参数进行更多设置

Vue.use(uweb,options)

options

2. uweb API

查看官方文档

注意: 所有 this 均为 Vue 实例

2.1 ready

当需要严格控制加载时序时，可使用 ready 方法。该方法返回一个 promise，当外部统计脚本加载完毕，全局 _czc 对象存在时，promise 被 resolve。

用法

this.$uweb.ready().then(() => {
  ...
}).catch(() => {
  ... // error handling here
})

// 使用 async await, 建议使用 try/catch 避免加载失败影响主程序
async SOME_METHOD () {
  try {
    await this.$uweb.ready()
    ...
  } catch (e){
    ... // error handling here
  }
}

2.2 trackPageview

用于发送某个URL的PV统计请求，适用于统计AJAX、异步加载页面，友情链接，下载链接的流量。

用法

this.$uweb.trackPageview(content_url[, referer_url])

参数

2.3 trackEvent

用于发送页面上按钮等交互元素被触发时的事件统计请求。如视频的“播放、暂停、调整音量”，页面上的“返回顶部”、“赞”、“收藏”等。也可用于发送Flash事件统计请求。

用法

this.$uweb.trackEvent(category, action[, label, value, nodeid])

参数

2.4 setCustomVar

用于发送为访客打自定义标记的请求，用来统计会员访客、登录访客、不同来源访客的浏览数据。

用法

this.$uweb.setCustomVar(name, value[, time])

参数

2.5 setAccount

当您的页面上添加了多个CNZZ统计代码时，需要用到本方法绑定需要哪个siteid对应的统计代码来接受API发送的请求。未绑定的siteid将忽略相关请求。

备注： 一般情况下无需调用该方法，只需调用 Vue.use 时直接传递 siteId 或通过 options.siteId 传递即可

用法

this.$uweb.setAccount(siteid)

参数

2.6 setAutoPageview

如果您使用_trackPageview改写了已有页面的URL，那么建议您在CNZZ的JS统计代码执行前先调用_setAutoPageview，将该页面的自动PV统计关闭，防止页面的流量被统计双倍。

备注： 在调用 Vue.use 时可通过 options.autoPageview 设置初始值，默认为 true

用法

this.$uweb.setAutoPageview(autopageview)

参数

2.7 deleteCustomVar

发送删除自定义访客标签的请求。将访客身上已被标记的自定义访客类型去掉，去掉后不再继续统计。

用法

his.$uweb.deleteCustomVar(name)

参数

3. uweb 指令

vue-uweb 提供 track-event，track-pageview 和 auto-pageview 三个指令，开发者可以直接在 html 模版中使用来统计网站数据

3.1 track-event

使用指令 v-track-event 监听事件， 通过 modifiers 指定事件类型，将自动为绑定元素添加事件监听，当事件触发调用统计代码。 如不指定事件，默认监听 click 事件。

可通过逗号分隔的字符串或对象字面量传递参数，以字符串传递时请注意参数顺序，可参考trackEvent API。

用法

<button v-track-event.click="'category, action''"></button> // 统计click事件

<button v-track-event="'category, action'"></button> // 统计click事件简写

<input v-track-event.keypress="'category, action'"> // 统计keypress事件

<button v-track-event="'category, action, label, value, nodeid'"><button> // 以字符串传递参数

<button v-track-event="{category:'event', action:'click'}"></button> // 以对象字面量传递参数

3.2 track-pageview

使用指令 track-pageview 统计虚拟 PV ，一般可以配合 v-show 或 v-if 来统计局部动态视图的 PV。

可通过逗号分隔的字符串或对象字面量传递参数，以字符串传递时请注意参数顺序，可参考trackPageview API。

用法

<div v-show="show" v-track-pageview="'/bar'">bar</div> //  跟踪 v-show 绑定元素的虚拟pv

<div v-if="show" v-track-pageview="'/foo'">foo</div> // 跟踪 v-if 绑定元素的虚拟pv

<div v-track-pageview="'/tar, https://github.com/raychenfj'"></div> // 以字符串指定受访页面和来源

<div v-track-pageview="{content_url:'/zoo', referer_url:'https://github.com/raychenfj'}"></div> // 以对象字面量指定受访页面和来源

3.3 auto-pageview

使用指令 auto-pageview 开关自动统计

用法

<div v-auto-pageview=true></div> // 启用 auto-pageview

<div v-auto-pageview=false></div> // 停止 auto-pageview

4. 默认参数和改变参数顺序

认情况下，vue-uweb 并不提供默认参数和参数顺序的设置，但开发者可以根据需求，使用装饰器模式，来提供默认参数和改变参数顺序。

例如：我们想在监听事件时默认category，只需要传递action，则代码如下

let trackEvent = uweb.trackEvent
uweb.trackEvent = (action, category='default') => {
  trackEvent.call(uweb, category, action, '', '', '')
}

Vue.use(uweb)