유니티 배너 광고 연동

배너는 사각 형태의 자동 시작형 광고이며 정적 또는 동적 컨텐츠 모두 지원됩니다. 앱 컨텐츠 주변의 지정된 위치에서 게재됩니다.

⚡ 시작하기 전에 읽어주세요 대상 앱에 아이언소스 유니티 SDK가 올바르게 연동되었는지 먼저 확인해 주세요. 연동에 대한 설명은 여기에 있습니다.

1단계. 배너 광고를 로드하기

배너광고를 기본설정으로 로드하려면 아래와 같이 메서드를 호출해 주세요:

아래 메서드를 호출하여 Banner View를 초기화합니다. (본 예제에서는 배너의 사이즈는 “BANNER” 사이즈 입니다):

IronSource.Agent.loadBanner(IronSourceBannerSize.BANNER, IronSourceBannerPosition.BOTTOM);

아래 테이블에서 지원되는 표준 배너 사이즈 상세 정보를 확인하세요:

IronSourceBannerSize	설명	가로/세로 크기 (WxH) (iOS: points, 안드로이드: dp)
BANNER	표준 배너	320 x 50
LARGE	대형 배너	320 x 90
RECTANGLE	중간 사각형 배너(MREC)	300 x 250
SMART	스마트 배너 (스마트폰 및 태블릿 기기의 크기 및 방향에 맞게 조정된 광고가 자동으로 생성됨)	iOS: iPhone – 320 x 50 iPad – 728 x 90 Android: 화면 폭이 720dp 이하: 320 x 50 화면 폭이 720dp 초과: 728 x 90

S지원되는 표준 배너 위치는 아래 표를 참조하세요:

IronSourceBannerPosition	설명
TOP	배너가 화면 상단 중앙에 위치하게 함
BOTTOM	배너가 화면 하단 중앙에 위치하게 함

또다른 방법으로 아래와 같이 배너를 맞춤 크기로 지정하여 초기화 할 수도 있습니다. (폭/높이, iOS의 경우 points 단위, 안드로이드의 경우 dp 단위):
```
IronSource.Agent.loadBanner(new IronSourceBannerSize(320, 50), IronSourceBannerPosition.BOTTOM);
```

배너가 성공적으로 로드되면 onBannerAdLoadedEvent를 수신하고 배너가 앱 내에서 표시됩니다.

배너광고 표시하기 / 가리기 – 선택사항

광고 경험에서 최대한의 유연성을 제공하기 위해 앱 내의 배너 광고 표시하기 및 가리기 기능이 제공됩니다.

hideBanner와 displayBanner API를 사용하여 앱이 백그라운드에 있을 때 배너가 표시되거나 가려질 수 있도록 조정할 수 있습니다.

배너를 로드하고 표시했다면, 이 배너를 가리고 앱 내에서 나중에 다시 표시될 수 있도록 할 수 있습니다.

배너를 가리려면, 아래의 함수를 호출하세요:

IronSource.Agent.hideBanner();

그리고 같은 배너를 다시 표시하려면, 이 함수를 호출하세요:

IronSource.Agent.displayBanner();

2단계. 배너 이벤트를 구현하기

아이언소스 유니티 플러그인은 광고 준비 상태 및 활동에 대한 정보 전달을 위해 여러 이벤트들을 송출합니다. 아래의 코드들을 추가해서 배너 광고 이벤트들을 프로젝트에 등록하세요.

//Add AdInfo Banner Events
IronSourceBannerEvents.onAdLoadedEvent += BannerOnAdLoadedEvent;
IronSourceBannerEvents.onAdLoadFailedEvent += BannerOnAdLoadFailedEvent;
IronSourceBannerEvents.onAdClickedEvent += BannerOnAdClickedEvent;
IronSourceBannerEvents.onAdScreenPresentedEvent += BannerOnAdScreenPresentedEvent;
IronSourceBannerEvents.onAdScreenDismissedEvent += BannerOnAdScreenDismissedEvent;
IronSourceBannerEvents.onAdLeftApplicationEvent += BannerOnAdLeftApplicationEvent;

The Plugin will notify the Listener of all possible events listed below:

/************* Banner AdInfo Delegates *************/
//Invoked once the banner has loaded
void BannerOnAdLoadedEvent(IronSourceAdInfo adInfo) 
{
}
//Invoked when the banner loading process has failed.
void BannerOnAdLoadFailedEvent(IronSourceError ironSourceError) 
{
}
// Invoked when end user clicks on the banner ad
void BannerOnAdClickedEvent(IronSourceAdInfo adInfo) 
{
}
//Notifies the presentation of a full screen content following user click
void BannerOnAdScreenPresentedEvent(IronSourceAdInfo adInfo) 
{
}
//Notifies the presented screen has been dismissed
void BannerOnAdScreenDismissedEvent(IronSourceAdInfo adInfo) 
{
}
//Invoked when the user leaves the app
void BannerOnAdLeftApplicationEvent(IronSourceAdInfo adInfo) 
{
}

3단계. 로딩 관련 추가 설정

레벨플레이 대시보드에서는 광고 플레이스먼트(게재위치) 및 광고 횟수 / 빈도 제한도 지원됩니다. 여기에서 배너 광고의 광고 플레이스먼트 및 광고 횟수 / 빈도 제한을 설정해 앱 사용자 경험을 최적화 하는 방법에 대해 알아보세요.

배너의 플레이스먼트 설정이 완료되었다면, 아래의 메서드를 호출해 배너를 특정 위치에 표시해 보세요:

IronSource.Agent.loadBanner(IronSourceBannerSize.BANNER, IronSourceBannerPosition.BOTTOM, (string) "YOUR_PLACEMENT_NAME");

Note: SDK는 한 번에 한 개의 배너만 표시할 수 있습니다.

4단계. 배너를 삭제하기

배너를 삭제하려면, 아래의 메서드를 호출해 주세요:

IronSource.Agent.destroyBanner();

삭제된 배너는 더 이상 로드가 불가능합니다. 다시 배너 광고를 게재하려면, 다시 초기화부터 진행 해야 합니다.

5단계. 배너 제공 네트워크 연동하기

다음은, 배너들이 레벨플레이 미디에이션을 통해 제공될 수 있도록 광고 네트워크 아답터들을 연동합니다.

아래 문서에서 지원 가능한 네트워크 및 각 네트워크 별 배너 사이즈 동작들을 각 OS 플랫폼 별로 확인하실 수 있습니다:

iOS 배너 광고 네트워크별 지원 사항

안드로이드 배너 광고 네트워크별 지원 사항

6단계. 적응형 배너

적응형 배너 기능은 광고의 폭과 화면 크기에 따라 최적화된 배너 사이즈 정보를 받을 수 있는 기능입니다.

이 기능을 사용하면 적응형 배너를 지원하는 네트워크들 (현재는 AdMob과 Ad Manager만이 지원됨)은 배너 사이즈에 기반해 최적의 높이를 가진 광고를 제공합니다. 적응형 배너를 지원하지 않는 여타 네트워크들의 경우 앞에서의 경우와 같이 지정된 사이즈로 동일하게 배너를 제공합니다.

배너 사이즈를 객체로 지정하고 해당 객체에서 아래와 같이 “adaptive” 플래그를 추가합니다.
```
IronSourceBannerSize.SetAdaptive(true);
```
로드 성공 콜백인 BannerAdLoadedEvent 에서 로드 또는 갱신될 배너 광고의 사이즈를 수신하여 앱 내 배너 view 를 조정할 수 있습니다.

Note: 적응형 배너는 지정된 폭의 크기에 맞춰 최적화되어 제공됩니다.

완료했습니다!

이제 앱에 배너 광고를 게재할 준비가 완료되었습니다. Integration Helper를 사용해서 연동이 잘 되었는지 점검해 보세요.

다음엔 뭘 할까요?

아래의 연동 가이드를 따라서 또 다른 광고 유닛들을 연동해 보세요:

더 많은 미디에이션 아답터 연동에 관심이 있으시다면, 아이언소스에서 지원하는 미디에이션 네트워크를 확인해 보세요.