微信小游戏SDK快速接入

一、设置域名

以管理员或者开发着身份登录微信公众平台(mp.weixin.qq.com),依次点击 开发→开发设置,服务器域名处找到「 request 合法域名」,点击「修改」,将 glog.aldwx.com 添加到 request 合法域名中。如图所示:

复制下方域名并添加
复制下方域名并添加
glog.aldwx.com

二、配置SDK

配置 SDK 准备工作:

  • 在配置的过程中需要用到微信开发者工具,点此下载

  • 注册 / 登录 小游戏统计平台,点击「创建应用」,输入小游戏名、平台、类型、分类等项目,点击提交,获取小游戏 app_key ;

① 下载SDK并引入

1、点击下载 微信小游戏SDK。并解压,将解压后的文件ald-game.js 和 ald-game-conf.js 两个文件复制到小游戏根目录下的 utils 文件夹中。如没有 utils 文件夹,则在小游戏根目录下创建一个;

② 打开 utils 文件夹下的 ald-game-conf.js文件,复制最开始生成的 app_key (如果没有生成,则参考准备工作-生成app_key) 到语句exports.app_key = "";的双引号中间,引号内不能有除 app_key 之外的多余字符和空格,文件内的其他配置项不要随意更改;

③ 使用微信开发者工具打开小游戏根目录下的 game.js 文件,复制下段代码到 game.js 文件的 第一行 粘贴,完成后通过菜单栏-文件-保存(快捷键 Ctrl+S )修改的代码;

复制下方代码并添加
复制下方代码并添加
require('utils/ald-game.js')

OpenID是微信官方对微信用户的唯一标识,作为数据统计基础,我们强烈建议您在代码中上报小游戏用户OpenID,这样数据将更加准确

三、检测上报状态

在微信开发者工具中,查看控制台中的 Network 中是否存在 d.html 开头的请求,且点击后可看到 glog.aldwx.com 的域名信息,且 status 状态为200,视为成功。

四、完成

如果以上的流程,您都全部配置完成了,可以稍作等待,数据从SDK上报到最终展示,有20 - 30分钟的时延。如果您对以下高级功能感兴趣,可以继续进行接入。如果要统计当前小游戏的在线用户数据,请尽快将小游戏提交审核并发布!

五、高级功能

以下部分是高级功能,开发者可以根据需要,自行选择接入