안드로이드의 배너 광고 연동

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

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

1단계. 배너의 레이아웃 생성 

먼저, 배너 view를 생성하고 배너 구성을 설정합니다.

  • 아래의 메소드를 호출하여 배너 view를 초기화합니다 (이 예제에서는 BANNER 사이즈의 배너를 사용합니다):
    IronSourceBannerLayout banner = IronSource.createBanner(Activity, ISBannerSize.BANNER);
    

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

    ISBannerSize 설명 dp 단위 크기 (WxH)
    BANNER 표준 배너 320 x 50
    LARGE 대형 배너 320 x 90
    RECTANGLE 중간 사각형 배너(MREC) 300 x 250
    SMART 스마트 배너
    (휴대폰 및 태블릿 기기 화면 크기에 맞게 조정)
    화면 높이 720dp 이하: 320 x 50,
    화면 높이 720dp 초과: 728 x 90
  • 또다른 방법으로 아래와 같이 배너를 사용자 정의 크기로 초기화 할 수도 있습니다. (폭/높이, dp 단위):
    IronSourceBannerLayout banner = IronSource.createBanner(Activity, new ISBannerSize(320, 50));

2단계. 리스너 구현

다음은, 앱 코드에 배너 리스너를 구현합니다. 아이언소스 SDK는 배너동작에 대한 정보 전달을 위해 여러가지 콜백을 송출합니다. 아이언소스 SDK는 아래의 목록에 나열된 이벤트들의 정보를 리스너로 전달합니다:

banner.setLevelPlayBannerListener(new LevelPlayBannerListener() {
   // Invoked each time a banner was loaded. Either on refresh, or manual load.
   //  AdInfo parameter includes information about the loaded ad   
   @Override
   public void onAdLoaded(AdInfo adInfo) {}
   // Invoked when the banner loading process has failed.
   //  This callback will be sent both for manual load and refreshed banner failures. 
   @Override
   public void onAdLoadFailed(IronSourceError error) {}
   // Invoked when end user clicks on the banner ad
   @Override
   public void onAdClicked(AdInfo adInfo) {}
   // Notifies the presentation of a full screen content following user click
   @Override
   public void onAdScreenPresented(AdInfo adInfo) {}
   // Notifies the presented screen has been dismissed
   @Override
   public void onAdScreenDismissed(AdInfo adInfo) {}
   //Invoked when the user left the app
   @Override
   public void onAdLeftApplication(AdInfo adInfo) {}
   
});

전체 리스너 구현에 대한 설명은 여기를 확인해 주세요.

Note:
  • 콜백은 메인스레드 이외의 스레드에서 실행될 수도 있습니다. 아이언소스 콜백 결과에 영향받는 UI 상호작용이나 업데이트들은 모두 메인스레드로 넘겨진 후 실행되어야 합니다.
  • 리스너는 SDK 초기화 이전에 설정해 주세요. 초기화 이전에 설정해야 SDK의 모든 이벤트 관련 정보를 수신할 수 있습니다.

Step 3. Load Banner Ad Settings

  • 배너광고를 기본설정으로 로드하려면 아래와 같이 메서드를 호출해 주세요:
    IronSource.loadBanner(banner);
  • 유니티 레벨플레이는 배너의 플레이스먼트(게재 위치) 및 횟수/빈도 제한 설정 기능을 레벨플레이 대시보드에서 지원합니다. 플레이스먼트 및 횟수/빈도 제한 설정하여 사용자 경험을 최적화 할 수 있는 방법을 여기에서 찾아보세요. 배너 플레이스먼트 설정이 완료되었다면, 아래의 메서드를 호출해서 특정 플레이스먼트 위치에 배너 광고를 내보내 보세요:
    We support placements, pacing and capping for Banners on the LevelPlay dashboard. Learn how to set up placements, capping and pacing for Banners to optimize your app’s user experience here.If you’ve set up placements for your Banner, call the following method to serve a Banner ad in a specific location:

IronSource.loadBanner(banner, (String)placement);
Note: 아이언소스 SDK는 배너를 한 번에 한 개 까지만 송출 가능합니다.

4단계. 배너광고 삭제

배너 View 객체를 삭제하려면 아래의 메서드를 호출합니다:

IronSource.destroyBanner(banner);

삭제된 배너 view 객체는 더 이상 로드할 수 없습니다. 만약 다시 배너 광고를 게재하려면 다시 배너 view 객체를 생성 및 초기화 해야 합니다.

Note: 배너 광고 로드 실패했을 때에는, 배너 View 객체를 삭제하지 않고 해당 View를 다시 사용해 로드해 주세요. 빈번한 배너 View 생성/삭제는 성능 문제를 야기할 수 있습니다.

5단계. 배너 광고 제공 네트워크 연동

다음은 아이언소스 레벨플레이 미디에이션을 통해 배너를 게재할 수 있도록 광고 네트워크를 연동합니다.
지원되는 네트워크 및 각 네트워크의 배너 사이즈 별 동작은 아래와 같습니다: 

BANNER LARGE RECTANGLE SMART
ironSource Banner Large Banner Medium Rectangle Banner / Leaderboard
AdMob Banner Large Banner* Medium Rectangle Banner / Leaderboard
AppLovin Banner Banner Medium Rectangle Banner / Leaderboard
Chartboost Banner Banner Medium Rectangle Leaderboard
Meta Audience
Network
Banner Large Banner Medium Rectangle Banner / Leaderboard
Digital Turbine Banner Banner Medium Rectangle Banner / Leaderboard
HyprMX Banner Medium Rectangle Banner / Leaderboard
InMobi Banner Banner Medium Rectangle Banner / Leaderboard
Smaato Banner Medium Rectangle Banner / –
UnityAds Banner Banner Medium Rectangle Banner / Leaderboard
Vungle Banner Banner Medium Rectangle Banner / Leaderboard

배너 사이즈 참조

  • Banner:  320 X 50
  • Large Banner:  320×90  
  • Medium Rectangle (MREC): 300×250 
  • LeaderBoard: 728X90

* AdMob은 Large를 320X100으로 정의합니다.

6단계. 적응형 배너

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

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

  1. 배너 사이즈를 객체로 지정하고 해당 객체에서 아래와 같이 “adaptive” 플래그를 추가합니다.
    ISBannerSize.setAdaptive(true);

  2. 로드 성공 콜백인 onAdLoaded()에서 로드 또는 갱신될 배너 광고의 사이즈를 수신하여 앱 내 배너 view 를 조정할 수 있습니다.

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


다음에는 뭘 할까요? 

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

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