想要通过uni-app集成使用SDK,实现携带参数安装,全渠道统计(H5渠道,广告平台渠道、ASA渠道),一键跳转等全部功能,可参考此经验。
工具/原料
苹果xr
iOS14
一、集成准备
1、前往官站注册创建应用后,在 "应用集成" 的对应平台的 "应用配置" 中获取appkey和scheme以及 iOS 的关联域名。
2、配置appkey在 mainfest.json 的App原生插件配置的 openinstall 插件配置框内配置openinstall分配给应用的AppKey
3、配置scheme在 mainfest.json 的App常用其它配置中配置openinstall分配给应用的scheme
4、配置universal links(iOS平台)HBuilderX2.3.0开始云端打包支持洧粽袄淖配置XCode中的Capabilities参考文档在HBuilderX中的manifest.js泠贾高框on中配置关联域名:"capabilities": { "entitlements": { "com.apple.developer.associated-domains": [ "openinstall分配给应用的关联域名" ] } }示例如下图:
二、使用教程
1、引用const openinstall = uni.requireNativePlugin('openinstall-plugin');
2、初始化init()示例:在App.vue的onLaunch方法中进行初始化openinstall.init();注意:1.3.2版本加入,必须先进行初始化,才能调用其他api
3、获取安装数据getInstall(seconds巳呀屋饔, callback)seconds: 回调超时时间callback: 数据回调函数示例:openinstall.getInstall( 8, function(result) { console.log('getInstall : channel=' + result.channelCode + ', data=' + result.bindData); } );
4、获取拉起数据registerWakeUp(cal盟敢势袂lback)callback: 数据回调函数示例: 在App.vue的on讣嘬铮篌Launch方法中注册拉起回调(在初始化之后调用 )openinstall.registerWakeUp(function(result){ console.log('getWakeup : channel=' + result.channelCode + ', data=' + result.bindData); });
5、注册量统计reportRegister()示例:openinstall.reportRegister();
6、效果点统计reportEffectPoint(effectPointId, effectPointValue)effectPointI颊俄岿髭d: 效果点IDeffectPointValue: 效果点值,数值类型示例:openinstall.reportEffectPoint("effect_test", 1);
三、导出apk/ipa包并上传
1、代码集成完毕后,需要导出安装包上传openinstall后台,openinstall会自动完成所有的应用配置工作。
2、上传完成后即可开始在线模拟测试,体验完整的App安装/拉起流程;待测试无误后,再完善下载配置信息。