在项目开发过程中,负责的推广二维码模块需要加入openinstall三方框架,该框架可以在推广二维码中搭建一层上下级关系,加上一定的积分奖励,极大地提高了用户的推广热情,并且不同于以往常规的手动填写邀请码,该框架可以实现邀请码免填、携带参数等功能,以下对该框架的使用心得和步骤做下简单的归纳和整理。
1.首先登录openinstall官方平台
链接:https://www.openinstall.io/
2.完成常规的注册登录
3.下载AndroidSDK
4.SDK下载完成解压后,发现是一个jar包
5.将该jar包拷贝到项目project下的libs文件夹中,添加依赖完毕
6.在AndroidManifest清单文件中添加一下相关权限
<uses-permission android:name= "android.permission.INTERNET"/>
<uses-permission android:name= "android.permission.ACCESS_NETWORK_STATE"/>
7.在AndroidManifest清单文件中的application标签内设置AppKey,此处AppKey填写你在控制台新建应用后系统分配的key值
<meta-data
android:name="com.openinstall.APP_KEY"
android:value="填写控制台对应应用的Appkey值"/>
8.在应用的自定义Application中初始化
public class MyApplication extends Application{
public void onCreate(){
super.onCreate();
if(isMainProcess){
//如果应用有多个进程,确保只在主线程中初始化
OpenInstall.init(this);
}
}
public boolean isMainProcess(){
int pid= android.os.process.myPid();
ActivityManager activityManager= (ActivityManager)getSystemService(Context.ACTIVITY_SERVICE);
for(ActivityManager.RunningAppProcessInfo appProcess: activityManager.getRunningAppProcess()){
if(appProcess.pid== pid){ returngetApplicationInfo().packageName.equals(appProcess.processName);
}
}
return false;
}
}
9.配置一键拉起。
在AndroidManifest的唤醒页面activity标签中添加intent-filter,一般都是启动页面StartActivity,配置schema
<activity
android:name=".StartActivity'
android:launchMode="singleTask" >
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="android.intent.category.BROWSABLE"/>
<data android:schema="填写控制台对应应用的Appkey值"/>
</intent-filter>
</activity>
10.在我们的需求中,如果推广给新用户,在注册时,要把分享人的手机号同样上传,该手机号就是我们拼接的手机号,这里在注册页面我们通过openinstall提供的方法获取
OpenInstall.getInstall(new AppInstallAdapter(){
public void onInstall(AppData appData){
//获取渠道数据
String channelCode= appData.getChannel();
//获取自定义数据
String bindData= appData.getData();
Log.d("OpenInstall", "getInstall: installData= "+ appData.toString());
}
})
如果配置无误,返回的参数就是这样的 ,phone即我们拼接的参数,也可拼接多个,字段任意,拼接什么参数返回就是什么参数,之后进行JSONObject解析,就可获取对应字段的值了,之后我们在注册用得到。
11.然后把APP托管到该平台上
12.完成基本的参数配置后,我们进入功能集成环节。
在我们项目需求中,我们需要由H5前端开发给我们提供一个集成openinstall WebBanner的网页链接,前端具体实现我们移动端不了解,只需要把控制台对应应用的webbanner发给他,由其配置后提供一个链接即可
13.等网页这边配置完毕后,拿到链接,打开就是这样的
这个页面的布局可以由UI和H5自定义,这里只是简单一个APP的logo,文字,下面有个“进入”的按钮,具体点击后的功能我们下来再说。
14.接下来,我们给后台给的链接后拼接当前用户登录的手机号,字段任意,比如字段设为phone
http://xxxxxxxxxxxxxxxxxxxxxxxxxxxx?phone=12345678911
为什么要拼接当前用户登录的手机号(帐号)?这样分享出去的二维码实则就跟该用户绑定了,因此给别人推广成功后,当前用户自动就会成为对方的上级关系,至于具体实现上下级关系的细节,我们下来再陈述。
15.然后把这个拼接后的链接塞到二维码中,这里我用的是zxing框架,具体使用方法就不在这里详述了。
String shareUrl= "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx?phone="+ phoneNumber;
bitmap= ZxingUtils.createQRImage(shareUrl, 250, 250, null);
16.将二维码图片分享出去,这里用的MobShareSDK分享框架,具体使用方法不在这里详述,不熟悉可以看下我之后整理的相关博客。
别人得到二维码图片,通过扫描或者长按识别打开我们拼接参数后的网页。点击 "进入" 按钮。这时会出现两种情况。
1)如果别人手机已安装这款应用,因为我们配置过schema,会自动拉起应用
2)如果别人手机没有这款应用,因为我们托管过app,所以会启动下载,该处也可填写第三方托管平台,比如fir,之后正式上线应用市场比如应用宝之类,再填写正式的下载链接即可。
17.下载完毕后,进入新用户注册,因为我们之前在注册页面已写了获取推广人手机号的步骤,所以请求注册接口时将该参数填入即可,如果用户没有推广人,比如是自己通过其他渠道下载,那该参数就是返回空,不影响注册。
注册成功后,可以在后台检测新用户的上级字段是否有值,有值则成功。
至此全部完成!