커스텀 타입(Android)

본 문서는 비공개 문서이며 Android 환경에서 커스텀 타입 광고용 API 가이드 입니다.

아래 가이드에는 커스텀 타입 광고 타입에 대해 설명 하고 있으며, 기본적인 연동은 애드팝콘 SSP 정식 가이드 사이트에서 확인하시기 바랍니다.

커스텀 광고?

SDK를 통해 자동으로 광고를 노출하지 않고 광고 노출에 필요한 정보를 받아 직접 광고를 노출 시켜주는 수동 광고 타입

1. 기본 연동

애드팝콘 SSP SDK Android 기본 설정을 참고하시고 아래 사항 SSP SDK 기본 연동 진행이 필요합니다.

  • SDK 다운로드 및 설치

  • 매니페스트 설정

  • 필수 코드 연동

2. 인스턴스 생성

커스텀 광고를 요청하기 위해 인스턴스 생성 및 추가합니다.

JAVA
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;

	@Override
	Protected void onCreate(Bundle savedInstanceState){
	    adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
	}

3. PlacementId 설정

아래 코드를 추가하여 커스텀 광고의 PLACEMENT ID 를 설정합니다. PLACEMENT ID 는 애드팝콘 SSP 콘솔페이지에서 생성이 가능합니다.

JAVA
@Override
	Protected void onCreate(Bundle savedInstanceState){
		adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
		adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
	}

4. 광고 타입 설정

커스텀 placement의 광고 타입을 정의합니다.

parameter설명

CustomAdType.BANNER_320x50

배너 320x50 사이즈

CustomAdType.BANNER_300x250

배너 300x250 사이즈

CustomAdType.BANNER_320x100

배너 320x100 사이즈

CustomAdType.INTERSTITIAL

전면 광고

CustomAdType.NATIVE_AD

네이티브 광고

JAVA
@Override
	Protected void onCreate(Bundle savedInstanceState){
		adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
		adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
		adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
	}

5. 이벤트 리스너 설정

광고 요청에 대한 결과를 전달 받을 이벤트 리스너를 등록합니다.

이벤트 리스너설명

OnCustomAdReceiveSuccess

광고 요청에 성공한 경우. adData에 광고 정보가 넘어옵니다.

OnCustomAdReceiveFailed

광고 요청에 실패한 경우

JAVA
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;

	@Override
	Protected void onCreate(Bundle savedInstanceState){
            adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
            adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
            adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
            adpopcornSSPCustomAd.setCustomAdEventCallbackListener (new ICustomAdListener(){
                        @Override
                        public void OnCustomAdReceiveSuccess (String placementId, , String adData) {
                
                        }

                        @Override
                        public void OnCustomAdReceiveFailed (String placementId, SSPErrorCode code) {

			}
            });
	}
  • 각 광고 타입별 성공 시 adData 예시는 아래와 같습니다.

<html><head><style>html,body{overflow:hidden;position:relative;width:100%;heigh
t:100%;margin:0;padding:0}</style></head>><body>
<a href="https://partners.igaworks.com/"target="_blank">
<img src="https://adpopcorn-ssp/test_campaign/300x250.JPG" width="300"
height="250" /></a></body></html><style>
html,body{overflow:hidden;position:relative;width:100%;height:100%;margin:0;paddin
g:0}</style>

6. 광고 요청

광고 요청 시점에 load API 호출하여 서버에 광고를 요청합니다.

JAVA
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;

	@Override
	Protected void onCreate(Bundle savedInstanceState){
            adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
            adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
            adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
            adpopcornSSPCustomAd.setCustomAdEventCallbackListener (new ICustomAdListener(){
                        @Override
                        public void OnCustomAdReceiveSuccess (String placementId, , String adData) {
                
                        }

                        @Override
                        public void OnCustomAdReceiveFailed (String placementId, SSPErrorCode code) {

			}
            });
            adpopcornSSPCustomAd.loadAd();
	}

7. 광고 노출, 클릭 리포트 수집

커스텀 광고 타입의 경우 매체가 직접 광고물을 노출시키고, 클릭 처리를 해주어야 하기에 반드시 아래 두 API를 적절한 시점해 호출해 주는 연동을 진행해 주어야 정확한 데이터 수집이 가능합니다.

JAVA
// 광고 노출 시점에 호출
adpopcornSSPCustomAd.reportImpression();
    
// 광고 클릭 시점에 호출
adpopcornSSPCustomAd.reportClick();

위 연동 중 궁금하신 사항이나 수정이 필요한 부분이 있으면 애드팝콘 사업팀(pm@adpopcorn.com)으로 메일 주시기 바랍니다.

Last updated