IGAW 共同集成 : Unity Android

IGAWorks 的所有服务是以共同模板 + add-on 的形式提供。

为了 Unity Android Project，在提供包含共同模板 + add-on 的 Unity Package。

使用 adbrix、adPOPcorn(积分墙，DA)、LiveOps、交叉推广、优惠券、Nanoo 等服务时，必须先集成共同集成事项。

通过 IGAW 共同集成，可以分析应用启动次数及日活跃用户(DAU) 等的数据。

※ 集成前必须先确认 SDK 是否为最新版本。不清楚 SDK 版本时，请进入 [SDK 下载] 确认。

AndroidManifest.xml

修改 AndroidManifest 文件 > 在 adbrix 网站中登录游戏后，使用获取的 AppKey、HashKey、Permission 等进行设置。

<application></application> 在标签中如下添加 AppKey、HashKey。

<meta-data android:name="igaworks_app_key" android:value="设置 AppKey" />
<meta-data android:name="igaworks_hash_key" android:value="设置 HashKey" />

<manifest></manifest> 在标签内添加所需的 Permission。未添加 Permission 时无法正常使用服务。

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- 选项值 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

跟踪链接 & adPOPcorn 广告商品使用指南
为了使用跟踪链接或 adPOPcorn 广告商品，必须登录 Google Install Receiver。
若没有正常设置 Receiver 的话，无法确认新增启动数据。参考以下链接进行设置 Receiver。
[IGAWorks Google Install Receiver]

Google Play Referrer 设置

Google Play Referrer 设置是以 "在 adbrix 后台上监测广告效果时，预防异常流量" 为目的。

为了使用 Goolge Play Referrer， 需添加如下 Installer Library。[下载链接]

添加 Library 后，在 Androidmanifest.xml 上再添加如下权限。

   <uses-permission android:name="com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE"/>

※ 本功能是从 IgawCommon v4.5.4a 以上的版本才能使用。

Auto Session Tracking (支持 Android 4.0.4 以上时参考如下)

从 Common 4.4.0a 版本开始支持。无设置 Activity 的 Auto Session Tracking 功能。 

为了使用 Auto Session Tracking，至少支持 Android 4.0.4 以上的版本。

[使用 SDK 提供的 Application Class 情况时]

在 Androidmanifest.xml 上声明如下代码。

<application
    android:name="com.igaworks.IgawDefaultApplication"
</application>

以后进行初始化 Plugin。

// 声明 using 指示。
using IgaworksUnityAOS;

public class MySampleScene : MonoBehavior { 
    void Awake() {
        //Unity Engine 初始化时，需同时初始化 IGAW Plugin。
        IgaworksUnityPluginAOS.InitPlugin ();
    }
}

[使用自己的 Application Class 情况时]

若已使用自己的 Application Class 时，在 Androidmanifest.xml 上声明如下代码。

<application
    android:name="PACKAGE_NAME.YourCustomApplication"
</application>

以后在 Android Studio 上 import 后，在 Application Class 上添加如下代码。

public class YourCustomApplication extends Application{
    @Override
    public void onCreate(){
        super.onCreate();
        IgawCommon.autoSessionTracking(YourCustomApplication.this);
        // 在 Application class 上除了 autoSessionTracking API 外，不需调式任何分析用的 adbrix API。
    }
}

注意!  在 Application  Class 里除了 autoSessionTracking API  外，不需调式任何分析用的 adbrix API。

IGAW 共同模板集成 (支持 Android 4.0.4 以下时参考如下)

支持 Android 4.0.4 以下版本时，参考以下内容进行 Plugin 初始化及集成基本分析 API。

Plugin 初始化

启动应用后，Unity 初始化时调用 init 和 startApplication api 进行调用初始化 Plugin。

// 指定 using 指示文
using IgaworksUnityAOS;

public class MySampleScene : MonoBehavior { 
    void Awake() {
        //初始化时，也初始化 IGAW Plugin
        IgaworksUnityPluginAOS.InitPlugin ();
    }
}

+ init api 的作用是链接 Unity Plugin 和 Android Native SDK。

+ startApplication api是初始化 Native SDK 功能。

基本分析 API

调用 startSession, endSession api，处理用户维持 Session 的时间、分析数据的传送。

这两个函数必须配对设置。

应用转化为 foreground 或 background 时进行调用。

public class MySampleScene : MonoBehavior {
 
    //启动应用
    void Start()
    {
        //Unity 5.3 以下版本首次启动应用时，不 return OnApplicationPause 参数。由此需要直接调用 startSession。      
        #if UNITY_5_3_OR_NEWER
            Debug.Log("Current Unity version is UNITY_5_3_OR_NEWER");
        #else            
            IgaworksUnityPluginAOS.Common.startSession();
        #endif
    }
 
    //确认应用状态
    void OnApplicationPause(bool pauseStatus){
        
        if (pauseStatus) {
	    Debug.Log ("go to Background");
	    IgaworksUnityPluginAOS.Common.endSession();
	} else {
	    Debug.Log ("go to Foreground");
	    IgaworksUnityPluginAOS.Common.startSession();
	}
} 

+ Unity 5.3 以下版本首次启动应用时，不 return OnApplicationPause 参数。由此在 Start() 时点上直接调用 startSession。

GDPR 对接

调用 GDPR 事件，可以挡住 GDPR 事件调用以后的所有 SDK 动作。(停顿 SDK 功能)

本事件调用以后，无法参与并使用 Adbrix 数据传送、LiveOps 推送及弹窗、adPOPcorn 广告。

用户删除应用后再次安装前，不能恢复 GDPR 适用的内容。

IgaworksUnityPluginAOS.common.gdprForgetMe();

IGAWorks add-on 集成

完成共同集成后，请参考各项服务的指南，进行 add-on 集成。