03. SDK for Java

SDK Installation

gradle을 이용하여 SDK 설정이 가능합니다.

Maven Settings

프로젝트 수준 build.gradle에 다음과 같이 maven을 추가합니다.

repositories {
    google()
    mavenCentral()
 
    maven{
        url "https://repo.onestore.co.kr/repository/onestore-sdk-public"
    }
}

Dependency Settings

앱 수준 build.gradle에 다음과 같이 dependency를 추가합니다.

dependencies {
    ...
    implementation 'com.oneadmax.sdk:sdk-ads:1.2.1'
    ...
}

필수 Permission 설정

다음의 필수 권한이 Android Manifest에 추가되어 있어야 합니다.

<manifest>
...
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
...
</manifest>

---

ONE AdMax SDK

매체키 등록

Android Manifest의 application 태그 내에 ONE AdMax 콘솔에서 발급 받은 매체 키를 추가합니다.

<manifest>
    ...
    <application>  
        <meta-data android:name="com.oneadmax.global.appkey" android:value="your_app_key" />
    </application>
     ...
</manifest>

SDK 초기화

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate( savedInstanceState );
    ...
     
    if( ONEAdMax.isInit( MyActivity.this ) == false ){
        ONEAdMax.init( MyActivity.this, new IOAMInitListener() {
            @Override
            public void onInitialized() {
                Log.d( Tag, "ONEAdMax SDK Initialized.");
            }
        });
    }
    ...
}

SDK 해제

어플리케이션이 종료될 때 메모리에 할당된 리소스( View, Memory )를 해제합니다. 앱이 종료될 때 호출되는 activity의 onDestroy()에서 호출합니다.

@Override
protected void onDestroy() {
    // TODO Auto-generated method stub 
    super.onDestroy();  
     
    ...
 
    ONEAdMax.unInit();
}

Log Settings

ONE AdMax SDK의 로그를 활성 또는 비활성화 합니다.

ONEAdMax.setLogEnable( true ); // default false

GDPR Settings

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 사용합니다. GDPR 동의가 필요한 유저에 한해 다음 API를 호출합니다.

ONEAdMax.gdprConsentAvailable( false ); // Default : true

COPPA Settings

COPPA(Children's Online Privacy Protection Rule)법안에 대응하기 위해 아래 API를 추가 합니다. 해당 디바이스에서는 모든 광고 타입의 광고 요청에 대해 No ad 처리 됩니다. (기본값: false)

ONEAdMaxClient.tagForChildDirectedTreatment(true);