배너 광고

배너는 SSP의 가장 일반적인 광고 형태로 앱의 하단이나 상단에 노출되는 띠 형태의 광고입니다.

1. 인스턴스 생성

배너 광고 인스턴스를 생성합니다. 인스턴스 생성시 배너 사이즈와 배너가 위치할 gravity 를 설정합니다.

분류	value
배너 사이즈	Banner.BANNER_320x50 / Banner.BANNER_300x250
Gravity	Banner.GRAVITY_TOP / Banner.GRAVITY_BOTTON

C#

public class AdPopcornSSPSampleScene : MonoBehaviour{	

	private AdPopcornSSPBanner bannerAd = null;	
	
	void Start(){	
		bannerAd = new AdPopcornSSPBanner(AdPopcornSSPBanner.BANNER_320x50, Banner.GRAVITY_BOTTOM);	
	}
}

2. 배너 광고 Placement ID 설정

아래 코드를 추가하여 배너의 PLACEMENT ID 를 설정합니다. PLACEMENT ID 는 애드팝콘 SSP 페이지에서 생성이 가능합니다.

C#

bannerAd.setPlacementId("배너광고_PLACEMENT_ID");

3. 배너 광고 요청 사이즈 설정

배너 사이즈는 두 가지 옵션이 제공됩니다. 아래 사이즈 중 하나를 선택해 주시길 부탁드립니다.

• Banner.BANNER_320x50

• Banner.BANNER_300x250

Default 값은 "Banner.BANNER_320x50" 입니다.

C#

bannerAd.setAdSize("Banner.BANNER_320x50");

4. 배너 광고 갱신 주기 설정

AdPopcorn 에서 제공하는 배너 광고에 대한 갱신 주기를 설정합니다.

설정 가능 범위는 15~300초 이며 -1 로 설정 시 자동으로 갱신되지 않습니다.

Default 값은 60 입니다.

C#

bannerAd.setRefreshTime(50);

5. 배너 광고 애니메이션

AdPopcorn 에서 제공하는 배너 광고는 7가지 애니메이션을 추가할 수 있습니다.

Default 값은 BANNER_ANIM_NONE 입니다.

parameter	설명
BANNER_ANIM_NONE	배너 애니메이션 없음
BANNER_ANIM_FADE_IN	페이드 인 애니메이션
BANNER_ANIM_SLIDE_LEFT	왼쪽으로 슬라이드 애니메이션
BANNER_ANIM_SLIDE_RIGHT	오른쪽으로 슬라이드 애니메이션
BANNER_ANIM_TOP_SLIDE	윗쪽으로 슬라이드 애니메이션
BANNER_ANIM_BOTTOM_SLIDE	아래쪽으로 슬라이드 애니메이션
BANNER_ANIM_CIRCLE	배너 회전 애니메이션

C#

bannerAd.setBannerAnimType(Banner.BANNER_ANIM_SLIDE_LEFT);

6. 배너 광고 델리게이트 설정

배너 광고 로드의 성공/실패에 대한 델리게이트를 제공합니다. 제공되는 델리게이트와 구현 예시는 다음과 같습니다.

delegate	설명
OnBannerAdReceiveSuccess	배너광고 로딩 성공
OnBannerAdReceiveFailed	배너광고 로딩 실패. 에러코드 값

에러코드 링크

C#

//배너 델리게이트 등록
if(bannerAd != null){
		bannerAd.setBannerEventCallbackListener();	
		bannerAd.OnBannerAdReceiveSuccess += OnBannerAdReceiveSuccess;	
		bannerAd.OnBannerAdReceiveFailed += OnBannerAdReceiveFailed;
}

//배너 델리게이트 구현
public void OnBannerAdReceiveSuccess(object sender, System.EventArgs args){
		Debug.Log("OnBannerAdReceiveSuccess event received.");
}
public void OnBannerAdReceiveFailed(object sender, ErrorResult errorResult){
		Debug.Log("OnBannerAdReceiveFailed event received. > errorCode : " +	
		errorResult.errorCode + ", errorMessage : " + errorResult.errorMessage);
}

//배너 델리게이트 해제
void OnDestroy(){	
	if (bannerAd != null) {	
		bannerAd.OnBannerAdReceiveSuccess -= OnBannerAdReceiveSuccess;	
		bannerAd.OnBannerAdReceiveFailed -= OnBannerAdReceiveFailed;	
		bannerAd.stopBannerAd ();	
	}	
	AdPopcornSSPlugin.destroy ();
}

7. 배너 뷰 광고 요청

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

C#

bannerAd.loadAd();

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

8. 배너 광고 중단

stopAd() API를 호출하여 배너 광고 노출을 더이상 하고 싶지 않은 시점에 호출합니다.

C#

bannerAd.stopAd();

9. 배너 광고 미디에이션 옵션

AdPopcorn 에서 제공하는 Cauly, Mezzo Media 에 대한 배너 광고의 옵션을 설정 할 수 있습니다.

1) Cauly

옵션	설명	비고
AdPopcornSSPBanner.MediationExtraData.CAULY_DYNAMIC_RELOAD_INTERVAL	광고 노출 주기를 카울리측에서 컨트롤 함 (setMediationBooleanExtras API 사용)	기본값 = true
AdPopcornSSPBanner.MediationExtraData.CAULY_RELOAD_INTERVAL	setMediationIntExtras API 사용 CAULY_DYNAMIC_RELOAD_INTERVAL이 false 일 경우에만 사용 가능	기본값 = 20s (설정 범위: 10 ~ 120)
AdPopcornSSPBanner.MediationExtraData.CAULY_THREAD_PRIORITY	스레드 우선순위 설정 (setMediationIntExtras API 사용)	기본값 = 5 (설정 범위: 1 ~ 10)

2) MezzoMedia

옵션	설명	비고
AdPopcornSSPBanner.MediationExtraData.MEZZO_BACKSTRETCH	배너 광고의 백그라운드 영역 설정 방식 (setMediationIntExtras API 사용)	기본 값 = 0 (배경 자동 채우기) , 1 = 투명
AdPopcornSSPBanner.MediationExtraData.MEZZO_LOCATION_TYPE	배너 광고의 위치 컨트롤 (setMediationIntExtras API 사용)	기본 값 = 0 (Center) , 1 = (Left) , 2 = (Right)
AdPopcornSSPBanner.MediationExtraData.MEZZO_MEDIA_TYPE	배너 광고 형태 설정 (setMediationIntExtras API 사용)	기본 값= 0 (HTML) , 1 = (Image)

3) 예시 코드

C#

bannerAd = new AdPopcornSSPBanner(AdPopcornSSPBanner.BANNER_320x50, Banner.GRAVITY_BOTTOM);

bannerAd.setMediationBooleanExtras (AdPopcornSSPBanner.MediationExtraData.CAULY_DYNAMIC_RELOAD_INTERVAL, false);
bannerAd.setMediationIntExtras (AdPopcornSSPBanner.MediationExtraData.CAULY_RELOAD_INTERVAL, 40);
bannerAd.setMediationIntExtras (AdPopcornSSPBanner.MediationExtraData.MEZZO_BACKSTRETCH, 0);
bannerAd.setMediationIntExtras (AdPopcornSSPBanner.MediationExtraData.MEZZO_MEDIA_TYPE, 1);