灯妹儿最近收到部分客户在统计频繁反馈了一些问题,其中关于 SDK 接入流程的问题占比较多。今天我们从0开始梳理一遍阿拉丁统计平台SDK接入流程。
阿拉丁统计平台注册可以通过 PC 访问:
tj.aldwx.com
,通过「微信扫码+手机号」的方式即可完成注册。注册流程大约只需要19s。
微信扫码注册登录
如果您已经注册过阿拉丁统计平台,可以直接通过微信扫码的方式登录,方便快捷。
登录阿拉丁统计平台后,会默认跳转到阿拉丁统计后台的主页。方便您了解所有小程序的数据变化。
我们通过右上角「创建应用」可以进入小程序的创建页面,开始我们小程序的创建工作。
创建小程序需要填写:
小程序名称
,选择
小程序的类型
(小程序、小游戏),选择
小程序的分类
(小程序对应的是小程序类型,小游戏对应的是小游戏类型)。
填写信息后,提交就可以获取AppKey,然后就开始SDK接入了。
接入SDK一直以来都是大家最关心的部分,也是接入阿拉丁统计最重要的一个步骤。所以这部分要认真看哦。提交信息后可以看到下面的截图:
SDK接入页
注:阅读此部分的内容需要和开发人员一起,欢迎分享给自己本公司的小程序开发人员。
首先,这个部分的流程需要小程序的技术人员(一般是前端)来协助完成。在此过程中需要了解 阿拉丁Key、统计平台SDK、帮助文档以及数据检测。
阿拉丁Key(又称“AppKey”)是我们为大家创建小程序后生成的唯一凭证,开发者在集成SDK的时候需要将其填写到代码中(具体的操作见后文)。
其次,我们在接入的时候需要充分了解自己的小程序是否采用了框架(wepy、mpvue、Taro)或者插件(最好是和小程序的开发人员沟通确认),如果都没有的话就是标准的小程序类型。
不同的框架、插件接入流程会有细微的变化,但是阿拉丁Key和阿拉丁SDK是一样的。
接着,我们了解了阿拉丁Key和小程序类型后,我们可以下载SDK进行代码集成工作了。由于本文篇幅问题,本文的集成案例以「标准版小程序」演示。
主要参考阿拉丁帮助文档:
http://1t.click/ECR
下载SDK。下载后解压即可看到两个文件。将解压后的两个文件 ald-stat.js和 ald-stat-conf.js拷贝到想集成的小程序项目utils文件夹中。
接着使用微信开发者工具打开ald-stat-conf.js文件。在第二步我们创建小程序的时候生成了阿拉丁Key,将其复制并粘贴在 exports.app_key 的双引号内;由于我们没有采用插件(如果采用插件,请参考插件版接入流程),所以将 exports.plugin 设置为 false 。
填写完配置信息后,我们在小程序的入口文件 app.js 第一行引入阿拉丁SDK文件,代码:const ald = require('./utils/ald-stat.js') 。效果如图所示:
引入阿拉丁SDK文件后,就剩下最后一步了,让小程序能够认识阿拉丁的域名,以管理者或者具有开发者权限的账号登录小程序后台,在左侧的菜单栏选择「开发」,在 request 合法域名中添加 log.aldwx.com 域名信息。
配置 request 合法域名
至此,代码部分就已经告一个段落了。现在来检测一下是否有数据上报呢。通过微信开发者工具中Network 来查看 log.aldwx.com 域名上报的数据是否为 200 就可以判断了。如果遇到问题可以在 tj.aldwx.com 上联系在线客服。
从注册到创建小程序、直到接入SDK的流程,就分享完成了。是不是很简单呢?赶紧去报表页看数据吧。
作为一家专注于小程序统计分析的大数据智能平台,我们也推出了小程序版的统计平台,您可以通过下方的小程序卡片查看自己的小程序数据。