원스토어 Ads 래핑 가이드(내부용)

본 가이드는 원스토어 측의 래핑을 위한 SDK 버전 연동 가이드입니다.

1. SDK 다운로드 및 설정

위 SDK는 Gradle을 통해 배포되지 않고 AAR 형식의 라이브러리로 제공됩니다. 아래 링크에서 다운로드 하시기 바랍니다.

v0.3.2 : 2024-03-29

708KB

OnestoreAds_v0.3.2.zip

archive

867KB

OnestoreAds_v0.3.2_debug.zip

archive

이전 라이브러리는 [라이브러리 목록 페이지]에서 확인해주세요.

다운로드 받은 .zip 파일을 압축 해제하여 OnestoreAds~*.aar 파일을 안드로이드 스튜디오 프로젝트로 복사한 후 gradle 을 업데이트합니다.

1) Gradle 설정

SDK 복사 후 아래와 같이 build.gradle(앱 레벨) 에 dependiencies 를 추가하고 업데이트 합니다.

dependencies { 
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile(name: 'OnestoreAds_v0.3.1, ext: 'aar')
    repositories { flatDir { dirs 'libs' } }
}

2. 필수 코드 연동

애드팝콘 SSP에서는 띠배너, 전면, 네이티브, 리워드 비디오 형태의 광고를 제공합니다. 각 광고의 형태에 따라서 연동을 진행하기 전에 기본 API를 이용하여 초기화 작업을 해야 합니다.

1) SSP SDK 초기화

init API를 어플리케이션 실행 후 최초로 로드되는 activity 혹은 SSP 광고를 노출하고자 하는 activity에서 호출하여 SDK를 초기화합니다. 단, init 중복 호출 시, 그 사이에 세팅된 광고가 초기화 됨으로 중복 호출을 방지하고자 할 때에는 isInitialized API를 통해 초기화 작업이 완료된 상태인지 체크하시기 바랍니다.

init API에 SdkInitListener를 통해 onInitializationFinished 이벤트 콜백을 수신 한 뒤, 광고 요청 하는 방식을 추천합니다.

if(AdPopcornSSP.isInitialized(MyDisplayAdSampleActivity.this){
	// Already SSP SDK initialized
}
else{
	AdPopcornSSP.init(MyDisplayAdSampleActivity.this, "앱키", new SdkInitListener() {
	    @Override
	    public void onInitializationFinished() {
	        // init 작업이 완료 된 뒤, 광고 로드 작업을 진행해 주시기 바랍니다.
	    }
	});
}

2) 리소스 해제

destroy API를 이용하여 어플리케이션이 종료될 때 메모리에 할당된 SSP 관련 리소스(View,Memory)를 해제합니다.

앱이 종료될 때 호출되는 activity의 onDestroy()에서 호출합니다.

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

3) GDPR 설정

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 추가 합니다.

GDPR 동의 여부 세팅을 위해 아래의 API가 추가 되었습니다.

기본 값은 True이고 GDPR 동의가 필요한 유저에 한해 gdprConsentAvailable API를 호출하시기 바랍니다.

AdPopcornSSP.gdprConsentAvailable(false);