微信小游戏运营之朋友推荐

前言

11 月 13 日青萍消消乐过审上线,第八篇写过那套流程。上线之后就是运营,第一件事我盯的是评分页。

玩的人有了,评分页是空的。没有评价,也没有推荐。

微信这套分发里,“朋友推荐过”是个实实在在的加权项。官方运营指南把“推荐组件”单列成一条能力,写得很直白:用户推荐数据会影响游戏评分,并在各微信场景显示——启动小游戏时、搜索结果、发现-小程序。

也就是说,玩家愿不愿意替你说一句“这个还行”,直接影响后面还有多少人能看到你。

这篇讲两件事:官方的“评价与推荐”组件到底怎么接;青萍消消乐把它放在了哪两个位置。

官方这套东西,其实是两条路

第一条:用户自己去评价

搜索结果、小游戏更多面板里都能进“评分主页”,进去就能打分、写建议。这条路不用开发者做什么,游戏上线就有。

问题是它太被动。玩家玩得挺开心,不会专门跑去搜自己的游戏打分。

第二条:游戏邀请用户推荐

这才是我们要接的东西。在小游戏内拉起推荐组件,用户推荐之后,推荐信息会在固定位置展示,同时进入上面说的那些分发场景。

官方给的理由挺有意思:他们观察到“朋友的推荐”也是用户选小游戏的重要原因,一个游戏被朋友推荐过,用户持续玩的意愿会更大——就像在视频号、公众号里,用户更乐意消费“朋友喜欢”的内容。

所以玩家在那个页面点下“推荐”,留下的是给朋友的背书,不只是给游戏的一个分数。

入口放在哪,比代码怎么写更重要

官方的建议很具体:放在玩家对游戏认同感较高的时刻,比如高光时刻、达成等级、抽到稀有卡、获得高分;或者做一个游戏内的固定入口。

还有一句得划线:官方不提倡用道具奖励刺激用户推荐,鼓励出于对游戏热爱的自发推荐。

市面上“分享得钻石”“推荐送道具”那套,在这里不但拿不到官方背书,还容易把推荐数据做脏。这条我认,后面讲我们怎么选时机也是按这个来的。

接入:一个实例,三步

代码本身不复杂,官方的最佳实践基本可以直接抄。

第一步:建实例

1
2
3
4
5
6
7
8
9
10
11
let recommendPageManager;

async function loadRecommend() {
if (!wx.createPageManager) {
throw '当前基础库版本暂不支持。';
}
recommendPageManager = wx.createPageManager();
await recommendPageManager.load({
openlink: 'TWFRCqV5WeM2AkMXhKwJ03MhfPOieJfAsvXKUbWvQFQtLyyA5etMPabBehga950uzfZcH3Vi3QeEh41xRGEVFw',
});
}

那个 openlink 是官方给的固定常量,所有小游戏通用,直接复制,不用理解含义。这点和游戏圈不一样,游戏圈要自己去后台拿自己的 openlink。

第二步:预载

load() 就是提前把组件的数据拉下来。官方建议在游戏场景 load 的时候调一次,等真要展示时就不用等网络了。

第三步:拉起和销毁

1
2
3
4
5
6
7
8
9
10
11
12
async function showRecommend() {
if (!recommendPageManager) {
await loadRecommend();
}
return await recommendPageManager.show();
}

// 需要展示时
showRecommend();

// 用完收干净
recommendPageManager.destroy();

show() 如果在没 load 过的时候调用,会自己先加载一次。但别指望它兜底——高频 show 容易撞上 -7 频繁错误,该预载还是预载。

事件监听

1
2
3
4
5
6
7
8
pageManager.on('ready', () => {});
pageManager.on('show', () => {});
pageManager.on('destroy', (res) => {
// res.isRecommended:玩家关掉组件时有没有推荐
});
pageManager.on('error', (res) => {
// res.errCode / res.errMsg
});

这四个事件要基础库 3.8.6 及以上才派发,写在文档的小字里,很容易漏。

六个必须知道的限制

  1. 基础库 3.6.7+ 才有 wx.createPageManager,低于这个版本要 if (!wx.createPageManager) 兜底,不能直接调。
  2. **事件 3.8.6+**。低版本组件照样能拉起来,但收不到 destroy,你也就不知道玩家什么时候关的、推没推荐。
  3. 开发者工具里调不起来。这条得先说:组件只能真机跑,工具里大概率报错或者没反应,别以为是代码写错了,白白 debug 一下午。
  4. isRecommended 只有当次。官方没给“查这个用户历史上推没推荐过”的接口,想避免重复打扰,得自己找依据。
  5. 错误码要认:-1 openlink 异常、-2 基础库版本过低、-3 当前设备不支持、-6 网络异常、-7 操作太频繁、-8 小游戏版本与 openlink 不匹配(开发版/体验版/正式版对不上)。
  6. 平台绑定。这是微信的能力,抖音、QQ 小游戏不通用,做多端要单独处理。

青萍消消乐接在了哪

代码接完只是“能用”,真正决定效果的是什么时候弹。

我们的结构是两条入口、共用一套实例:

青萍消消乐推荐组件的接入结构:自动触发与手动入口共用同一个 PageManager 实例,组件压屏期间暂停玩法计时

自动触发:首通第 3 关,进第 4 关时拉起来

我最后定的是:账号首次通关第 3 关,随后进入第 4 关时拉起一次。

为什么是第 3 关,不是第 1 关,也不是更后面:

  • 第 1 关还没玩明白,弹出来是纯打扰,玩家连“这游戏好不好”都还没形成判断。
  • 太靠后又筛掉一批人,很多人根本走不到那里。
  • 第 3 关是个挺合适的位置:刚上手、有点成就感、还没开始疲劳。

具体链路是这样的:

1
2
3
4
5
6
7
首次通关第 3 关 → 记一笔(云端 clear_count[3])
↓
进入第 4 关(点“下一关”或回首页再从地图进,都算)
↓
界面空闲满 600ms(无弹窗、无加载层、不在首页)
↓
show() 拉起组件

几个刻意的地方:

  • 不在过关弹窗上直接弹。过关弹窗本身要玩家点“下一关”,两个弹层叠一起,很容易点错。等进了第 4 关、棋盘落位了再说。
  • 冷启动不算。开机就停在第 4 关,没有“刚通关”这个事件,不会一进游戏就被弹一脸。
  • **去重靠云端已有的 clear_count**。换设备、清缓存重打第 3 关,云端记录还在,就不弹第二次。这里没有新增后端字段——通关次数后端本来就在存,没必要为了一个弹窗加字段、写迁移、重新部署。
  • 云端没拉到(离线、登录失败)就退回本地记录判断,不至于完全不弹。

手动入口:首页菜单第一项

自动只弹一次,玩家当时点了“以后再说”,就再没机会了。所以首页用户菜单里加了固定入口。

菜单是竖排五项:推荐、分享、游戏圈、客服、信息,推荐放在最上面,图标是一枚点赞。点它不校验“首通第 3 关”,也不看云端通关次数,直接拉起同一个组件。

两处共用一个 PageManager 实例和同一次预载,不会重复建实例、重复 load。

失败处理也不一样:

  • 自动触发失败,只写日志。玩家没主动要,弹个“推荐组件加载失败”纯属添堵。
  • 手动点击失败,必须 toast。玩家点了没反应,会以为游戏卡了。所以手动这条路失败要给出中文原因。

两个不显眼、但会出事的细节

第一,组件是微信原生层,压在 canvas 上面。

Cocos 的 update 可不管上面盖了什么,照跑。不处理的话,玩家看推荐的那十几秒会被算进第 4 关的用时里,而用时直接影响星级。所以我们让组件展示期间暂停玩法计时,收到 destroy 事件再解除。

第二,低版本反而不暂停。

destroy 事件要 3.8.6+。低于这个版本收不到关闭回调,假如照样暂停,玩家关掉组件后会面对一个“点棋盘没反应”的界面,比多算几秒糟得多。

所以逻辑是:能收到事件才暂停;收不到就不暂停。另外还有一层 30 秒兜底——万一 show() 的 Promise 既不 resolve 也不 reject,三十秒后强制解除暂停,但不去主动关组件,玩家可能还开着。

踩坑清单

  1. 开发者工具里试不出来,只能真机。
  2. 忘了判断 wx.createPageManager 是否存在,低版本直接报错。
  3. 不知道事件要 3.8.6,以为 destroy 一定能收到。
  4. 每次 show 都新建实例、重新 load,撞 -7。
  5. 弹窗叠弹窗:过关弹窗还没收就拉组件。
  6. 原生层压屏时没停计时,玩家成绩莫名变差。
  7. 拿道具奖励换推荐,把数据做脏,也不符合官方口径。
  8. 想查“用户推没推荐过”,发现没有接口——这个得提前想好去重依据。

数据在哪看

  • 评分和评价在“评分主页”能看到,就是玩家从搜索结果、更多面板进去的那一页。
  • 推荐数据会影响评分,并在各场景展示,但官方没有给开发者单独的推荐数据查询接口,destroy 回调里的 isRecommended 只有当次有效。
  • 能在自己这边埋的:组件 show 的次数、destroy 时 isRecommended 为 true 的比例、首页手动入口的点击量。这三个数放一起,基本能看出“玩家是懒得推荐,还是根本没看到入口”。

写在最后

这个组件从看文档到真机跑通,用了不到一天。剩下几天都在改一件事:它什么时候出现。

上线这几天我的判断很简单:入口要放在玩家刚赢了一把、心情最好的那一刻,而不是你最想让他推荐的那一刻。这两个时刻往往不在一起。

下一步是把分享那条链路也一起看——推荐和转发解决的是两件事,一个是对外背书,一个是把人拉进具体某一局。等跑一段时间,再看这两个入口各自带来多少新增。

参考链接