모달 광고

모달 형태의 광고를 제공 합니다.

모달 광고는 v.3.3.9 버전 부터 지원합니다.

1. 모달 광고 인스턴스 생성

아래 코드를 추가하여 네이티브 광고 인스턴스를 생성 합니다.

JAVA

public class MainActivity extends Activity{
    private AdPopcornSSPModalAd modalAd;
     	
    @Override
    protected void onCreate(Bundle savedInstanceState) {
    	modalAd = new AdPopcornSSPModalAd(this);
    }
}

Kotlin

private var modalAd: AdPopcornSSPModalAd? = null
    	
override fun onCreate(savedInstanceState: Bundle?) {
	modalAd = AdPopcornSSPModalAd(this@MainActivity)
}

2. 모달 광고 Placement ID 설정

아래 코드를 추가하여 모달 광고PLACEMENT ID 를 설정합니다. 모달광고 PLACEMENT ID 는 애드팝콘 SSP 콘솔에서 생성이 가능합니다.

JAVA

modalAd.setPlacementId("모달_PlacementId");

Kotlin

modalAd?.setPlacementId("모달PlacementId")

3. 모달 광고 타입 설정

아래 코드를 추가하여 모달 광고의 타입을 설정 합니다.

JAVA

modalAd.setCloseBtnType(AdPopcornSSPModalAd.CloseBtnType.CLOSE_AD);

Kotlin

modalAd?.setCloseBtnType(AdPopcornSSPModalAd.CloseBtnType.CLOSE_AD);

지원하는 닫기 형태는 2가지로 아래와 같습니다.

type	설명
CLOSE_AD	광고 닫기
DO_NOT_SHOW_TODAY	오늘 하루 안보기

4. 모달 광고 요청

모달 광고 노출을 원하는 시점에 loadAd() API 를 호출하여 서버에 광고를 요청합니다.

JAVA

modalAd.loadAd();

Kotlin

modalAd?.loadAd();

loadAd 호출에 대한 결과로 광고 수신에 실패한 경우에는 loadAd 재호출을 하시면 안됩니다. 과도한 광고 요청 api 호출은 block 사유가 됩니다.

5. 모달 광고 노출

모달 광고 노출 시점에 showAd() API 를 추가하여 광고를 노출합니다.

JAVA

modalAd.showAd();

Kotlin

modalAd?.showAd();

6. 모달 광고 이벤트 리스너

모달 광고에서 발생하는 이벤트를 받고자 할 경우 , 이벤트 리스너를 생성하여 전달해 줍니다.

이벤트 리스너를 통해 들어오는 이벤트들을 아래와 같습니다.

이벤트 리스너	설명
OnModalAdLoaded	모달 광고 요청 성공 시
OnModalAdLoadFailed	모달 광고 요청 실패 시. 에러코드 값
OnModalAdOpened	모달 광고가 화면에 노출되었을 때
OnModalAdOpenFailed	모달 광고 화면 노출 실패 시
OnModalAdClosed	모달 광고 닫음
OnModalAdClicked	모달 광고 클릭

JAVA

modalAd.setModalAdEventCallbackListener(new IModalAdEventCallbackListener() {
    @Override
    public void OnModalAdLoaded() {
        Toast.makeText(MainActivity.this, "OnModalAdLoaded", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void OnModalAdLoadFailed(SSPErrorCode errorCode) {
        Toast.makeText(MainActivity.this, "OnModalAdLoadFailed", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void OnModalAdOpened() {
        Toast.makeText(MainActivity.this, "OnModalAdOpened", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void OnModalAdOpenFailed(SSPErrorCode errorCode) {
        Toast.makeText(MainActivity.this, "OnModalAdOpenFailed", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void OnModalAdClosed() {
        Toast.makeText(MainActivity.this, "OnModalAdClosed", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void OnModalAdClicked() {
        Toast.makeText(MainActivity.this, "OnModalAdClicked", Toast.LENGTH_SHORT).show();
    }
});

Kotlin

modalAd?.setModalAdEventCallbackListener(object: IModalAdEventCallbackListener {
    override fun OnModalAdLoaded() {
    }
    
    override fun OnModalAdLoadFailed(SSPErrorCode errorCode) {
    }
    
    override fun OnModalAdOpened() {
    }
    
    override fun OnModalAdOpenFailed(SSPErrorCode errorCode) {
    }
    
    override fun OnModalAdClosed() {
    }
    
    override fun OnModalAdClicked() {
        
    }
});