微信/QQ小程序统计SDK(选接)

申请appid

请参考接入准备 获取AppId及相关密钥
注意微信/QQ小程序应用不能和Android、iOS应用共用一个appid, 必须单独申请否则会导致统计异常

获取SDK

wkdata-tencent-1.1.2.zip

版本更新

导入项目

把sdk中的 wkdata-tencent-${version}.min.js、wkdata.config.js 拷贝到项目中和app.js同级的目录。

域名配置

将下面两个域名添加到微信小程序平台的request合法域名中：

https://dcsdk.51y5.net
https://wifi30sdk.51y5.net

配置参数

请将申请到的参数配置到wkdata.config.js中

export default {
    appId: 'APP_ID',
    aesKey: 'AES_KEY',
    aesIv: 'AES_IV',
    md5Key: 'MD5_KEY'
}

初始化SDK代码

在项目的app.js文件中引入SDK,在其onLaunch中初始化。

微信

import './wkdata-tencent-${version}.min.js'

App({
    onLaunch: function () {
        global.$WKDATA.wxInit();
        //设置小程序应用的versionName和versionCode
        global.$WKDATA.setAppVersion('versionName', 'versionCode')
        //小程序应用的渠道号
        global.$WKDATA.setChannel('')
        //业务方自己的设备ID,可以是微信的用户ID
        global.$WKDATA.setDeviceId('')
    }
})

如果使用基础库2.1.2以下的版本，需要在App.onShow方法中调用global.$WKDATA.onAppShow方法

App({
    onShow: function (res)  {
        global.$WKDATA.onAppShow(res)
    },
})

QQ

import './wkdata-tencent-${version}.min.js'

App({
    onLaunch: function () {
        global.$WKDATA.qqInit();
        //设置小程序应用的versionName和versionCode
        global.$WKDATA.setAppVersion('versionName', 'versionCode')
        //小程序应用的渠道号
        global.$WKDATA.setChannel('')
        //业务方自己的设备ID,可以是QQ的用户ID
        global.$WKDATA.setDeviceId('')
    }
})

页面打点

在所有页面的js文件中增加统计代码：

Page({
    onShow: function () {
        global.$WKDATA.onShow('pageName')
    },
    onHide: function () {
        global.$WKDATA.onHide('pageName')
    },
    onUnload: function () {
        global.$WKDATA.onUnload('pageName')
    }
})

自定义打点

调用方法

global.$WKDATA.onEvent(eventName, eventAttr);
// eventName为字符串
// eventAttr为key-value的json，key和value都必须为string

其他配置信息

开启DEBUG

开启debug后会打印日志，并将数据上报到wifi30服务器上，可供接入方验证是否接入成功 在生产环境下不能设置为true

global.$WKDATA.setDebug(true); //默认为false

获取当前版本号

global.$WKDATA.getVersion();

接入验证

抓包查看返回是否为{"retCd":"0"}