애드박스 SDK 공통 연동 가이드

1. 개요

이 가이드는 애드박스 SDK 공통 연동 방법을 기술한 가이드 문서입니다.


2. SDK 다운로드

애드박스 SDK v2.1.1 다운로드 (등록일 : 2018-04-12)


3. 프로젝트에 SDK 추가

안드로이드 스튜디오 프로젝트

다운로드 받은 adbox_sdk~*.jar 파일과 android-support-v4.jar 파일을 app/libs 폴더에 복사합니다.

이클립스 프로젝트

다운로드 받은 adbox_sdk~*.jar 파일과 android-support-v4.jar 파일을 Project/libs 폴더에 복사합니다.

4. SDK 공통 연동

4-1. AndroidManifest.xml 설정

AndroidManifest.xml 에 다음 권한을 추가합니다.
<uses-permission android:name="android.permission.INTERNET"/>

AndroidManifest.xml 의 <application></application> 태그 안에 ADBoxAdActivity를 추가합니다.
<activity
   android:name="com.ha.adbox.sdk.ADBoxAdActivity"
   android:label="@string/app_name"
   android:windowSoftInputMode="stateAlwaysHidden"
   android:screenOrientation="portrait"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

4-2. 초기화

앱 실행 시 최초에 시작되는 Activity (ex.인트로 이미지(스플래시 이미지)가 노출되는 Activity 등) 의 onCreate()에서 ADBoxAd.init(activity, appKey) 메소드를 호출합니다.
appKey에 발급받으신 앱 키를 입력해주세요.
ADBoxAd.init(this, appKey);

4-3. 광고 노출

ADBoxAd.show(context, spotKey) 메소드를 호출합니다.
spotKey에 발급받으신 스팟 키를 입력해주세요.
※ 애드월, 참여하기, 전면 배너 광고, 팝업 배너 광고 모두 동일한 메소드를 사용합니다.
ADBoxAd.show(this, spotKey);

4-4. 종료 이벤트 리스너 설정

광고 노출 전 ADBoxAd.setOnClosedListener(context, spotKey, onClosedListener) 메소드를 통해 광고 종료시 동작을 설정할 수 있습니다.
spotKey에 종료 이벤트 리스너를 설정할 광고의 스팟 키를 입력해주세요.
ADBoxAd.setOnClosedListener(this, spotKey, new OnClosedListener() {
   @Override
   public void onClosed(Context arg0) {
      //광고 종료시 동작 설정
   }
});

※ SDK 추가 연동

애드월 연동 가이드 : http://www.adbox.co.kr/guide/adwall.php
참여하기 연동 가이드 : http://www.adbox.co.kr/guide/play_sdk.php