在小程序后台,微信已经提供了强大的数据分析功能,包括实时统计、访问分析、来源分析和用户画像功能,可以说对一般的数据分析已经完全足够了,但有时应用需要做一些更加精准的数据分析,比如具体到某一个页面的分享,页面中某一个button的点击等,这时候就需要用到自定义分析功能。
引用下官方文档:
自定义分析支持灵活多维和近实时的用户行为分析,可以通过自定义上报,对用户在小程序内的行为做精细化跟踪,满足页面访问等标准统计以外的个性化分析需求。
事件英文名称和事件中文名称按照说明要求填写,这两个名称都是唯一的,不能设置成已经设置过的,而且设置的时候尽量简洁、还要见名知意
配置方式有:填写配置、API上报。
配置模版:官方已经提供了一些自定义事件模版,直接使用就可以,包括有:进入页面、离开页面、小程序内分享,不过这些事件的分析粒度都比较粗,针对整个应用,可以自己修改只针对某一页
填写配置的方式支持以下几种统计触发器,有:
click 点击时触发
enterPage 进入页面时触发,包括新开、后退、切换到前台都属于进入页面
leavePage 离开页面时触发,包括离开、切换到后台都属于离开页面
pageLoad 新开页面时触发,即第一次进入页面
pageUnload 回收页面时触发
pullDownRefresh 下拉刷新时触发
launch 加载小程序时触发
background 切换到后台触发
foreground 切换到前台触发
share 右上角菜单分享
switchTab 调用switchTab接口切换页面时触发
action指出发时的动作,一次性上报,表示在每一次 click 中,收集数据并上报一条数据;分步骤上报我也还没搞懂
page指要触发该事件的页面,这里填写的内容必须要和app.json
中配置的页面路径一样
data是选填的,是用来给事件触发时传递一些数据的,其中,字段值就是当前page的data
中的数据名称
举个例子
电商类小程序中,用户会有一个点击商品添加到购物车的动作,我们可以对这个动作进行数据分析,以下是填写配置
的方式:
这个例子中,用一个动作上报“加入购物车”事件。
trigger:触发条件,click,表示点击操作触发;
action:触发时动作,一次性上报,表示在每一次 click 中,收集数据并上报一条数据;
page:触发页面,填 viewProduct(viewProduct 是商品详情页);
element:触发元素,填 .addToCart(.addToCart 是一个“加入购物车”的按钮);
data:事件的数据及其来源,用“字段名 字段值”来表示,其中字段值是页面上的一个变量。
详细说一下字段值,他有如下规则:
填写的变量名,默认从page实例的data字段中获取
若想收集由list变量渲染的列表中的某一项数据,则可用list[].*表示,这里会根据当前填写的element(只能是class)得到的NodeList的第几个来决定数组下标。
若列表是二维的,则可用list[].*表示,这里element需填写两个class(空格隔开)分别表示父列表与子列表。
若想取得数组的下标,则可用list[].$INDEX表示
若想取得wxml中data-系列属性的值,则可用$DATASET.表示
若想取得app实例的数据,则可用$APP.*表示,只支持获取基本类型的数据,如number、string、boolean。
除此之外,还可以填写一些提供的系统属性,以“$”开头,目前支持以下属性:
$PAGE_TIME
用户从进入本页面到当前的时间(触发action的时间点)
$APP_TIME
用户进入小程序到当前的时间(触发action的时间点)
$CURRENT_PAGE
当前用户所在的页面
$LAST_PAGE
上一页
注:data可以为空,为空时该事件上报仅收集系统默认字段的数据
这个例子中,data有四项:
product_id: itemID
product_name: itemName
product_price: price
product_category: category
即:
事件的product_id字段,收集viewProduct页面上page实例的data中的itemID字段;
事件的product_name字段,收集viewProduct页面上page实例的data中的itemName字段;
事件的product_price字段,收集viewProduct页面上page实例的data中的price字段;
事件的product_category字段,收集viewProduct页面上page实例的data中的category字段;
以上内容表示:当用户点击 viewProduct 页面上的 .addToCart 按钮时,上报一条记录到 add_to_cart 事件,事件的 product_id, product_name, product_price, product_category 字段, 取值分别是页面上的 itemID, itemName, price, category。
填写完配置后,还要点击检查字段
。
此时会提示 add_to_cart 事件包含的具体字段,继续补充字段的名称、数据类型和备注信息。
关于API上报
API上报比填写配置的方式更加灵活,但这也涉及到一些代码的更改,需要发布新版本,而填写配置的方式几乎不需要更改代码,所以无需发布新版本。当我们选择API上报
后,我们可以设置需要上报的一下参数:
点击生成代码:
事件创建完成后,点击保存,后台就生成了一条事件记录,并有唯一的ID与它对应:
接着,我们在小程序代码中可以插入生成的代码,如下是我在转发成功后的success()
回掉函数中提交API上报。
...
// 转发成功
success: function (res) {
wx.reportAnalytics('click_share', {
page_path: current_page_path,
from: from,
});
},
...
不管是填写配置还是API上报,都需要在填写完配置后保存并测试。
我们在测试事件的时候,往往要过一段时间才能接收到数据,大概1-2分钟,为了能够及时判断正确性,我们可以在手机上的小程序应用中,打开调试,这样,每次触发事件时,都会在控制台的Log中看到[自定义分析]上报成功的字样
,点击查看还能看到更多数据,比如上报的参数等,里面的eventID
就对应事件的英文名称,可以通过这种方式快速判断事件触发是否符合预期,如下截图:
远程调试
通过使用,我们发现小程序的自定义分析功能很强大,你可以在页面上分析任何元素、任何事件,使我们可以全方位的了解到小程序的使用情况,对数据加以分析总结,并以数据来驱动产品的迭代,提高用户留存。
参考:小程序官方文档 https://developers.weixin.qq.com/miniprogram/analysis/custom