unity集成使用openinstall

目的

一、Unity集成openinstall sdk？即免填邀请码安装的渠道追踪统计服务

最近在使用一个叫openinstall的SDK，经过它实现免填邀请码的功能，集成到unity游戏开发中。对App安装流程的优化，尤为是免填写邀请码安装，App推广的有奖邀请活动更大程度的达到推广爆炸式的效果。

在分享连接自定义各类动态参数（如推广渠道号，邀请码，游戏房间号，用户id等等）。经过在分享连接url中附带app邀请人的用户id，就可达到免填邀请码的效果;或者app经过在url中附带游戏房间号实现直达游戏房间也可创建上下级关系；unity开发中免不了邀请用户得到奖励；新老用户直达游戏场景；从各类浏览器一键拉起游戏场景等等；

那么如何在unity集成openinstall呢？是的，没错，openinstall平台整合了方便 unity 集成使用 openinstall的方案步骤

注册/登陆openinstall开发者平台http://developer.openinstall.io/并建立应用

能够参考官方文档

导入 openinstall.unitypackage

右击 Assets ，选择 Import Package 中的 Custom Package...

在文件选择框中选中 openinstall.unitypackage，导入全部文件

将 Assets/Plugins/OpenInstall 下的 OpenInstall.prefab 拖入对应的场景中使用 openinstall 实现业务逻辑

平台配置

iOS 平台

无需写一句Object-C代码，只需进行以下配置

备注：
一、若是用户使用了 IMPL_APP_CONTROLLER_SUBCLASS 宏生成本身的 customAppController,请在本身的 customAppController 中添加初始化方法和拉起回调方法，并删除掉 Assets/Plugins/iOS/libs 中的 CustomAppController.mm 文件；
二、若是用户使用了 iOS9.0 新 API application:openURL:options:，请在新 API 中添加 if ([OpenInstallSDK handLinkURL:url]) return YES; 回调判断

初始化配置

在 Info.plist 文件中配置 appKey 键值对，以下：

<key>com.openinstall.APP_KEY</key> <string>从openinstall官网后台获取应用的appkey</string>

universal links配置（iOS9之后推荐使用）

对于iOS，为确保能正常跳转，AppID必须开启 Associated Domains 功能，请到 苹果开发者平台，选择 Certificate, Identifiers & Profiles，选择相应的 AppID，开启 Associated Domains。注意：当 AppID 从新编辑过以后，须要更新相应的 mobileprovision 证书。(详细步骤请看openinstall官网后台文档，universal link需从后台获取)

scheme配置

在 Info.plist 文件中，在 CFBundleURLTypes 数组中添加应用对应的 scheme

	<key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleTypeRole</key> <string>Editor</string> <key>CFBundleURLName</key> <string>openinstall</string> <key>CFBundleURLSchemes</key> <array> <string>"从openinstall官网后台获取应用的scheme"</string> </array> </dict> </array>

Android 平台

将 sample 目录中的 AndroidManifest.xml 文件拷贝到项目的 Assets/Plugin/Android/ 目录下，并修改文件内容：将 openinstall 为应用分配的 appkey 和 scheme 替换至相应位置
备注：如已存在 AndroidManifest.xml，请参考文件进行合并处理

使用指南

使用 OpenInstall 以前，请先导入命名空间

using io.openinstall.unity;

而后经过 GameObject 获取 OpenInstall 实例

private OpenInstall openinstall;
// Use this for initialization void Start () { openinstall = GameObject.Find("OpenInstall").GetComponent<OpenInstall>(); }

获取拉起数据

在 Start 方法中，获取到实例以后注册拉起回调，这样当 App 被拉起时，会回调方法，并可在回调中获取拉起数据

openinstall.registerWakeupHandler(getWakeupFinish);

public void getWakeupFinish(OpenInstallData wakeupData) { Debug.Log("OpenInstallUnity getWakeupFinish : 渠道编号=" +wakeupData.channelCode + "， 自定义数据=" + wakeupData.bindData); }

获取安装数据

在应用须要安装参数时，调用如下 api 获取由 SDK 保存的安装参数，可设置超时时长，单位秒

openinstall.getInstall(8, getInstallFinish);

public void getInstallFinish(OpenInstallData installData) { Debug.Log("OpenInstallUnity getInstallFinish : 渠道编号=" + installData.channelCode + "，自定义数据=" + installData.bindData); }

渠道统计

SDK 会自动完成访问量、点击量、安装量、活跃量、留存率等统计工做。其它业务相关统计由开发人员代码埋点上报

注册上报

在用户注册成功后，调用接口上报注册量

openinstall.reportRegister();

效果点上报

统计终端用户对某些特殊业务的使用效果，如充值金额，分享次数等等。调用接口前，请先进入 openinstall 管理后台 “效果点管理” 中添加效果点，第一个参数对应管理后台 效果点ID

openinstall.reportEffectPoint("effect_test", 1);

打包测试