快应用统计 SDK 集成指南
最近更新:2021-12-15
展开全部

快应用统计 SDK 集成指南

使用提示

本文是JAnalytics QuickApp SDK 标准的集成指南文档。

匹配的 SDK 版本为:v2.0.0及以后版本。

  • 如果您想要快速地测试、请参考本文在几分钟内跑通Demo。
  • 极光推送文档网站上,有相关的所有指南、API、教程等全部的文档。包括本文档的更新版本,都会及时地发布到该网站上。

产品说明

利用事件模板统计App用户的行为事件并上报给极光服务器,极光提供加工过的数据通过WebPortal展示给开发者,让开发者更加了解自己的应用在用户手中的使用情况。

主要场景:

1.统计页面流 2.统计自定义计数事件 3.统计自定义计算事件
          1.统计页面流
2.统计自定义计数事件
3.统计自定义计算事件

        
此代码块在浮窗中显示

janalytics-quick-app-release-2.x.y.zip 集成压缩包内容

  • libs/jcore-quickapp-1.x.x.js
    • SDK core 开发包
  • libs/janalytics-quickapp-2.x.x.js
    • SDK analysis 开发包
  • example
    • 是一个完整的 Quick App 项目,通过这个演示了 JAnalysis SDK 的基本用法,可以用来做参考。

Quick App 平台版本

SDK支持在快应用平台v1000及以后版本上使用。

创建应用

创建极光开发者帐号

请访问极光官方网站 注册您的极光账号。

jpush_android_guide

Portal上创建应用

使用注册账号登陆,进入极光控制台-应用管理,点击「创建应用」按钮,进入创建应用的界面。输入应用名称和上传好应用图标(非必填),点击「确认」即可创建应用。

jpush_android_guide jpush_android_guide

查看应用信息

创建应用之后返回用户主页面可以看到应用清单,点选你刚才创建的应用来查看应用信息。

jpush_android_guide

本地工程配置

  • 解压压缩包,将libs下的文件复制到工程的libs下面.
    • janalytisc-quickapp-2.x.x.js。
    • jcore-quickapp-1.x.x.js

配置manifest.json

需要在在manifest.json 配置SDK所需的快应用平台依赖库和开启开应用日志。示例如下:

"features": [ { "name": "system.prompt" }, { "name": "system.router" }, { "name": "system.shortcut" }, { "name": "system.device" }, { "name": "system.app" }, { "name": "system.fetch" }, { "name": "system.storage" }, { "name": "system.cipher" }, { "name": "system.network" }, { "name": "service.push" }, { "name": "system.geolocation" }, { "name": "system.notification" }, { "name": "system.wifi" }, { "name": "system.websocketfactory"} ], "config": { "logLevel": "debug" },
          "features": [
    { "name": "system.prompt" },
    { "name": "system.router" },
    { "name": "system.shortcut" },
    { "name": "system.device" },
    { "name": "system.app" },
    { "name": "system.fetch" },
    { "name": "system.storage" },
    { "name": "system.cipher" },
    { "name": "system.network" },
    { "name": "service.push" },
    { "name": "system.geolocation" },
    { "name": "system.notification" },
    { "name": "system.wifi" },
    { "name": "system.websocketfactory"}
],
"config": {
    "logLevel": "debug"
},

        
此代码块在浮窗中显示

添加SDK的Nodejs依赖库

该统计sdk需要依赖nodejs库。依赖方式及说明如下(如已经依赖相关模块则跳过):

npm install lodash.clonedeep --save

使用对象复制
          使用对象复制

        
此代码块在浮窗中显示

npm install pako --save

使用数据压缩,减小流量
          使用数据压缩,减小流量

        
此代码块在浮窗中显示

npm install crypto-js --save

使用数据加密,增加安全性
          使用数据加密,增加安全性

        
此代码块在浮窗中显示

SDK 初始化

  • 设置调试模式:参数为 true 表示打开调试模式,可看到 sdk 的日志。
JAnalyticsInterface.setDebugMode(boolean isDebugMode);
              JAnalyticsInterface.setDebugMode(boolean isDebugMode);

        
此代码块在浮窗中显示
  • 在 app.ux 中导入 SDK 并使用 AppKey 初始化:
import { JAnalyticsInterface } from './libs/janalytics-quickapp-2.0.0' export default { showMenu: util.showMenu, createShortcut: util.createShortcut, onCreate(){ JAnalyticsInterface.setDebugMode(true); this.JAnalyticsInterface = JAnalyticsInterface.init(this, "your appkey", "test-channel") } }
              
    import { JAnalyticsInterface } from './libs/janalytics-quickapp-2.0.0'
         export default {
         showMenu: util.showMenu,
         createShortcut: util.createShortcut,
         onCreate(){
             JAnalyticsInterface.setDebugMode(true);
             this.JAnalyticsInterface = JAnalyticsInterface.init(this, "your appkey", "test-channel")
         }
    }

        
此代码块在浮窗中显示

ps:建议将JAnalyticsInterface对象设置为全局的方法,暴露给每个页面使用,无需重复导入,需要时使用 this.$app.JAnalyticsInterface 调用 SDK 相关方法。

更多 API

其他 API 的使用方法请参考接口文档:QuickApp SDK API

运行 demo

压缩包附带的 example 是一个 API 演示例子。你可以直接运行起来测试。运行可参考Quick App官方文档

技术支持

邮件联系:support@jiguang.cn

文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开