更新记录

1.0.3（2024-11-19）

--升级android sdk 版本：6.16.9

1.0.2（2024-10-26）

--修复android初始化bug

1.0.1（2023-12-11）

--更新插件文档描述

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

/ Title: saner-rangersAppLog Description: 巨量引擎转化跟踪 /

概述

巨量引擎转化跟踪简介

巨量引擎智能平台为广告主及合作伙伴提供一站式辅助投放工具,从广告创意制作到效果优化,巨量引擎智能工具帮您一站式完成,让您的广告推广更加简单。

rangersAppLog 插件概述

本模块封装了巨量引擎转化跟踪的原生 SDK，集成了app内部事件监听。

插件使用攻略

使用之前须从巨量引擎转化跟踪平台申请开发者账号并创建应用，获取 appId。

巨量引擎转化跟踪申请地址巨量引擎转化跟踪

模块接口

initSdk

sdk 初始化

initSdk({params},callback(ret, err))

params

appId：

• 类型：字符串

• 描述：应用ID

• appName：

• 类型：字符串

• 描述：（必填）APP名称 (对应平台填写的名称)

channel：

• 类型：字符串
• 描述：（必填）渠道 （自定义）

enablePlay：

• 类型：布尔
• 描述：（选填）是否开启游戏模式 (默认：false)

enableAb：

• 类型：布尔
• 描述：（选填）是否开启A/B Test功能 (默认：false)

enableAutoStart：

• 类型：布尔
• 描述：（选填）是否自动开始 (默认：true)

language：

• 类型：字符串
• 描述：（选填）语言标识

region：

• 类型：字符串
• 描述：（选填）地区标识

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'onInit', //事件类型 
    msg: "onInitSdk",//描述
    result:{ //其他结果数据

    }
}

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.initSdk({
    appId: "",
    appName: "应用名称",
    channel:"appStore",//应用宝 appstore oppo vivo 360 huawei 百度
    enablePlay: false,//是否开启游戏模式
    enableAb: false,//是否开启A/B Test功能
    enableAutoStart: true,//是否自动开始
    language: "",//语言标识
    region: "",//地区标识
},function(ret, err) {
    if (ret.status) {
        alert("sdk 初始化成功");
    } else {
        alert('sdk 初始化失败');
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setUserUniqueId

设置用户唯一标识

setUserUniqueId(userUniqueId)

params

userUniqueId：

• 类型：字符串
• 描述：（必填）设置用户唯一标识

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.setUserUniqueId(1);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

clearUserUniqueId

清除用户标识（用于账号退出登录时使用[android此方法空执行，避免客户端的判断]）

clearUserUniqueId()

params

无

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.clearUserUniqueId();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

customEvent

自定义事件上报

customEvent(type, {params})

params

type：

• 类型：字符串
• 描述：（必填）事件类型

params：

• 类型：对象
• 描述：（必填）事件参数 （自定义）

  {
      type: "wechat",
      sex: "1",
      age: "18"
  }

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.customEvent("register",{
        type: "wechat",
        sex: "1",
        age: "18"
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

viewContentEvent

内容/商品详情页面事件上报

viewContentEvent(type, name, id)

params

id：

• 类型：字符串
• 描述：（必填）内容ID

type：

• 类型：字符串
• 描述：（必填）内容类型

name：

• 类型：字符串
• 描述：（必填）内容名称

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.viewContentEvent("detail","活动",1);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

registerEvent

注册事件上报

registerEvent(type, isSuccess)

params

type：

• 类型：字符串
• 描述：（必填）类型

isSuccess：

• 类型：布尔
• 描述：（必填）属性

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.registerEvent("wechat",true);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

loginEvent

登录事件上报

loginEvent(type, isSuccess)

params

type：

• 类型：字符串

• 描述：（必填）类型

• isSuccess：

• 类型：布尔

• 描述：（必填）属性

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.loginEvent("wechat",true);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

accessAccountEvent

账号绑定事件上报

accessAccountEvent(type,isSuccess)

params

type：

• 类型：字符串
• 描述：（必填）类型

isSuccess：

• 类型：布尔
• 描述：（必填）属性

• callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.accessAccountEvent("wechat",true);
// 绑定社交账号，属性：社交账号类型，是否成功

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

accessPaymentChannelEvent

绑定支付渠道事件上报

accessPaymentChannelEvent(type,isSuccess)

params

type：

• 类型：字符串
• 描述：（必填）类型

isSuccess：

• 类型：布尔
• 描述：（必填）属性

• callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.accessPaymentChannelEvent("wechat",true);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addCartEvent

添加购物车事件上报

addCartEvent(type, name, id, num, isSuccess)

params

id：

• 类型：字符串
• 描述：（必填）商品ID

type：

• 类型：字符串
• 描述：（必填）商品类型

name：

• 类型：字符串
• 描述：（必填）商品名称

num：

• 类型：字符串
• 描述：（必填）商品数量

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.addCartEvent("gift","商品名称",1,1,true);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addFavoriteEvent

添加收藏事件上报

addFavoriteEvent( type, name, id, num, isSuccess)

params

id：

• 类型：字符串
• 描述：（必填）商品ID

type：

• 类型：字符串
• 描述：（必填）商品类型

name：

• 类型：字符串
• 描述：（必填）商品名称

num：

• 类型：字符串
• 描述：（必填）商品数量

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.addFavoriteEvent("gift", "商品名称", 1, 1, true);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

checkOutEvent

提交订单事件上报

checkOutEvent(type, name, id, num, isVirtualCurrency, payChannel, currency, isSuccess, amount)

params

id：

• 类型：字符串
• 描述：（必填）商品ID

type：

• 类型：字符串
• 描述：（必填）商品类型

name：

• 类型：字符串
• 描述：（必填）商品名称

num：

• 类型：字符串
• 描述：（必填）商品数量

payChannel：

• 类型：字符串
• 描述：（必填）付款渠道

isVirtualCurrency：

• 类型：字符串
• 描述：（必填）是否虚拟货币

currency：

• 类型：字符串
• 描述：（必填）货币类型

amount：

• 类型：字符串
• 描述：（必填）订单金额

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.checkOutEvent("gift", "商品名称", 1, 1, false, "wechat", "￥", true ,1);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

purchaseEvent

付款事件上报

purchaseEvent(type, name, id, num, payChannel, currency, isSuccess, amount)

params

id：

• 类型：字符串
• 描述：（必填）商品ID

type：

• 类型：字符串
• 描述：（必填）商品类型

name：

• 类型：字符串
• 描述：（必填）商品名称

num：

• 类型：字符串
• 描述：（必填）商品数量

payChannel：

• 类型：字符串
• 描述：（必填）付款渠道

currency：

• 类型：字符串
• 描述：（必填）货币类型

amount：

• 类型：字符串
• 描述：（必填）订单金额

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.purchaseEvent("gift", "商品名称", 1, 1, "wechat", "￥", true ,1);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

createGameRoleEvent

创建角色事件上报

createGameRoleEvent(id)

params

id：

• 类型：字符串
• 描述：（必填）角色ID

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.createGameRoleEvent(1);

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

updateLevelEvent

角色升级事件上报

updateLevelEvent(level)

params

level：

• 类型：字符串
• 描述：（必填）角色等级

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.updateLevelEvent("88");

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

questEvent

完成任务事件上报

questEvent( id, type, name, sort, state, desc)

params

id：

• 类型：字符串
• 描述：（必填）任务ID

type：

• 类型：字符串
• 描述：（必填）任务类型

name：

• 类型：字符串
• 描述：（必填）任务名称

sort：

• 类型：字符串
• 描述：（必填）任务项

state：

• 类型：字符串
• 描述：（必填）任务状态

desc：

• 类型：字符串
• 描述：（必填）任务描述

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.questEvent( 1, "tasktype", "任务名称", 0, true, "任务描述" );

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getAbParams

获取AB参数

getAbParams({params}, callback(ret, err))

params

params：

• 类型：对象
• 描述：（必填）属性参数 （自定义）

  ["age","type","sex"]

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status: true, //初始化状态
    code: 0, //状态码
    type: 'getAbParams', //事件类型 
    msg: "getAbParams",//描述
    result:{ //其他结果数据
        age:"18",
        type:"1",
        sex:"1",
    }
}

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
rangersAppLog.getAbParams({
    params:["age","type","sex"],
}, function(ret, err) {
    if (ret.status) {
        var result = ret.result; //参数结果集
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getSsid

获取ssid

getSsid()

params

无

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
var ssid = rangersAppLog.getSsid();

可用性

Android系统

可提供的1.0.0及更高版本

getDid

获取did

getDid()

params

无

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
var did = rangersAppLog.getDid();

可用性

Android系统

可提供的1.0.0及更高版本

getIid

获取iid

getIid()

params

无

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

无

示例代码

var rangersAppLog = uni.requireNativePlugin('saner-rangersAppLog');
var iid = rangersAppLog.getIid();

可用性

Android系统

可提供的1.0.0及更高版本