mina-analyse

小程序 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/? 后