更新记录
2.0.0(2025-05-29)
升级sdk版本
1.3.0(2025-05-21)
更新SDK: AppConvert-2.0.0
1.2.0(2024-11-19)
升级巨量广告转化安卓端SDK接入版本为6.16.9 商业化转化组件升级为1.3.2.0
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 12.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
插件介绍
-
该插件封装了抖音的巨量广告转化SDK,版本号2.0.0,查看文档
-
该插件封装了巨量广告转化融合归因SDK,版本号2.0.0,查看文档
-
该插件同时也集成了抖音应用管理中心分包SDK,既:HumeSDK-1.1.1.aar,可以获取抖音分包之后渠道号,查看文档
API列表
/**
* 初始化并激活巨量广告转化SDK
*/
void init()
/**
* 上报注册事件
* @param registerType 注册类型
* @param success 是否成功
*/
void onEventRegister(String registerType, boolean success)
/**
* 上报购买支付事件
* @param goodsType 商品类型
* @param goodsName 商品名称
* @param goodsId 商品ID
* @param goodsNum 商品数量
* @param payChannel 支付渠道
* @param currency 币种
* @param success 是否成功
* @param amount 金额,单位为元
*/
void onEventPurchase(String goodsType, String goodsName, String goodsId, int goodsNum, String payChannel,
String currency, boolean success, int amount )
/**
* 检查是否授权READ_PHONE_STATE,该权限用于巨量广告转化SDK的初始化,记录设备激活事件
* @return 1: 已授权 0: 未授权
*/
String checkPhonePermission()
/**
* 手动请求权限READ_PHONE_STATE,该权限用于巨量广告转化SDK的初始化,记录设备激活事件
*/
void requestPhonePermission()
/**
* 获取抖音分包后的渠道号
* @return 返回抖音分包的渠道号
*/
String getDyChannel()
/**
* 上报自定义事件
* @param eventName 事件名
* @param params 事件详情,里面的key和value暂时只支持String
*/
void customEvent(String eventName, JSONObject params)
SDK调用流程
-
调用checkPhonePermission()方法检查用户是否已经授权READ_PHONE_STATE权限,如果已授权则直接调用init()方法初始化并激活巨量广告转化SDK。
-
如果第1步中检查未授权,则弹出框提示用户将要请求权限,用户点击确认按钮后调用方法requestPhonePermission(),注意,示例中只会弹出一次请求,如果用户拒绝后续将不会继续弹出请求窗口。
-
用户在点击同意授权后,系统会自动调用init()方法激活巨量广告转化SDK,开发人员无须另外处理。
-
在用户注册成功回调里面调用SDK方法onEventRegister,在支付成功的回调里面调用SDK方法onEventPurchase。
SDK激活与获取渠道号示例
<template>
...
</template>
<script>
const dysdk = uni.requireNativePlugin('lilu-dysdk-transform');//获取sdk实例
export default {
data() {
return {
}
},
onLoad() {
this.initDySdk();
this.saveDyChannel();
},
methods: {
initDySdk() {
let code = dysdk.checkPhonePermission();
if (code === '1') {//已经授权
dysdk.init();
}
else {//未授权
//是否已经弹出过权限申请窗口,如果已弹出则不弹
let showPermission = uni.getStorageSync('showPermission') || '0'
if (showPermission !== '1') {//第一次弹出授权请求窗口
let me = this;
uni.showModal({
title: '提示',
content: '为保证您正常、安全地使用,需要获取设备识别码(部分手机提示为获取手机号码/拨打电话)使用权限,请允许。',
showCancel: false,
success: function(res) {
if (res.confirm) {
uni.setStorageSync('showPermission', '1');
dysdk.requestPhonePermission();
}
}
})
}
}
},
saveDyChannel() {
//获取抖音分包的渠道号
let dyChannel = dysdk.getDyChannel();
uni.setStorageSync('dyChannel', dyChannel);
},
}
}
</script>
上报注册事件示例
<template>
...
</template>
<script>
export default {
data() {
return {
}
},
methods: {
onRegister() {//这个方法可以在注册成功的回调里面调用
let dysdk = uni.requireNativePlugin('lilu-dysdk-transform');
dysdk.onEventRegister('xxxxx', true);//xxxxx替换为自己的注册方式
}
}
}
</script>
上报消费支付示例
<template>
...
</template>
<script>
export default {
data() {
return {
}
},
methods: {
onPurchase() {//这个方法可以在支付成功的回调里面调用
let dysdk = uni.requireNativePlugin('lilu-dysdk-transform');
dysdk.onEventPurchase("充值", '600钻石', "1001", 1, "ptb", "¥", true, 6);//根据自己实际场景替换参数,可参考API
}
}
}
</script>