快应用SDK集成

anwei发表于:2019年12月06日 17:12:16更新于:2019年12月06日 17:20:38

快应用SDK

准备条件

获取项目ID,获取方法请参考"项目管理 > 项目概览 > 查看项目基本信息"。


1.添加跟踪代码

下载gio-quickapp.js 文件

把文件放在快应用应用项目里,比如 utils 目录下。


curl --compressed https://assets.giocdn.com/sdk/gio-quickapp.js -o gio-quickapp.js

2、在根目录 app.ux文件的顶部添加跟踪代码


var gio = require("utils/gio-quickapp").default;
gio('init', '你的 GrowingIO 项目ID', '你的快应用ID(包名)', { version: '小程序版本' });

// 添加trackApp 和 trackPage 代码,如下:
// app.ux 中改写如下:
export default {  
...
})
// 改为:
export default trackApp({  
...
})

// 所有的Page页面的index.ux改写如下:export default {  
...
})
// 改为:
export default trackPage({  
...
})

2. SDK参数配置


建议每次发布小程序新版本的时候,更新一下版本号 version,可以在 GrowingIO 分析不同版本的数据。除了 version 之外,还有以下额外参数可以使用。

参数

解释

version

string

你的小程序的版本号

forceLogin

true | false

你的快应用是否获取用户唯一标识,默认 false

debug

true | false

是否开启调试模式,可以看到采集的数据。默认 false

3. 添加接口权限


在您项目中的 manifest.json 文件中的 features 属性中添加权限声明代码。


"features": [  
      {"name": "system.app"},  
      {"name": "system.storage"},  
      {"name": "system.device"},  
      {"name": "system.network"},  
      {"name": "service.router"},  
      {"name": "system.fetch"}  
      {"name": "system.geolocation"}
];

4. 快应用 用户属性设置


绑定快应用用户ID

当用户在你的应用上登陆获取到 用户唯一id 后,可以用过 identify 接口绑定快应用用户ID,后续在 GrowingIO 中获取更准确的快应用访问用户量。示例代码如下:


device.getUserId({  
    success: function(res) {    
        var userId = res.data.userId;    
        // ...    
        gio('identify', userId);  
     }
})

设置快应用用户信息


gio('setVisitor', res.userInfo);

设置登录用户ID

当用户在你的快应用上注册以后,你的产品应用服务端会在用户数据库里添加一条记录并且分配一个 ID,可以通过 setUserId 接口设置注册用户ID,后续在 GrowingIO 中分析登录用户这个数据。示例代码如下:


gio('setUserId', YOUR_USER_ID);

清除登录用户ID

用户退出登录时,清除登录用户ID。


gio('clearUserId');

设置登录用户属性

当用户在你的快应用上传了注册用户ID后,可以通过 setUser 接口设置注册用户信息,后续在 GrowingIO 中分析这个数据。示例代码如下:


gio('setUser', { id: user.id, name: user.name });

5. 自定义数据上传API

自定义数据上传API,请参考自定义数据上传API

6. 创建应用

请在添加了跟踪代码的支付宝小程序重新启动几次,发送数据给 GrowingIO。

在GrowingIO平台的创建微信小游戏应用。创建应用请参考查看创建应用

7. 验证SDK是否正常采集数据

方式一:小程序&内嵌页Debugger

方式二:在SDK中设置了Debug模式后,在微信开发者工具中查看数据采集日志。

方式三:数据校验