// src/auto/home/index.tsx const Index = () => { usePv({ getExtra: () => { const params = Taro.getCurrentInstance().router?.params; return { params }; }, }); return <View>自动埋点页面</View>; });
(2)这里每个页面组件,都要用 WrapPage 包裹一下,对业务还是有侵入型了,原生小程序可以改写 Page,在 Page 中直接 usePv()。Taro 项目应该也可以这么做,实现 0 业务侵入吧?
Taro 项目中,确实可以也可以和原生小程序一样,在 App 中统一拦截原生 Page,但这样的话,上面「某些页面要计算额外参数并上报」就不好解决了。
微信小程序中,存在两种分享:
分享给好友:useShareAppMessage。
分享到朋友圈:useShareTimeline。小程序基础库 v2.11.3 开始支持,目前只在 Android 平台可用。
具体实现
以 useShareAppMessage 为例(useShareTimeline 同理):
(1)仍在 trackingConf.ts 统一配置文件中,增加分享埋点的标识字段 eleSn (及额外参数)
// trackingConf.ts export default { "auto/home/index": { pageSn: 11111, shareMessage: { eleSn: 2222, destination: 0 }, // 增加 shareMessage 包含分享好友的 eleSn、业务额外参数 destination } };
(2)封装 useShareAppMessage 方法,业务调用 Taro.useShareAppMessage 的地方全局替换为这个 useShareAppMessage。
// 分享给好友,统一埋点 export const useShareAppMessage = ( callback: (payload: ShareAppMessageObject) => ShareAppMessageReturn ) => { let newCallback = (payload: ShareAppMessageObject) => { const result = callback(payload) const currentPath = getPath(); // getPath 获取当前页面路径,可参考「1、页面曝光(pv)」中的 getPath // 从 trackingConf 中获取 pageSn、shareMessage 等 const { pageSn, shareMessage } = trackingConf[currentPath] const { eleSn, ...extra } = shareMessage || {} let page_el_sn = eleSn const { imageUrl: image_url, path: share_url } = result const { from: from_ele } = payload const reportInfo = { from_ele, share_to: 'friend', // 'friend' 表示分享给好友 image_url, share_url, ...extra } console.log('...useShareAppMessage tracking', { pageSn, page_el_sn, reportInfo }) sendImpr(pageSn, page_el_sn, reportInfo) // 可自行封装 sendImpr 方法,发送分享埋点信息 return result } Taro.useShareAppMessage(newCallback) }
这样,如果有个页面需增加分享好友的埋点,直接在 trackingConf.ts 中增加 shareMessage 的 eleSn 即可,useShareTimeline 同理。
提问环节
好奇宝宝们可能要问了:页面需要增加分享好友/朋友圈的埋点,可否 0 配置(即不用修改上述的 trackingConf.ts 文件)?
与前文中「pv 全自动埋点」类似,只要和产品约定好捞数据的方式也可以,比如笔者和产品约定了:
每个页面分享好友/朋友圈,eleSn 都是 444444,然后产品通过 pageSn 判断是哪个页面,通过 share_to 判断是分享好友 / 朋友圈,对于分享好友的场景,再通过 from_ele 判断通过右上角分享还是点击页面中的按钮分享。
这样页面分享也可以全自动埋点了。
元素自动埋点的调研遇到阻力,尚未落地。下文主要谈不同思路遇到的问题,有好的建议欢迎评论区沟通。
我们元素埋点,较高频的有曝光、点击事件,中低频的有滚动、悬停等事件。
手动埋点的方式就是在元素指定事件触发的时候,手动执行 sendImpr 上报埋点(带上页面唯一标识符 pageSn、 元素唯一标识符 eleSn)。
那这个环节是否可以省事一些呢?对业务无侵入,大概的做法还是:
在 Component 指定事件触发增加个 hook -> 判断是否要上报埋点 -> 满足条件则上报
问题一分为二:
(1)拦截元素事件回调
可以拦截并遍历小程序 Component 接收到的 options.methods,如果是一个自定义函数,则在函数被调用的时候判断第一个参数(假设命名为 e)的 type 是否等于 tap 等事件。这时候可以根据 e 等信息决定是否满足埋点上报条件了。
原生小程序中的实现,大致如下:
// App.js App({ onLaunch() { let old = Component Component = function(config) { // 拦截业务传入的 config const newConf = proxyConfig(config) old(newConf) } } }) const proxyConfig = function(conf) { const methods = conf.methods // 获取自定义方法(按需排除一些不埋点的方法) let diyMethods = Object.entries(methods).filter(function (method) { let methodName = method[0] return ![ "onLoad", "onShow", "onReady", "onHide", "onUnload", "onPullDownRefresh", "onReachBottom", "onPageScroll", "onShareAppMessage", "onResize", "onTabItemTap", "observer", ].includes(methodName); }) diyMethods.forEach(function(method) { const [methodName, methodFn] = method // 修改 conf 中的 methods methods[methodName] = function (...args) { const e = args && args[0] if (e && e.type === 'tap') { console.log('...tapping', methodName, args) // 触发点击事件的时候,按需上报埋点 } methodFn.call(this,...args) } }); // 返回修改后的 conf return conf }
Taro 项目中,不能直接在组件代码里用 Component,但可以迂回一些的方式实现相同目的,比如: