渠道上报说明
由于微信小游戏跳转接口还未开放,当前需要通过小程序码实现跳转。如下:
说明:游戏内首页一级入口提供更多游戏按钮,点击展示推荐游戏list。在微信开放能力之前,点击单游戏,展示单游戏推荐图片,长按识别小程序码跳转。待微信小游戏跳转接口开放后,点击直接打开游戏。
因此插件后台需要对小程序码跳转的场景进行统计上报,上报的方案为:在跳转的目标小游戏初始化时(登录流程过后),获取小游戏的启动参数,如果启动参数中带有营销插件的渠道标识,则进行渠道上报。
游戏方接入前准备
跳转的目标游戏方接入渠道上报前需要先生成带有渠道启动参数的游戏二维码提供给插件方。
生成二位码的接口说明见https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/qrcode.html?t=2018115
使用的接口为接口B,里面的scene参数格式参考接口A的path格式,如scene: ‘?plan=1&a=b’,注意不要省略问号。
渠道启动参数的格式如下:
在接口B的scene参数:?plan=1
游戏方需生成上面启动参数的二维码图片提供给插件方。
上报代码接入
上面所述的启动参数检测以及上报流程,插件模块封装了一个接口,游戏方可在游戏初始化后(登录流程后)调用进行渠道上报,注意该渠道上报和插件开关是否打开无关,即使游戏本身没有启动插件也需进行上报。
插件模块都以mgplugin为对象引入,包含了插件UI类RecommendUI以及渠道上报函数enterRpeort,调用mgplugin.enterReport方法进行上报,示例代码如下:
渠道上报验证
由于目前通过微信接口生成的二维码是正式版本二维码,不方便验证,因此可以通过下面两种方法进行验证。
开发者工具自定义启动参数
在开发者工具中,点击编译下拉列表中的“添加编译模式”:
在启动参数输入框中填入上面的参数(由于这里的启动参数格式本身就是类似与url的querystring格式,因此scene的值需要进行一次encode,避免里面的等号被混淆,实际生成二位码的接口中scene的值不需要encode,插件对于获取的scene值默认会进行一次decode,对于"?plan=1"的字符串无论是否encode处理过都会获取到相同的值)。
二维码编译
接口生成的二维码可被开发者工具解析并启动。在编译下拉列表中,点击“通过二维码编译”:
选择微信接口生成的二维码图片文件,便可以二维码的启动参数来调试小游戏,验证渠道上报。
在代码中,调用wx.getLaunchOptionsSync()方法可获取当前启动参数,可通过此方法验证二维码的启动参数是否正确。
通过上面的两个方式打开小游戏后,若成功上报,可在调试面板的network部分看到这样的上报请求:
注意上报的appid、userid和plan参数是否正确。
调试模式查看启动参数
在打开调试模式下,可以在控制台看到启动参数的获取和解析:
有关调试模式请见文档目录“调试模式”部分。