快应用SDK
准备条件
获取项目ID,获取方法请参考"项目管理 > 项目概览 > 查看项目基本信息"。
1. 添加跟踪代码
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模式后,在开发者工具中查看数据采集日志。
方式三:数据校验
Last updated
Was this helpful?