unity 集成使用 openinstall

目的

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

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

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

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

可以参考官方文档

导入 openinstall.unitypackage

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

在文件选择框中选中 openinstall.unitypackage，导入所有文件

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

平台配置

iOS 平台

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

备注：
1、如果用户使用了 IMPL_APP_CONTROLLER_SUBCLASS 宏生成自己的 customAppController,请在自己的 customAppController 中添加初始化方法和拉起回调方法，并删除掉 Assets/Plugins/iOS/libs 中的 CustomAppController.mm 文件；
2、如果用户使用了 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);

打包测试