小程序 GA 打点
安装
从 npm 安装
npm i mina-analyse --save
import * as MinaAnalyse from 'mina-analyse'
直接引入
复制仓库中的 dist/index.js
文件,保存到小程序项目中
var MinaAnalyse = require('path/to/mina-analyse.js')
使用
注意: mina-analyse
需要在小程序入口文件(app.js)的最前面进行引入
import * as MinaAnalyse from 'mina-analyse'
// 初始化配置
MinaAnalyse.init({
name: <String>, // app name
id: <String>, // UA-xxx-x
version: <String>, // app version
proxy: <String?>, // ga proxy, 需要在小程序后台进行 request 域名配置
enableScreenView: <Boolean|Function(route: String)?> // 默认值 false,是否在 `Page.onShow` 时自动进行 screenview 打点
})
// 返回跟踪器 https://github.com/rchunping/wxapp-google-analytics#%E8%B7%9F%E8%B8%AA%E5%99%A8-tracker
const tracker = MinaAnalyse.getTracker();
// 设置 uid
MinaAnalyse.setUid('uid')
// Page View 打点,当启用 `enableScreenView` 配置时程序会自动调用。设置 `enableScreenView` 为函数,根据返回值(true|false)细粒度的控制自动调用逻辑
MinaAnalyse.screenView({
// 附加到页面当前路径 `cd` 中的额外参数
params: {
id: 'nocode'
},
// 自定义维度
dimensions: ['维度1', '维度2']
})
// Page event 打点, 第三个参数控制是否调用 `wx.reportAnalytics` 向微信发送打点
MinaAnalyse.report('event_name', {
labelA: 'nocode',
labelB: 'tech'
}, false)
相关文档
- 打点规范:GA 打点规范
- 集成方案:微信小程序 GA 方案
- 小程序场景 scene 值列表:小程序场景值列表
打点参数
GA 打点部分参数列表
name | 参数名称 | 参数释义 | 可选 | 备注 |
---|---|---|---|---|
t | 打点类型 | 必须为:pageview、screenview、event、transaction、item、social、exception、timing 之一 | 必选 | 重要字段,自定义,用于统计 PV,事件数量,PV→ACTION 转化率 |
cd | 页面路径 | 小程序客户端打点中的页面路径参数 | 必选 | 重要字段,自定义,相当于 web 页面中的 URL |
referer | 来源 | 当前页面的来源页面或渠道,SDK 额外参数,抽奖助手自定义,填充值规则参见规则定义 | 必选 | 重要字段,自定义,相当于 web 页面中的 referer |
cm | 来源场景 | 打开小程序的来源场景值,小程序专属字段 scene | 必选 | 重要字段,获取系统默认值,小程序场景值列表 |
ec | 事件类别 | t=event 时的有效参数,表示事件的类别 | 必选 | 重要字段,自定义,一般用作自定义事件名称,供多维度分析聚合 |
el | 事件标签 | t=event 时的有效参数,表示事件的标注 | 可选 | 重要字段,自定义,一般记录事件附带的参数值,供分析时筛 |
uid | 用户 ID | 为应用中自定义的用户 ID 标示,一般为用户登录系统后返回的 user_id | 可选 | 重要字段,与 cid 中至少一个有值,用于用户唯一标示 |
部分参数详情
name | 参数名称 | 参数值定义规范 | 使用场景说明 |
---|---|---|---|
referer | 页面来源 | 分应用内来源及应用外来源 | 1.应用内:上一个页面的页面路 2.应用外:(xxxxx 由运营同学指定给到渠道方,建议仅包含小写字母及数字) 2-1.有应用落地页(如含参二维码、小程序路径等),值格式为:page_path/?f=xxxxx ; 2-2.无应用落地页,值格式为:external_channel/?f=xxxxx ,如无指定渠道,可将来源场景 scene、小程序 ID 等值按照 k1=v1&k2=v2 的形式追加在 external_channel/? 后 |