更新记录
1.0.6(2024-10-22)
- android支持fbInstallReferrer
1.0.5(2024-08-27)
- 升级sdk 4.38.4
1.0.4(2023-09-17)
- 升级sdk 4.35.0
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 14.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:11 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
使用文档 (更多插件及问题,请:)
超级福利
使用
本插件提供 adjust 的集成。
adjust测试,请看官方文档
全局监听
在App.vue 的 onLaunch方法添加如下代码
plus.globalEvent.addEventListener("attributionChanged", (e) => {
// e.data
});
plus.globalEvent.addEventListener("eventTrackingSucceeded", (e) => {
// e.data
});
plus.globalEvent.addEventListener("eventTrackingFailed", (e) => {
// e.data
});
plus.globalEvent.addEventListener("sessionTrackingSucceeded", (e) => {
// e.data
});
plus.globalEvent.addEventListener("sessionTrackingFailed", (e) => {
// e.data
});
plus.globalEvent.addEventListener("launchReceivedDeeplink", (e) => {
// e.uri
});
模块方法
var adjust = uni.requireNativePlugin("sn-adjust");
- setEnabled - 设置是否开启
adjust.setEnabled(true);
- getEnabled - 获取是否开启
adjust.getEnabled((enable) => {});
- setOfflineMode - 设置是否开启离线模式
adjust.setOfflineMode(true);
- getAdid - 获取Adid
adjust.getAdid((adid) => {});
- getIdfa - 获取Idfa,仅ios
adjust.getIdfa((idfa) => {});
- setPushToken - 设置推送token
adjust.setPushToken("token");
- getGoogleAdId - 获取Google AdId,仅android
adjust.getGoogleAdId((adid) => {});
- getAmazonAdId - 获取Amazon AdId,仅android
adjust.getAmazonAdId((adid) => {});
- getSdkVersion - 获取SDK版本号
adjust.getSdkVersion((version) => {});
-
trackEvent - 事件追踪
参数说明,请参考
adjust.trackEvent({
eventToken: "test", // 必填, 其余都是可选
callbackId: "test",
callbackParams: {
a: "1",
b: "2",
},
partnerParams: {
a: "1",
b: "2",
},
orderId: "TN232",
revenue: {
revenue: 23.45,
currency: "CNY",
},
});
- trackAdRevenue - 广告 revenue 追踪
adjust.trackAdRevenue("source", {});
- getAttribution - 获取当前归因
adjust.getAttribution((e) => {
if (e.code == 0) {
// e.data
}
});
其他功能(可选)
- meta-referrer配置参考
https://dev.adjust.com/zh/sdk/android/plugins/meta-referrer-plugin