04. SDK for Java

SDK Installation

gradle을 이용하여 SDK 설정이 가능합니다. (You can configure the SDK using gradle.)

Maven Settings

프로젝트 수준 build.gradle에 다음과 같이 maven을 추가합니다. (Add maven to your project level build.gradle as follows:)

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

Dependency Settings

앱 수준 build.gradle에 다음과 같이 dependency를 추가합니다. (Add the dependency to your app level build.gradle as follows:)

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

필수 Permission 추가 및 확인(Adding and Verifying Required Permissions)

다음의 필수 권한이Android Manifest에 추가되어 있어야 합니다. (The following essential permissions must be added to your Android Manifest as follows:)

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

ONE AdMax SDK

매체키 등록(Media Key Registration)

ONE AdMax 콘솔에서 발급받은 매체키는 다음과 같이 Android Manifest의 application 태그 내에 추가해야 합니다. (The media key issued by the ONE AdMax console must be added within the application tag of your Android Manifest as follows:)

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

SDK 초기화(SDK Initialize)

ONE AdMax SDK 에서는 다양한 형태의 광고를 제공하며, 각 세부 광고를 사용하기 전에 SDK 초기화 작업을 해야 합니다. (The ONE AdMax SDK offers various types of ads, and you need to initialize the SDK before using any specific ad formats.)

@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 해제(SDK Destroy)

어플리케이션이 종료될 때 메모리에 할당된 리소스( View, Memory )를 해제합니다.

앱이 종료될 때 호출되는 activity의 onDestroy()에서 호출합니다. (Delete allocated resources (View, Memory) when the application is about to close. Call this in the onDestroy() method of the activity that gets called when the app is closing.)

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

Log Settings

ONE AdMax SDK의 로그를 활성 또는 비활성화 합니다. (Enable or disable logs for the ONE AdMax SDK.)

ONEAdMax.setLogEnable( true ); // default false

GDPR Settings

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 사용합니다. GDPR 동의가 필요한 유저에 한해 다음 API를 호출하시기 바랍니다. (To comply with the EU's General Data Protection Regulation (GDPR), use the following API. Call the following API for users who require GDPR consent.)

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

COPPA Settings

COPPA(Children's Online Privacy Protection Rule)법안에 대응하기 위해 아래 API를 추가 합니다. 해당 디바이스에서는 모든 광고 타입의 광고 요청에 대해 No ad 처리 됩니다. (기본값: false) (To comply with the Children's Online Privacy Protection Rule (COPPA), we've added the following API. This API will ensure that no ads are served on devices where this setting is enabled. (Default: false))

ONEAdMaxClient.tagForChildDirectedTreatment(true);