前言
最方便的方法,莫过于使用vue-analytics
:https://github.com/MatteoGabriele/vue-analytics。
包是有了,可是真正使用起来会发现Google Analytics
(下称GA
)可能没检测到或者出现漏统计的问题。本文的主题,就是讨论几个基本的检查点和说明下GA的基本用法,确保GA
正常工作。
本文分为以下几部分:
- 如何正确地初始化
GA
GA
基本用法:页面跟踪与事件跟踪- 如何检查
GA
是否正常工作 vue-cli
工程添加GA
的详细步骤- 推荐阅读材料
如何正确地初始化GA
必须按照Google
官方要求,将以下代码放到html
文件,并且应该放在</head>
之前:
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-XXX', 'auto'); // 将`UA-XXX`换成自己的ID
ga('send', 'pageview');
</script>
其他方式可以让GA代码运行起来,但是会引入一些问题。比如我们使用了vue的情况下,很自然地会想能不能直接在vue完成初始化,不想要去修改html。但是实测会出现2个问题。
-
第1个是GA的后台检测不到,类似如下的提示:
-
第2个是Google其他的产品,比如
Ad Words
,与GA
配合,也会要求GA代码放在</head>
之前才能工作。
综上,在初始化上目前只能老实按照Google
的方法。
GA基本用法:页面跟踪与事件跟踪
事件跟踪与事件跟踪是GA最基本最主要的用法。
页面跟踪
一般的网站,只需要在html
中加个GA的代码就能完成页面跟踪了,但是对于SPA
来说并不行,因为路由之间的跳转并没有刷新页面,GA感知不到,因此需要手动触发。在vue-cli
的工程中,可使用如下代码简单处理:
router.afterEach((to, from) => {
ga('set', 'page', to.path)
ga('send', 'pageview')
})
推荐使用vue-analytics
,按照官方指导处理,可省很多事,否则需要自己手动再处理首次进入重复计数和GA不存在等异常情况。
import Vue from 'vue'
import router from './router'
import VueAnalytics from 'vue-analytics'
Vue.use(VueAnalytics, {
id: 'UA-XXX-X',
router,
autoTracking: {
pageviewOnLoad: false
}
})
链接:https://github.com/MatteoGabriele/vue-analytics/blob/master/docs/page-tracking.md
事件跟踪
原生的代码是
ga.event('category', 'action', 'label', 123)
如果用vue-analytics则是:
this.$ga.event('category', 'action', 'label', 123)
链接:https://github.com/MatteoGabriele/vue-analytics/blob/master/docs/event-tracking.md
值得一提的是事件四个参数的设置:
- category: 一般为一个大类,比如品牌brand,视频video等等
- action: 一般为一个具体的操作,比如download, play, click等等
- label: 一般为额外的一些信息,比如具体的品牌ID,视频的title等等
- value: 任意的度量值,必须为正的整数,比如表示品牌的价值,视频的时长等等
如何检查GA是否正常工作?
通常来说,需要检查几个点以确认GA有正常工作:
- GA有正常初始化
- 页面加载时PageView有发出,并且只发了一次;
- 路由切换时PageView有发出,并且只发了一次;
- 事件可以正常发出;
要检查这几点,最方便的是使用Chrome的Tag Assistant插件。下面分步骤说明如何用该插件做检查。
1.下载Chrome插件:Tag Assistant(https://chrome.google.com/webstore/detail/tag-assistant-by-google/kejbdjndbnbjgmefkgdddjlbokphdefk)
2.如何检查初始化:点击下面的Record,然后刷新页面,然后即可看到当前加载的TAG。Google Analytics只是其中一种,其他还有像Remarketing Tag(再营销代码)等等,如下图所示,这里我们只关心Google Analytics。如果是绿色的表示正常,否则就要根据提示排查下问题。
3.如何检查PageView和Event:点击Goole Analytics
那个选项,可看到GA的详细信息。如果有发送PageView或者Event,在下面可看到统计。
3.1 Pageview的具体信息:如下图所示,发出了一个/login页面的PageView,如果有多个不同的PageView,点左右可一一切换。我一般使用这个面板确认是否页面加载后发出了多个相同的PageView,以及路由切换时是否有发出PageView。
3.2 event的具体信息:event的查看方法与pageview类似,就是内容变成event的category, action, label, value等信息而已。我主要用它来确认事件是否有发出以及参数是否正确。
vue-cli
的工程添加GA
代码的详细步骤
1.config/prod.env.js
,添加GA代码ID:
'use strict'
module.exports = {
NODE_ENV: '"production"',
GA: `"UA-113937480-1"`
}
2. build/webpack.prod.conf.js
找到HtmlWebpackPlugin
,最后添加了ga
选项:
new HtmlWebpackPlugin({
filename: process.env.NODE_ENV === 'testing'
? 'index.html'
: config.build.index,
template: 'index.html',
inject: true,
minify: {
removeComments: true,
collapseWhitespace: true,
removeAttributeQuotes: true
// more options:
// https://github.com/kangax/html-minifier#options-quick-reference
},
// necessary to consistently work with multiple chunks via CommonsChunkPlugin
chunksSortMode: 'dependency',
favicon: './static/bitbug_favicon.ico',
ga: env.GA // 添加ga选项,以便在index.html中可以引用
}),
3.index.html
,在</head>
之前添加,特别注意它的GA的ID是从配置中读取而不是写死的
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', <%= htmlWebpackPlugin.options.ga %>, 'auto');
ga('send', 'pageview');
</script>
4.src/main.js
引入vue-analytics
,参考源码
import App from './App'
import router from './router'
import VueAnalytics from 'vue-analytics'
// GA初始化
if (process.env.GA) {
Vue.use(VueAnalytics, {
id: process.env.GA, // 从配置中读取
disableScriptLoader: true, // 必须在html中完成初始化,这里显式禁止去下载ga脚本
router, // 确保路由切换时可以自动统计
autoTracking: {
pageviewOnLoad: false // 当通过网址进来时已经GA在初始化时就发起一次pageview的统计,这里不要重复统计
}
})
}