배너 광고

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

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

Was this helpful?