小程序 SDK 集成文档

个数是个推旗下基于大数据的应用统计产品，从用户属性、使用行为、行业对比等多指标多维度进行全面的移动应用统计分析，帮助 APP 运营者深层次挖掘用户需求，准确了解自身行业地位，从而更好地指导产品运营。

1、获取应用 AppId

1、登录 个推开发者后台 ，进入个数应用统计。

2、创建个数应用，并获取 AppId。

2、集成 SDK 和 初始化

• 直接下载SDK，并添加到项目中。

• 在 app.js 中导入 gcsdk 并使用 AppId 初始化:

const GsManager = require('./gcsdk')
//app.js
App({
    onLaunch: function() {
        //初始化个数
        GsManager.init('your gcsdk appId')
        //设置openID
        GsManager.setOpenId('get your openid and then set by this interface')
    },
    globalData: {
        userInfo: null
    }
})

注意： 慎重调用wx.clearStorageSync()或者wx.clearStorage()接口！个数SDK会将用户相关操作数据缓存在客户端数据存储模块，在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题。

注意： 用户登录获取openid后，可以调用setOpenId接口进行设置。使新增、日活等指标的统计更加准确。

3、添加请求服务器域名

要正常采集微信小程序的数据并发送给个数统计, 需要在微信小程序里事先设置请求域名, 允许个数SDK的API与服务器进行网络通信,步骤如下:

• 登录微信小程序后台, 进入设置
• 打开开发设置, 到服务器域名配置部分
• 在request合法域名添加 https://gs.getui.com

4、应用时长统计

应用时长统计用于统计启动次数和应用的真实活跃时长，集成 SDK 后不需要开发者调用额外的接口。

其中 小程序 平台一次完整的启动包括如下两种情况：

1. 从启动应用到关闭应用

2. 从启动应用到应用退至后台，且在后台运行时间超过 30s 。也可以修改该默认值：

   GsManager.setSessionTime(30000)

注意： 配置方法需要在SDK初始化后设置，建议在 app.js的 onLaunch 方法中设置。

const GsManager = require('./gcsdk')
//app.js
App({
    onLaunch: function() {
        //初始化个数
        GsManager.init('your gcsdk appId')
        //配置方法
        GsManager.setSessionTime(30000)
    },
    globalData: {
        userInfo: null
    }
})