로딩중입니다
IGAW 공통 연동 : 안드로이드
3/2/2015 4:53:39 PM

IGAW 공통 모듈

IGAWorks의 모든 서비스는 공통 모듈 + 애드온의 형태로 제공 되고 있습니다.

따라서 애드브릭스, 애드팝콘(오퍼월,DA), 라이브옵스, 프로모션, 쿠폰, 나누 등의 서비스 이용을 위해서는 반드시 공통 연동을 먼저 진행해야 합니다.

IGAW 공통모듈 연동을 통해 앱의 실행 횟수 및 DAU 수치를 확인할 수 있습니다.



AndroidManifest.xml

안드로이드 매니페스트 파일을 수정하여 홈페이지에서 앱 등록 후 발급 받은  앱키해시키, 퍼미션  등을 설정합니다.


<application></application> 태그 안에 아래와 같이 앱키, 해시키를 입력합니다.

<meta-data android:name="igaworks_app_key" android:value="앱키를 설정하세요." />
<meta-data android:name="igaworks_hash_key" android:value="해시키를 설정하세요." />


<manifest></manifest> 태그 안에 필수 퍼미션을 추가합니다. 아래 퍼미션들이 추가되지 않으면 정상적인 서비스 이용이 어려울 수 있습니다.

<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"/>
* 업데이트 안내 *
Common 4.2.0 버전 이상에서는 안드로이드 6.0 버전에서의 권한 요청 팝업 노출 이슈로 인해 게임의 UX를 해칠 수 있기에, READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE 퍼미션을 필수로 요구하지 않습니다. 
트래킹링크 & 애드팝콘 광고 상품 이용 안내
트래킹링크나 애드팝콘 광고 상품을 이용하기 위해서는 반드시 구글 인스톨 리시버를 등록 해야 합니다.
리시버가 정상 설정되지 않으면, 신규실행 여부를 체크할 수 없습니다. 다음 아티클을 참고하여 리시버 설정을 진행합니다.
[IGAWorks 구글 인스톨 리시버 등록 가이드]



Google Play Referrer 설정


Google Play Referrer 설정은 애드브릭스 광고 트랙킹 시 부정 트래픽 방지를 목적으로 사용됩니다.

※ 본 기능은 IgawCommon v4.5.4a 버전 부터 사용할 수 있습니다.


1) 안드로이드 스튜디오

Goolge Play Referrer 를 사용하기 위해서는 app 내  build-gradle 에 아래 dependencies 를 추가합니다.

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

추가로 프로젝트  build-gradle 에 아래와 같이 repositories 내 google() 설정을 추가합니다.
buildscript {
   repositories {
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.0.1'
   }
}

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


2) 이클립스를 포함한 기타 툴

이클립스를 포함한 기타 툴에서 Google Play Referrer 를 적용하기 위해서는 Installer 라이브러리를 추가합니다. [다운로드]

라이브러리 추가 후 Androidmanifest.xml 에 아래 권한을 추가합니다.

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


Auto Session Tracking (안드로이드 4.0.4 이상 사용 가능)

Common 4.4.0a 버전부터 안드로이드 액티비티 상 별도의 설정 없이 Auto Session Tracking 을 지원합니다. 

Auto Session Tracking 을 사용하기 위해서는 앱이 최소 안드로이드 4.0.4 이상을 지원해야 합니다.


SDK에서 제공하는 Application 클래스를 사용할 경우

Androidmanifest.xml 에 아래의 내용을 선언합니다.

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


자체적인 Application 클래스를 사용할 경우

이미 Application 클래스를 사용하고 있다면 Androidmanifest.xml 에 아래의 내용을 선언합니다. 

<application
    android:name="PACKAGE_NAME.YourCustomApplication"
    ... 중략 ...
>
</application>
이후 해당 Application 클래스에 아래 코드를 추가합니다.
public class YourCustomApplication extends Application{
    @Override
    public void onCreate(){
        super.onCreate();
        IgawCommon.autoSessionTracking(YourCustomApplication.this);
        // 어플리케이션 클래스에서는 autoSessionTracking API 외의 어떤 애드브릭스 API도 호출해서는 안됩니다.
    }
      }
 Caution!!  Application 클래스에서는 autoSessionTracking API 외 어떠한 애드브릭스 분석용 API도 호출해서는 안됩니다.
 Caution!!  autoSessionTracking 은 안드로이드 액티비티의 상태변화를 감지하여 동작하므로 서비스 형태로 동작하는 앱의 경우에는 적용을 하지 않습니다.

IGAW 공통 모듈 연동 (안드로이드 4.0.4 이하 버전까지 지원할 경우)

앱이 안드로이드 4.0.4 이하 버전까지 지원하실 경우 아래와 같이 Android Activity 에 api 를 추가로 연동합니다.


유저의 세션 유지 시, 분석 데이터의 전송 등을 처리하기 위해 startSession과  endSession을 연동합니다. 이 함수들은 반드시 짝을 이루어 세팅 되어야 합니다.

애드브릭스 분석용 api가 연동된 Activity 를 포함하여 최소한 1개 이상의 Activity에 연동되어 있어야 하며,  onResume(), onPause() 에서 호출합니다.

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

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


GDPR 연동

GDPR 이벤트를 호출하여 호출 시점 이후부터 SDK 동작을 막을 수 있습니다. 

자세한 내용은 아래 연동 가이드를 참고하여 연동해 주시길 부탁드립니다.

[GDPR 활성화 연동 가이드]


+ Process Kill 등의 방식으로 어플리케이션 종료를 처리하십니까?

프로세스를 강제로 종료하는 방식에서는 endSession이 정상 호출되지 않습니다. 추가 가이드를 참고하여 endSession 호출을 처리합니다.

[Process Kill 사용 시 endSession 연동 가이드]



IGAWorks 애드온 연동

공통 연동이 마무리 되셨다면, 각 서비스 별 가이드를 참고하여 애드온 연동을 진행합니다.