배너 광고

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

1. 인스턴스 생성

배너 광고 노출을 위해 SSPInitWithBannerViewSize API를 호출하여 인스턴스를 생성합니다. 각 파라미터의 설명과 사용 예시는 다음과 같습니다.

parameter	설명
size	배너 뷰의 크기
origin	배너 뷰의 위치
appKey	애드팝콘 SSP 콘솔페이지 에서 발급 받은 app key
placementId	애드팝콘 SSP 콘솔페이지 에서 발급 받은 PlacementId

C#

public class IgawSSPSampleScene : MonoBehaviour{	

	private string BANNER_PLACEMENTId = "placementId";	

	void Start()
	{	
		AdPopcornSSPPluginIOS.SSPInitWithBannerViewSize(AdPopcornSSPPluginIOS.SSPBannerViewSize320x50, 0.0f, 568.0f - 50.0f, “YOUR_APP_KEY”, "BANNER_PLACEMENTId");	
	}
}

2. 배너 광고 요청

SSPBannerViewLoadRequestAPI 를 호출하여 광고를 불러 옵니다.

C#

AdPopcornSSPPluginIOS.SSPBannerViewLoadRequest();

3. 배너 크기

애드팝콘 SSP 배너는 현재 iPhone, iPod Touch의 사이즈(W:320, H:50)만 지원하고 있으며, SSPBannerViewSize320x50, SSPBannerViewSize300x250 로 정의되어 있는 상수를 사용하시면 됩니다.

4. 광고 제어

배너 광고를 제어하고자 하는 시점에 SSPBannerViewStopAdAPI를 호출하여 광고를 제어합니다.

C#

// 배너 광고 종료
AdPopcornSSPPluginIOS.SSPBannerViewStopAd();

5. 광고 전환 주기

SSPBannerViewSetAdRefreshRateAPI를 이용하여 수신한 광고의 전환주기를 설정합니다.

default 값은 60초 이며, 최소 30초 ~ 최대 300초로 설정할 수 있습니다.

SSPBannerViewSetAdRefreshRate -1로 설정 시 광고가 로드 된 후 자동으로 refresh 가 되지 않습니다.

단, 미디에이션 네트워크 광고는 해당 기능을 제공하는 업체에 대해서만 설정이 적용됩니다.

C#

AdPopcornSSPPluginIOS.SSPBannerViewSetAdRefreshRate(37);

6. 델리게이트 설정

배너광고에서 발생하는 이벤트에 대한 델리게이트를 제공합니다. 제공되는 델리게이트와 구현 예시는 다음과 같습니다.

delegate	설명
sspBannerViewLoadSuccess	배너광고 로드 성공
sspBannerViewLoadFail	배너광고 로드 실패. 에러코드 값
sspBannerViewClicked	배너광고 클릭

C#

public class MySampleScene : MonoBehaviour {
	void Start () {	
		AdPopcornSSPPluginIOS.AdPopcornSSPSetCallbackHandler("MySampleScene");	

		// 델리게이트 핸들러 등록	
		AdPopcornSSPPluginIOS.SSPBannerViewSetDelegate();

		// 델리게이트 등록	
		AdPopcornSSPPluginIOS.sspBannerViewLoadSuccess += HandleSSPBannerViewLoadSuccess;	
		AdPopcornSSPPluginIOS.sspBannerViewLoadFail+= HandleSSPBannerViewLoadFail;	
		AdPopcornSSPPluginIOS.sspBannerViewClicked+= HandleSSPBannerViewClicked;	
	} 

	// 델리게이트 구현	
	public void HandleSSPBannerViewLoadSuccess()	
	{	
	}	
	public void HandleSSPBannerViewLoadFail(string error)	
	{	
	}	
	public void HandleSSPBannerViewClicked()	
	{	
	}
}