通过分享小程序路径增加参数,跟踪分享链条,以便给与分享者奖励,达到迅速裂变
核心接口: wx.showShareMenu 生成分享票据shareticket, 可以判断用户分享给好友还是群;
onShareAppMessage 生命周期函数,可以通过判断回调函数返回值可以知道通过按钮还是页面的转发分享;path参数中增加分享者openid,可以跟踪分享源和接收者
wx.getShareInfo 接口可以获得分享的群信息
核心代码:
实例
onLoad: function (e) { // console.log(e) //分享 wx.showShareMenu({ withShareTicket: true, success: function (res) { // 分享成功 console.log('share.js>>onLoad():showShareMenu'); console.log(res); }, fail: function (res) { // 分享失败 console.log(res) } }); //点击分享的面板进入的小程序 if (e && e.userShare) { console.log("加载e对象"); console.log(e); console.log("加载e对象中userShare"); console.log(e.userShare); //转化json为对象 let userShare = JSON.parse(e.userShare); console.log("对象中userShare.openId"); console.log(userShare.openId); console.log("对象中userShare"); console.log(userShare.nickName); } }, onShareAppMessage: function (res) { var vm = this; if (res.from === 'button') { console.log("onShareAppMessage()==>>来自页面内转发按钮"); console.log(res.target); } else { console.log("onShareAppMessage()==>>来自右上角转发菜单") } //自定义信息 let sendinfo = { openId: "111", //分享人的openId nickName: "艾弗森", //分享人的昵称 } let str = JSON.stringify(sendinfo); return { title: sendinfo.nickName + '分享了小程序"Allen Iverson"', path: 'pages/index/index?userShare=' + str, // imageUrl: "../../../images/code-db-onAdd.png", success: function (res) { console.log("分享success()"); console.log("onShareAppMessage()==>>转发成功", res); //分享的是群还是个人 app.setInfo(res); }, fail: (res) => { console.log("onShareAppMessage()==>>转发失败", res); } } } //接口:分享群或者个人 setInfo: function (res1) { var vm = this; wx.getSystemInfo({ //获取设备信息 success: function (d) { console.log("获取设备信息"); console.log(d); //判断用户手机是IOS还是Android if (d.platform == 'android') { wx.getShareInfo({ //获取群详细信息 shareTicket: res1.shareTickets, success: function (res) { //这里写你分享到群之后要做的事情,比如增加次数什么的 //查询群的信息 console.log("getShareInfo()>>android>>"); console.log(res.encryptedData); console.log(res.iv); wx.showModal({ title: '提示', content: '分享群成功', success: function (res) { if (res.confirm) { console.log('用户点击确定') } else if (res.cancel) { console.log('用户点击取消') } } }) }, fail: function (res) { //这个方法就是分享到的是好友,给一个提示 wx.showModal({ title: '提示', content: '分享好友成功', success: function (res) { if (res.confirm) { console.log('用户点击确定') } else if (res.cancel) { console.log('用户点击取消') } } }) } }) } if (d.platform == 'ios') { //如果用户的设备是IOS if (res.shareTickets != undefined) { console.log("分享的是群"); wx.getShareInfo({ shareTicket: res.shareTickets, success: function (res) { //分享到群之后你要做的事情 } }) } else { //分享到个人要做的事情,我给的是一个提示 console.log("分享的是个人"); wx.showModal({ title: '提示', content: '分享好友成功', success: function (res) { if (res.confirm) { console.log('用户点击确定') } else if (res.cancel) { console.log('用户点击取消') } } }) } } } }) },
接下来说一下,当一个用户打开别人分享的小程序,并接受授权或者已有授权的情况下,如何完成第二次、第三次上报,代码依旧在live.js中。
onLoad: function (options) {let _this = this; this.setData({ // 获取小程序url中的source,记录此小程序是谁分享的;也可能不存在source roomid: options.id,
source: options.source
}, function () { //... }) // 给全局添加回调函数,当用户没有已授权的状态,需要点击·授权·按钮后,此时执行回调函数
app.getInfoCb = function () { if (options.source) { // 第二次上报,如果有options.source,则记录谁分享的
_this.share_event_req(null, '2', options.source) // 第三次上报,如果有options.source,则记录谁分享的
setTimeout(() => {
_this.share_event_req(null, '3', options.source)
}, 30 * 1000)
}
} // 如果用户已授权状态,未删除小程序,直接执行
if (Store.getState().updateUid) {
app.getInfoCb()
}
}
小程序分享群及信息追踪
需求
页面分享
小程序页面分享链接增加source参数,值为用户ID加密,分享出去的链接类似/pages/live/live?id=10109&source=1ada812s
分享时自定义分享文案、链接、封面图
分享完成后获取分享信息,能获取到群ID算成功,做一次上报,记录该用户分享的信息
追踪
群用户打开分享的卡片后,获取链接中的source参数做一次上报,记录哪些用户打开小程序
用户在此页面观看30s之后再做一次上报
实现
页面分布:
live.js 小程序某页面
app.js 小程序首页
代码分析:
由于代码中有很多不相关的部分,所以分析的过程中,尽可能的省略掉不相关的代码部分,以求更清晰的了解整个分享过程。
第一次上报
整个需求开发中,出现三次需要上报情况,可以将上报定义为同一个函数,根据不同的入参,做不同的事。live.js中上报函数代码如下:
upload_share_Result(res, type, uid) {
let share_event = apiUrl.share_event // 获取接口
let token = Store.getState().updateToken // 获取登录用户token
let params = {
token, // 登录用户的token
//转发群事件 :type=1; 进入直播间事件 :type=2; 进入直播间30s事件 :type=3 type,
uid, // 记录来源,如果在小程序打开,来源为空;如果从别人分享的打开,来源别人的uid
encryptedData: res ? res.encryptedData : '', // 分享到群的群消息
iv: res ? res.iv : '' // 分享到群的群消息 }
Request(share_event, params, 'post').then((res) => { //...
}).catch((res) => { //... })
},
首先我们需要了解小程序转发的API,包括是否带有群标识、以及如何获取群标识、如何解密群信息等。接下来我们会一点点分析。
在live.js中实现转发分享思路和代码如下:
首先保证live页面显示分享按钮,且能够带有ShareTicket的转发
/** 生命周期函数--监听页面加载*/onLoad: function (options) { // 显示当前页面的转发按钮 wx.showShareMenu({ // 是否使用带 shareTicket 的转发
withShareTicket: true
})
}
然后在live.js中调用onShareAppMessage,来实现自定义转发的信息。然后再通过getShareInfo来获取需要的群信息。具体API可见官网onShareAppMessage & getShareInfo
/**
* 用户点击右上角分享*/onShareAppMessage: function () {
let _this = this
let uid = Store.getState().updateUid // 获取redux中的用户uid
return {
title: this.data.title, // 分享路径,房间名+用户uid
path: `/pages/live/live?id=${this.data.roomid}&source=${uid}`,
imageUrl: this.data.shareImage, // 转发成功的回调函数
success: function (res) { // 分享给个人:{errMsg: 'shareAppMessage:ok'}
// 分享给群:{errMsg: 'shareAppMessage:ok', shareTickets: Array(1)}
/* shareTicket 数组
* 每一项是一个 shareTicket(是获取转发目标群信息的票据) ,对应一个转发对象 */
var shareTicket = (res.shareTickets && res.shareTickets[0]) || '' /* 官网的Tip: 由于策略变动,小程序群相关能力进行调整,
* 开发者可先使用wx.getShareInfo接口中的群ID进行功能开发。 */
wx.getShareInfo({ // 把票据带上 shareTicket: shareTicket,
success: function (res) { // 如果从小程序分享没有source,如果从别人分享的再二次分享带有source
// 后续会讲_this.data.source的来源
let source = _this.data.source ? _this.data.source : ''; // 上报给后台,把群信息带给后台,后台会去解密得到需要的信息
_this.upload_share_Result(res, '1', source)
}
})
},
fail: function (res) {
}
}
}
以上部分已经可以实现基本的分享到群,然后获取群信息,并且完成第一次上报。
后续上报
接下来说一下,当一个用户打开别人分享的小程序,并接受授权或者已有授权的情况下,如何完成第二次、第三次上报,代码依旧在live.js中。
onLoad: function (options) {
let _this = this; this.setData({ // 获取小程序url中的source,记录此小程序是谁分享的;也可能不存在source roomid: options.id,
source: options.source
}, function () { //... }) // 给全局添加回调函数,当用户没有已授权的状态,需要点击·授权·按钮后,此时执行回调函数
app.getInfoCb = function () { if (options.source) { // 第二次上报,如果有options.source,则记录谁分享的
_this.share_event_req(null, '2', options.source) // 第三次上报,如果有options.source,则记录谁分享的
setTimeout(() => {
_this.share_event_req(null, '3', options.source)
}, 30 * 1000)
}
} // 如果用户已授权状态,未删除小程序,直接执行
if (Store.getState().updateUid) {
app.getInfoCb()
}
}
那么点击授权按钮后,执行回调函数又如何操作呢?此时移步至app.js中
App({
postLogin(cdoe, iv, encryptedData) {
let params = {
code : cdoe,
iv: iv,
encryptedData: encryptedData
}
let _this = this; // this指向App对象
Request(apiUrl.postLogin, params, 'post').then(
(res) => {
wx.hideLoading() if(res.code === 1){ // ...
// 如果存在全局getInfoCb,则执行
_this.getInfoCb && _this.getInfoCb()
}
}
)
}
})
仔细的看上面的代码会发现,全局回调中执行的方法share_event_req并不是我们最初定义的公共的upload_share_Result。如果直接调用upload_share_Result方法就可以直接上报了,那为什么还需要调用share_event_req呢?这个share_event_req方法中有做了什么处理呢?我们接着分析,代码在live.js中:
share_event_req(res, type, uid) {
let _this = this; // 如果全局存在shareTicket票据的话,重新执行getShareInfo获取票据中带有的群信息
// 并且上报给后台,让后台去解析群信息
// 官网:当用户将小程序转发到任一群聊之后,可以获取到此次转发的 shareTicket,此转发卡片在群聊中被其他用户打开时,可以在 App.onLaunch() 或 App.onShow 获取到另一个 shareTicket。这两步获取到的 shareTicket 均可通过 wx.getShareInfo() 接口可以获取到【相同】的转发信息。
// 也就是说,A转发到某群,只有B从此群中打开才能算是A的二次上报;但是B再次转发到此群,C从此群打开上报,则不算B上报成功了。这样防止用户群中互相刷。
if (app.globalData.shareTicket) {
wx.getShareInfo({
shareTicket: app.globalData.shareTicket,
success: function (res) {
_this.upload_share_Result(res, type, uid);
}
})
} else { // 如果全局不存在shareTicket的话,直接调用upload_share_Result上报
self.upload_share_Result(null, type, uid);
}
}
那么按照官网说的,全局的shareTicket是在App.onLaunch() 或 App.onShow() 中获取的。
App({
onShow: function (options) { // this指向App对象
this.globalData.shareTicket = options.shareTicket
}
})
总结
用户A从小程序第一次分享到群,把分享的群信息和空的source传给后台上报。 ✅
用户A从小程序第一次分享到个人,获取不到shareTicket,不会上报。
用户B从此群打开小程序获取到全局shareTicket。
如果已有授权执行全局回调,把此shareTicket信息和source=A上报给后台 ✅
如果没有授权,点击授权执行全局回调,把此shareTicket信息和source=A上报给后台 ✅
当用户B在此小程序停留30s,把此shareTicket信息和source=A上报给后台 ✅
用户B再次分享到此群,把分享的群信息和source=A传给后台上报,群信息相同。❎
用户C打开用户B分享的小程序获取到全局shareTicket。
如果已有授权执行全局回调,把此shareTicket信息和source=B上报给后台。 ❎
如果没有授权,点击授权执行全局回调,把此shareTicket信息和source=B上报给后台 ❎
这篇文章有重要参考价值,https://www.cnblogs.com/LChenglong/p/9685616.html