change readme

This commit is contained in:
minlingchao 2017-07-13 23:52:49 +08:00
parent 7bde77965a
commit 2c5e0d6a43

View File

@ -1,17 +1,12 @@
---
title: VueJs百度统计插件
date: 2017-07-13 23:10:31
tags:
- vue
- 百度统计
---
# vue-ba
> vuejs 百度统计埋点插件
>
> 参考项目https://github.com/raychenfj/vue-uweb
> 项目参考https://github.com/raychenfj/vue-uweb
## 项目地址
https://github.com/minlingchao1/vue-ba
## 1. 安装
@ -43,36 +38,53 @@ Vue.use(uweb,options)
```
#### options
<table><tr><td>参数</td><td>必须</td><td>默认</td><td>说明</td><td>备注</td></tr><tr><td>siteId</td><td></td><td></td><td>绑定要接受API请求的统计代码</td><td></td></tr><tr><td> debug </td><td></td><td>false</td><td>调试模式下将在控制台中输出调用window._hmt时传递的参数</td><td>请不要在生产环境中使用,避免造成安全隐患</td></tr><tr><td> src </td><td></td><td>https://hm.baidu.com/hm.js?SITEID</td><td>指定统计脚本标签的 src 属性</td><td></td></tr></table>
## 2. ba API
### 2.1 trackEvent
用于发送页面上按钮等交互元素被触发时的事件统计请求。
#### 用法
```
this.$ba.trackEvent(category,action,opt_label,opt_value)
```
#### 参数
<table><tr><td>参数</td><td>必须</td><td>类型</td><td>说明</td></tr><tr><td> category </td><td></td><td> string </td><td>表示事件发生在谁身上</td></tr>
<tr><td> action </td><td></td><td> string </td><td>表示访客跟元素交互的行为动作</td></tr><tr><td> opt_label </td><td></td><td> string </td><td>用于更详细的描述事件</td></tr><tr><td> opt_value </td><td></td><td> int </td><td>用于填写打分型事件的分值加载时间型事件的时长如果填写为其他形式系统将按0处理。若填写为浮点小数系统会自动取整去掉小数点。</td></tr></table>
### 2.2 trackPageview
用于发送某个URL的PV统计请求适用于统计AJAX、异步加载页面友情链接下载链接的流量
#### 用法
```
this.$ba.trackPageview(pageURL)
```
#### 参数
<table><tr><td>参数</td><td>必须</td><td>类型</td><td>说明</td></tr><tr><td>pageURL </td><td></td><td> string </td><td>自定义虚拟PV页面的URL地址填写以斜杠/’开头的相对路径,系统会自动补全域名</td></tr></table>
## 3. ba 指令
vue-ba 提供 track-eventtrack-pageview 两个指令,开发者可以直接在 html 模版中使用来统计网站数据
### 3.1 track-event
使用指令 v-track-event 监听事件, 通过 modifiers 指定事件类型,将自动为绑定元素添加事件监听,当事件触发调用统计代码。 如不指定事件,默认监听 click 事件。
可通过逗号分隔的字符串或对象字面量传递参数以字符串传递时请注意参数顺序可参考trackEvent API。
#### 用法
```
<button v-track-event.click="'category, action''"></button> // 统计click事件
@ -86,6 +98,7 @@ vue-ba 提供 track-eventtrack-pageview 两个指令,开发者可以直接
```
### 3.2 track-pageview
使用指令 track-pageview 统计虚拟 PV ,一般可以配合 v-show 或 v-if 来统计局部动态视图的 PV。
可通过逗号分隔的字符串或对象字面量传递参数以字符串传递时请注意参数顺序可参考trackPageview API