一、集成Adjust SDK
1.使用cocopods添加SDK,在podfile中指定使用的版本。
pod 'Adjust/WebBridge', '~> 4.38.4'
2.要导入 Adjust SDK,请将下列行添加至您的 AppDelegate.h 文件
#import <Adjust/Adjust.h>
#import "AdjustBridge.h"
3.添加iOS框架
AdSupport.framework
AdServices.framework
StoreKit.framework
AppTrackingTransparency.framework
WebKit.framework
4.初始化SDK:在您应用委托的 didFinishLaunching 或 didFinishLaunchingWithOptions 方法中声明 config 对象,ADJUSTTOKEN为在Ajust后台创建应用后唯一标识符。
NSString *yourAppToken = ADJUSTTOKEN;
NSString *environment = ADJEnvironmentProduction;//配置环境
ADJConfig *myAdjustConfig = [ADJConfig configWithAppToken:yourAppToken
environment:environment];
[myAdjustConfig setUrlStrategy:ADJUrlStrategyChina];
[myAdjustConfig setLogLevel:ADJLogLevelVerbose];
[Adjust appDidLaunch:myAdjustConfig];
5.设置Adjust自定义埋点
上架前务必告知Adjust管理员APP的bundle id,在Adjust后台创建上架应用,稍后管理员会将埋点秘钥发送给开发者,由开发者替换各个埋点秘钥。包括
ADJUSTTOKEN(Adjust应用秘钥)、
ADJUST_EVENT_INSTALL(首次安装)、
ADJUST_EVENT_START(程序启动)、
ADJUST_EVENT_CONTACTS(紧急联系人)、
ADJUST_EVENT_LOGIN(用户登录)、
ADJUST_EVENT_APPLY(申请贷款)、
ADJUST_EVENT_REPAYMENT(申请还款)、
ADJUST_EVENT_EMPINFO(公司信息认证)、
ADJUST_EVENT_PERSONINFO(个人信息认证)、
ADJUST_EVENT_OCR(OCR认证),以上参数直接在web容器的header文件中直接替换即可,下面对每个参数做出解释:
注意:首次安装、程序启动埋点需要工具包添加到Appdelegate文件的didFinishLaunchingWithOptions方法中,其他埋点已经导入到web容器,不需变动。
###①.ADJUSTTOKEN :初始化Adjust SDK需要用到
###②.ADJUST_EVENT_INSTAL:首次安装,需要iOS原生触发(appdelegate 的didFinishLaunchingWithOptions 方法触发)
###③.ADJUST_EVENT_START:程序启动,需要iOS原生触发(appdelegate 的didFinishLaunchingWithOptions 方法触发)
if(![[NSUserDefaults standardUserDefaults] boolForKey:@"firstStart"]){
[[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"firstStart"];
NSLog(@"首次启动");
application.applicationIconBadgeNumber=88;
ADJEvent *event = [ADJEvent eventWithEventToken: ADJUST_EVENT_INSTALL];
[Adjust trackEvent:event];
}else{
NSLog(@"非首次启动");
application.applicationIconBadgeNumber=66;
ADJEvent *event = [ADJEvent eventWithEventToken: ADJUST_EVENT_START];
[Adjust trackEvent:event];
}
###④.ADJUST_EVENT_CONTACTS:保存紧急联系人(web容器触发,开发者只需替换对应秘钥)。
###⑤.ADJUST_EVENT_LOGIN:用户登录(web容器触发,开发者只需替换对应秘钥)。
###⑥.ADJUST_EVENT_APPLY:申请贷款(web容器触发,开发者只需替换对应秘钥)。
###⑦.ADJUST_EVENT_REPAYMENT:申请还款(web容器触发,开发者只需替换对应秘钥)。
###⑧.ADJUST_EVENT_EMPINFO:公司信息认证(web容器触发,开发者只需替换对应秘钥)。
###⑨.ADJUST_EVENT_PERSONINFO:个人信息认证(web容器触发,开发者只需替换对应秘钥)。
###⑩.ADJUST_EVENT_OCR:OCR认证(web容器触发,开发者只需替换对应秘钥)。
6.导入三方SDK
pod 'SystemServices'
二、导入web容器
1.添加相关权限,包括:通讯录权限、IDFA权限、相机权限、相册权限、定位权限
2.webviewController添加重新加载按钮:
如果执行了网页加载成功代理方法,按钮隐藏。
如果执行了加载失败代理方法,按钮显示,重新加载URL
3.添加定位功能
3.1.将YMLoationTool.h YMLocationTool.m两个文件导入到项目中,在YMWebHeader文件中导入头文件
#import "YMLocationTool.h"
3.2
YMJSTool.h新增交互方法
static NSString * adjustGetGPSInfo = @"bridgGetGPSInfo"; // 获取定位信息
YMJSTool.m JS调用OC方法中新增拦截方法
if ([message.name isEqualToString:adjustGetGPSInfo]) {
//gps
[self getGPSInfo];
}
并且创建对应执行方法
#pragma mark get gps info
-(void)getGPSInfo{
BOOL location = [YMLocationTool isOpenLocationStart];
if (location == NO) {
//无定位权限
UIAlertController *alert =[UIAlertController alertControllerWithTitle:@"Attention" message:@"You must turn on the location function to use the lending function" preferredStyle:UIAlertControllerStyleAlert];
[alert addAction:[UIAlertAction actionWithTitle:@"OPEN" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {
[YMLocationTool openScheme:@"UIApplicationOpenSettingsURLString"];
}]];
[[YMBaseMethod getCurrentVC] presentViewController:alert animated:YES completion:nil];
}else{
//有定位权限
[[YMLocationTool sharedCLLocationService]startLocationServiece];
[OLEJsbridgeGetUserinfo uploadGPSInfoWithLongitude:[YMLocationTool sharedCLLocationService].longitude Latitude:[YMLocationTool sharedCLLocationService].latitude Array:self.mainMessage.body WebView:self.mainWebView];
}
}
3.3在OLEJsbridgeGetUserinfo.h新建方法
#pragma mark 经纬度上传
+(void)uploadGPSInfoWithLongitude:(CGFloat )longitude
Latitude:(CGFloat)latitude
Array:(NSArray *)arr
WebView:(WKWebView *)web;
在OLEJsbridgeGetUserinfo.m实现方法
#pragma mark 经纬度上传
+(void)uploadGPSInfoWithLongitude:(CGFloat )longitude
Latitude:(CGFloat)latitude
Array:(NSArray *)arr
WebView:(WKWebView *)web{
NSDictionary * dic = @{@"longitude":@(longitude)?:@"",@"latitude":@(latitude)?:@""};
NSString *payCb = [NSString stringWithFormat:@"%@(%@)",[arr lastObject] ,[YMBaseMethod convertToJsonData:dic]];
[web evaluateJavaScript:payCb completionHandler:^(id _Nullable obj, NSError * _Nullable error) {
if (error) {
NSLog(@"%@",error.description);
}
}];
}
3.4在YMBaseWebViewController.m配置交互方法
#pragma mark - webView 配置
- (void)webConfigNew{
[self.config.userContentController addScriptMessageHandler:[[WeakScriptMessageDelegate alloc] initWithDelegate:self] name:adjustGetGPSInfo];
}
在YMBaseWebViewController.m销毁交互方法
- (void)dealloc {
[self.config.userContentController removeScriptMessageHandlerForName:adjustGetGPSInfo];
}
3.5在YMBaseWebViewController.m网页加载完成代理方法中实现定位功能
//加载完成
- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {
NSLog(@"加载完成");
[self.loadingLab removeFromSuperview];
BOOL location = [YMLocationTool isOpenLocationStart];
if (location == NO) {
//无定位权限
UIAlertController *alert =[UIAlertController alertControllerWithTitle:@"Attention" message:@"You must turn on the location function to use the lending function" preferredStyle:UIAlertControllerStyleAlert];
[alert addAction:[UIAlertAction actionWithTitle:@"OPEN" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {
[YMLocationTool openScheme:@"UIApplicationOpenSettingsURLString"];
}]];
[alert addAction:[UIAlertAction actionWithTitle:@"NO" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {
}]];
[self presentViewController:alert animated:YES completion:nil];
}
}
3.6 添加定位权限
Privacy - Location Always and When In Use Usage Description
Privacy - Location Always Usage Description
Privacy - Location When In Use Usage Description
描述文案:
Using location to help you locate your rough location and provide intelligent network request services
3.7 新增JS交互方法
进入B面控制器请求相机权限、相册权限。
1.新增JS交互方法(相册权限检测):bridgGetPhotoLimit,iOS拦截到这个方法后,判定有无权限,
无权限则弹出提示框,引导用户打开设置,并且return出方法,不再执行后续OC调用JS方法。
有权限则正常执行OC调用JS方法,JS方法名和之前规则相同,会放在wkwebView的message.body中。
2.新增JS交互方法(相机权限检测):bridgGetCameraLimit,同上。
三、添加切换AB面控制功能
通知管理员开发AB面切换接口,将Bundle id 传给后台,在webView中加载后台返回url链接,根据后台返回结果判断显示A面还是B面。
注意:用户首次安装,打开APP后系统的网络权限弹窗可能点击过晚,导致无法完成切换AB面接口的请求,进而无法打开B面,所以开发者要进行接口轮询,直到打开B面为止。
四、测试web容器各个交互方法是否可以成功调用
包括人脸识别、拍照、相册、通讯录上传、选择联系人、获取设备信息、获取APP Name
禁用WKWebView边缘左滑功能,一定要禁用。
_webView.allowsBackForwardNavigationGestures = NO;
五、提审时需要操作
1.更换关键字
instant personal loan app,student mpokket loan,kreditbee,moneyview,ring,branch,navi,truebalance,zype
2.在隐私中添加IDFA权限
六、测试web容器各个交互方法是否可以成功调用
包括人脸识别、拍照、相册、通讯录上传、选择联系人、获取设备信息、获取APP Name