更新记录

1.0.2（2025-05-20）

增加onEventValue数值型计算事件接口。

1.0.1（2025-04-13）

增加harmony端。

1.0.0（2025-03-28）

新版发布。

平台兼容性

uni-app

uni-app x

友盟移动统计uts原生插件接口

友盟移动统计，账户登录、登出，页面采集，自定义事件埋点。

1. 获取插件对象

import * as UMStatistic from "@/uni_modules/Lizii-UMStatistic";

<script>

    //插件对象
    import * as UMStatistic from "@/uni_modules/Lizii-UMStatistic";

    export default {
    }

</script>

2. 初始化(必须)

<script>

    export default {

        onLoad() {

            //初始化，勾选友盟统计模块配置文件里面配置了appkey和channel时调用此接口初始化
            UMStatistic.UMinit();

            //appkey和channel初始化，未配置时用此接口初始化
            //UMStatistic.initWithAppkey(appkey, channel);
        }
    }

</script>

3. 账号统计-用户登录

//账号统计-用户登录
var Provider = "WB";//账号来源。如果用户通过第三方账号登陆，可以调用此接口进行统计。支持自定义，不能以下划线”_”开头，使用大写字母和数字标识，长度小于32 字节; 如果是上市公司，建议使用股票代码。
var ID = "userID";//用户账号ID，长度小于64字节
UMStatistic.onProfileSignIn(Provider, ID);

4. 账号统计-用户登出

//账号统计-用户登出
UMStatistic.onProfileSignOff();

5. 设置是否自动采集页面, 仅android和ios支持，暂不支持harmony。

//设置是否自动采集页面
var enable = false;//true:自动采集页面 false：手动采集页面
UMStatistic.setAutoPageEnabled(enable);

6. 页面进入事件，仅android和ios支持，暂不支持harmony

//页面进入事件
var viewName = "viewName1";//自定义页面名。
UMStatistic.onPageStart(viewName);

7. 页面退出事件，仅android和ios支持，暂不支持harmony

//页面退出事件
var viewName = "viewName1";//自定义页面名。
UMStatistic.onPageEnd(viewName);

8. 自定义埋点事件

//自定义埋点事件
var eventID = "eventName1";//为当前统计的事件ID。
var map = {
    key1:"key1",
    key2:12
};//对当前事件的参数描述，定义为“参数名:参数值”的HashMap“<键-值>对”。
UMStatistic.onEventObject(eventID, map);

9. 自定义埋点事件(数值型计算事件)，仅android和ios支持，暂不支持harmony

//自定义埋点事件
var eventID = "eventName1";//为当前统计的事件ID。
var map = {
    key1:"key1",
    key2:12
};//对当前事件的参数描述，定义为“参数名:参数值”的HashMap“<键-值>对”。
var number = 10;//计数值
UMStatistic.onEventValue(eventID, map, number);

10. 在manifest.json配置中，Android和ios设置, UrlScheme设置 um.${appkey}

/* android打包配置 */
"android" : {
    "urltypes" : "um.xxxxxxxxxx"
},
/* ios打包配置 */
"ios" : {
    "urltypes" : "um.xxxxxxxxxx"
},
"sdkConfigs" : {
    "statics" : {
        "umeng" : {
            "appkey_ios" : "xxxxxxxxxx",
            "channelid_ios" : "appstore",
            "appkey_android" : "xxxxxxxxxx",
            "channelid_android" : "umeng"
        }
    }
}

11. harmony端，在app-harmony/resources/rawfile/umconfig.json文件中配置appKey和channel。

{
  "appKey": "xxxxxxxxxx",
  "channel": "harmony"
}