快应用接入uni统计使用教程

部分手机厂商给快应用提供了在自家手机上的统计服务，但这并不能满足开发者需求。
开发者需要在一处看到全平台的数据，可以筛选厂商渠道进行对比分析，还需要更精细的统计服务来支持良好的运营。

DCloud的uni统计支持全平台统计，可在一个后台查看所有厂商的快应用数据，本教程根据创建快应用的不同模式，介绍接入uni统计的方案。

接入uni统计

通过HBuilderX新建快应用

通过HBuilderX新建快应用时，会自动在项目根目录下创建dcloud_stat.js、dcloud_stat_conf.js，并在app.ux中加入统计调用，如下：

<script>  
    import './dcloud_stat.js';  

    module.exports = {  
        onCreate: function () {  
            console.log("app launch");  
            /**  
             *  DCloud统计服务类似于快应用里的友盟或阿拉丁，可登录 http://dev.dcloud.net.cn 查看统计数据  
             *  使用该服务可在一点看到所有渠道的运营数据，避免登陆不同渠道的后台，更方便的掌握业务运营状态。  
             *   如不需要此服务，请注释掉本行代码  
             */  
            dc_stat.report();  

        },  
        /**manifest**/  
    }  
</script>

开发者无需修改，即可直接使用uni统计。

PS：如果开发者不想使用uni统计服务，在app.ux将dc_stat.report();注释即可。

通过HBuilderX将小程序转快应用

通过HBuilderX将小程序转化为快应用时，会自动在项目根目录下创建dcloud_stat.js、dcloud_stat_conf.js，并在app.ux中加入统计调用，如下：

<script>  
    require('./polyfill.js');  
    /**  
    * DCloud统计服务类似于快应用里的友盟或阿拉丁，可登录 http://dev.dcloud.net.cn 查看统计数据  
    * 使用该服务可在一点看到所有渠道的运营数据，避免登陆不同渠道的后台，更方便的掌握业务运营状态。  
    * 如不需要此服务，请注释掉本行代码  
    */  
    require('./dcloud_stat.js');    

    //其它转换后代码  

</script>

开发者无需修改，即可直接使用uni统计。

PS：如果开发者不想使用uni统计服务，在app.ux将 require('./dcloud_stat.js'); 注释即可。

其它方式

如果已经使用其它IDE开发完快应用，可以按照如下步骤接入uni统计：

1、从http://quickapp.dcloud.io 下载安装HBuilderX，启动后注册一个HBuilder账号
2、将已开发的快应用项目拖入HBuilderX
3、下载uni_stat_sdk并解压，将其中的dcloud_stat.js、dcloud_stat_conf.js拷贝到app.ux同级的目录（src目录下）；
4、修改dcloud_stat_confi.js，填入快应用包名；
5、在app.ux中导入dcloud_stat，如下：

import './dcloud_stat.js';

6、在app.ux的onCreate中增加打点统计代码，如：

onCreate:function(){  
    //新增uni统计打点  
    dc_stat.report();     
    //其它业务代码  
},

7、为保证统计数据准确，uni统计会读取用户设备信息（若用户拒绝，则会生成虚拟设备标志并存储本地），因此需要在manifest.json中增加如下接口声明：

 "features": [/*接口列表*/  
    {"name": "system.fetch"},  
    {"name": "system.device"},  
    {"name": "system.storage"},  
    /* 项目需要的其它接口声明*/  
  ]

8、点击发行，生成rpk文件，安装到调试器进行验证，或上传到快应用联盟；

注意：首次需要使用HBuilderX打包生成rpk文件，这是为了绑定，验证统计功能没问题后，后续可以继续使用其它的开发环境打包rpk。