로딩중입니다
[AOS] IGAW 共同集成 : Native Android
8/17/2015 12:02:26 PM

IGAW 共同集成

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

使用 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"/>
* 更新内容 *
在 Android 6.0 版本上由于权限申请弹窗影响用户体验的问题,从 Common 4.2.0 版本以上不必输入 READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE Permission。 
跟踪链接 & adPOPcorn 广告商品使用指南
为了使用跟踪链接或 adPOPcorn 广告商品,必须登录 Google Install Receiver
若没有正常设置 Receiver 的话,无法确认新增启动数据。参考以下链接进行设置 Receiver。
[IGAWorks Google Install Receiver]



Google Play Referrer 设置


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

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


1) Android Studio

为了使用 Goolge Play Referrer,在 build-gradle 上添加如下 dependencies。

dependencies {
  ...  
  compile 'com.android.installreferrer:installreferrer:1.0'
  ...
}

在 Project build-gradle 的 repositories 上添加如下 google() 设置。
buildscript {
   repositories {
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.0.1'
   }
}

allprojects {
   repositories {
       jcenter()
       google()
   }
}


2) 其他开发工具 (包含 Eclipse)

为了在其他工具(包含 Eclipse) 上使用 Google Play Referrer,需添加如下 Installer Library。 [下载] 

Library 添加之后,在 Androidmanifest.xml 上添加如下权限。

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



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>



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

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

<application
    android:name="PACKAGE_NAME.YourCustomApplication"
    ... 中略 ...
>
</application>
以后该 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。
 注意!!  autoSessionTracking 是传感 Android Activity 的状态而启动,所以按服务形式来启动的应用是无法运行。



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

支持 Android 4.0.4 以下版本时,参考以下内容在 Android Activity 上添加 api 进行设置。


为了处理玩家维持 Session 的时间和分析数据等的传送,需要集成 startSession 和 endSession。这个函数必须配对设置。

包括 adbrix 分析使用的 api 集成的 Activity 在内,至少需要集成一个以上的 Activity,在 onResume(), onPause() 调用。

@Override
protected void onResume() {
    super.onResume();
    IgawCommon.startSession(MainActivity.this);
}

@Override
protected void onPause() {
    super.onPause();
    IgawCommon.endSession();
}



GDPR 对接

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

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

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

IgawCommon.gdprForgetMe(MainActivity.this);


+ 需要使用 Process Kill 等方式终止应用吗?

轻质终止进程方式中,无法正常调用 endSession。参考以下文件处理 endSession。

[Process Kill_endSession 集成指南]



IGAWorks add-on 集成

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