更新记录

1.0.2（2026-04-21）

1. 增加鸿蒙支持

1.0.1（2026-04-21）

1. 增加上报注册、登录、购买、自定义等事件接口

1.0.0（2026-04-21）

1. 巨量归因

平台兼容性

uni-app(3.7.6)

uni-app x(3.7.6)

其他

巨量归因

• 上报登录事件
• 上报注册事件
• 上报自定义事件(如购买事件)

官方文档https://bytedance.larkoffice.com/docx/FXgDdOpL9ofSzDxSbrncvmd2nSh

鸿蒙配置

• 增加APP_TRACKING_CONSENT权限配置，可以参考demo里harmony-configs/entry/src/main/module.json5

{
        "name": "ohos.permission.APP_TRACKING_CONSENT",
        "reason": "$string:EntryAbility_desc",
        "usedScene": {
          "abilities": [
            "MainAbility"
          ],
          "when": "inuse"
        }
      }

• 在鸿蒙项目的根目录增加新文件.ohpmrc(unpackage/dist/dev/app-harmony/.ohpmrc)，内容如下：

registry=https://ohpm.openharmony.cn/ohpm/,http://artifact.bytedance.com/repository/byted-ohpm/

接口

    import {
    UTSHuge
} from "@/uni_modules/wrs-uts-huge"

• 初始化SDK

let platform = uni.getSystemInfoSync().platform
switch (platform) {
    case 'ios': {
        // 初始化SDK
        UTSHuge.register({
            user_unique_id: "3y48693232", // 业务用户id，非必传
            "extra_param": "xxx" // 其他用户自定义参数
        }, (resp)=>{
            // 上报冷启动事件
            UTSHuge.didFinishLaunching({})
        })

    }
    break;
    // android、鸿蒙
    default:
    {
        // Android有2种初始化SDK方式
        // 方式1:
        UTSHuge.register({}, (resp)=>{
             // let params = {}
             // params.name = "register" // name参数固定为register
             // params.params = {  // 自定义参数
             //     account: "",
             //     password: ""
             // }
             // UTSHuge.trackEssentialEvent(params)
        })

        // 方式2:
        // let params = {}
        // params.autoSendLaunchEvent = false // 在调用init时是否自动上报事件，默认为true，
        // params.enableLog = true
        // params.playSessionEnable = true
        // params.enableOAID = true
        // // params.customOaid = "xxxx" // 自定义oaid
        // // params.customAndroidID = "xxxxx" // 自定义AndroidID
        // UTSHuge.registerB(params, (resp)=>{
        //  //初始化后发送启动事件
        //  UTSHuge.didFinishLaunching({})
        // })
    }
    break;
}

• 上报注册事件

let platform = uni.getSystemInfoSync().platform
switch (platform) {
    case 'ios': {
        let params = {}
        params.name = "register" // name参数固定为register
        params.params = {  // 自定义参数
            account: "",
            password: ""
        }
        UTSHuge.trackEssentialEvent(params)
    }
    break;
    // android、harmony
    default: {
        let params = {}
        params.method = "***" // 注册方式
        params.isSuccess = true // 是否注册成功
        params.extraParams = { // 自定义参数
            account: ""
            password: ""
        }
        UTSHuge.onEventRegister(params)
    }
    break;
}

• 上报登录事件

let platform = uni.getSystemInfoSync().platform
switch (platform) {
    case 'ios': {
        let params = {}
        params.name = "login" //
        params.params = {  // 自定义参数
            account: "",
            password: ""
        }
        UTSHuge.trackEssentialEvent(params)
    }
    break;
    // android、harmony
    default: {
        let params = {}
        params.method = "***" // 登录方式
        params.isSuccess = true // 是否登录成功
        params.extraParams = { // 自定义参数
            account: "",
            password: ""
        }
        UTSHuge.onLoginEvent(params)
    }
    break;
}

• 上报购买付费事件

let platform = uni.getSystemInfoSync().platform
switch (platform) {

    case 'ios': {
        let params = {}
        params.name = "purchase" // name参数固定为purchase
        params.params = {  // 自定义参数
            account: "",
            password: ""
        }
        UTSHuge.trackEssentialEvent(params)
    }
    break;
    // android、harmony
    default: {
        let params = {}
        params.contentType = "***" // 内容类型。
        params.contentName = "" // 内容名称。
        params.contentId = "" // 内容ID
        params.contentNumber = 2 // 内容数量
        params.paymentChannel = "" // 支付渠道
        params.currency = "¥" // 货币类型。
        params.isSuccess = true // 购买是否成功。
        params.currencyAmount = 200 // 货币金额。
        params.ttOpenId = "" // 头条openid。【可选】,不支持harmony
        params.extraParams = { // 自定义参数，【可选】,不支持harmony
            name: "xxx"
        }
        UTSHuge.onEventPurchase(params)
    }
    break;
}

• 上报自定义事件

let params = {}
params.name = "xxxx" // 事件名称
params.params = {  // 自定义参数
    account: "",
    password: ""
}
UTSHuge.trackEssentialEvent(params)

• 开启延时上报,仅支持iOS

UTSHuge.enableDelayUpload()

• 允许上报，配合上方开启延时上报功能使用, 允许数据上报,仅支持iOS

UTSHuge.startSendingEvents()

• 获取clickid,仅支持iOS

let clickId = UTSHuge.getClickId()
if(clickId) {

}

• 获取CacheOpenUrl,仅支持iOS

let url = UTSHuge.getCacheOpenUrl()
if(url) {

}

• 获取Ipv4,仅支持iOS

let ip = UTSHuge.getIpv4()
if(ip) {

}

• 获取WebviewUA,仅支持iOS

let ua = UTSHuge.getWebviewUA()
if(ua) {

}