배너 광고

배너는 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);

Last updated