快应用 SDK 集成文档

快应用 SDK 集成文档

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

1、获取应用 AppId

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

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

2、集成 SDK

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

3、添加相应的权限

添加代码如下

  "features": [
    { "name": "system.fetch" },
    { "name": "system.network" },
    { "name": "system.device" },
    { "name": "system.storage" }
  ]

4、SDK引入和初始化

在 app.ux 中引入 gcsdk 并使用 AppId 初始化:

require('./gcsdk.min')
export default {
    onCreate() {
        $GsManager.init(this, ‘your appid’);
    },
    showMenu: util.showMenu,
    createShortcut: util.createShortcut
}

注意1: SDK已经将个数对象设置到全局对象,无需重复导入,需要时使用 $GsManager.{api} 调用 SDK 相关方法。

5、页面打点

在快应用所有需要打点的的页面文件( manifest.json 中 router > pages 对象下声明的页面对应的.ux文件中 )中增加统计代码,有两种接入方法:

方法一:在每个页面中添加打点代码:

示例:

export default {
    onShow(){
        //在onShow方法的第一行加入此代码
        $GsManager.onShow(this) 
        //App业务代码
    },
    ..............
    onHide() {
        //在onHide方法的第一行加入此代码
        $GsManager.onHide(this) 
        //App业务代码
    }
}

注意: 请确保在需要被统计的路由页面调用$GsManager.onShow(this)$GsManager.onHide(this),且这两个方法需要成对出现。

方法二:这种方式更简洁,使用sdk提供的全局函数GsPage()实现页面埋点,无需调用$GsManager.onShow(this)$GsManager.onHide(this)两个方法

原有导出方式

//页面文件  xx.ux
export default {
    data: {
        list:[]
    },
    onInit () {
      console.debug('page onInit');
    }
    onShow () {
      console.debug('page onShow');
      $GsManager.onShow(this);
    },
    onHide (){
        console.debug('page onHide');
        $GsManager.onHide(this);
    }
}

新的导出方式

//页面文件  xx.ux
export default GsPage ({
    data: {
        list:[]
    },
    onInit () {
      console.debug('page onInit');
    }
    //如无业务代码,可以无需调用onShow和onHide函数
})

注意事项

  • 一个 appid 只能对应一个快应用,请不要重复使用,否则会造成数据不准确
  • 慎重调用storage.clear(OBJECT)接口!个数SDK会将用户相关操作数据缓存在客户端数据存储模块,在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题。

文档中心搜索